EXPORT

EXPORTコマンドは、ワークスペース・オブジェクトをアナリティック・ワークスペースから外部ファイルにコピーするコマンドです。EXPORTを使用すると、データとオブジェクト定義の両方をワークスペースからEIFファイルにコピーしたり、OLAP DMLワークシート・オブジェクトをスプレッドシート・ファイルにコピーしたりできます。

EXPORTコマンドの構文は、EIFファイルまたはスプレッドシート・ファイルを生成するために使用されるかどうかによって異なるので、次のように2つに分けて説明します。

EXPORT(EIF)
EXPORT(スプレッドシート)

EXPORT(EIF)

EXPORT(EIFへ)コマンドは、データおよび定義をOracle OLAPアナリティック・ワークスペースからEIFファイルにコピーします。EXPORTは、コマンドに指定しなくても、エクスポートされるデータのすべてのディメンションもコピーします。Oracle OLAPにおけるデータのディメンションのステータスが、エクスポートされる値を決定します。

ヒント:

EIFファイルのインポートおよびエクスポートの方法を決定するオプションは複数あります。これらのオプションは、「EIFオプション」に記載されています。

EXPORT(EIFへ)は一般的にIMPORT(EIF)とともに使用して、Oracle OLAPワークスペースを別のOracle OLAPワークスペースにコピーします。オブジェクトをソース・ワークスペースからEIFファイルにエクスポートし、次にそのオブジェクトをEIFファイルからターゲット・ワークスペースにインポートします。ソースおよびターゲットのワークスペースが存在する場所は、同じプラットフォームでも異なるプラットフォームでも構いません。

構文

EXPORT export_item TO EIF FILE file-name [LIST] [NOPROP] -

[NOREWRITE|REWRITE] [FILESIZE n [K, M, or G]] -

[NOTEMPDATA] [NLS_CHARSET charset-exp] [AGGREGATE | NOAGGR] -

[API | NOAPI]

ここで、export_itemは次のいずれかです。

ALL

name [AS newname]

exp [SCATTER AS scattername [TYPE scattertype] [EXCLUDING (concatbasedim . . .)]

exp AS name [EXCLUDING (concatbasedim . . .)]

パラメータ

ALL

現在NAMEのステータスにあるオブジェクトをすべてOracle OLAPがエクスポートすることを指定します(したがって、ワークスペースのすべてのオブジェクトとは限りません)。

注意:

キューブのメタデータをエクスポートする場合(つまり、デフォルトのAPIキーワードが有効になっている場合)、ワークスペースのすべてのオブジェクトをエクスポートする必要があります(つまり、export_itemでALLキーワードを指定する必要があります)。ワークスペースの一部のオブジェクトのみをエクスポートする場合は、キューブのメタデータをエクスポートすることはできません。

name

エクスポートされるアナリティック・ワークスペース・オブジェクトまたはオプションの名前。複数の名前を指定してエクスポートできます。

AS newname

アナリティック・ワークスペース・オブジェクトまたはオプションの新しい名前を指定します。式、ローカル変数またはローカル値セットを指定する場合、IMPORT(EIF)がデータの受取りに使用するオブジェクトの名前を指定するためにAS nameを使用する必要があります。

重要:

ディメンションの名前は変更できません。

exp

計算またはエクスポートされる式。複数の名前を指定してエクスポートできます。

SCATTER AS scattername [TYPE scattertype]

複数のパスによってメモリーに書き込む必要があるような大規模な多次元オブジェクトをエクスポートする場合、SCATTER AS scatternameを使用してファイルI/Oのパフォーマンスを向上できます。最初に1つまたは2つの新しい1次元のテキスト変数(scatternameおよびscattertype)を定義し、テキスト値とそれに対応するデータ型をscatternameに割り当てる必要があります。SCATTER AS scatternameを使用すると、scatternameで指定したslicesの別々の変数として多次元式がOracle OLAPによってエクスポートされます。各スライス変数が同じデータ型である場合は、expをそのデータ型にするのみなので、TYPE scattertypeを使用する必要がありません。

EXCLUDING (concatbasedim . . .)

EXCLUDING句は、name引数で指定する連結ディメンションにのみ適用されます。concatbasedimに指定する値は、Oracle OLAPがエクスポートしない連結のベース・ディメンションを指定します。

ALL

TO EIF FILE

EIFファイルを作成することを示します。

file-name

出力が書き込まれるファイルの名前を表すテキスト式。そのファイルがカレント・ディレクトリにない場合、ファイルの名前にディレクトリ・オブジェクトの名前を含める必要があります。

注意:

ディレクトリ・オブジェクトはデータベースで定義され、ディレクトリおよびディレクトリ内のファイルへのアクセスを制御します。CDAコマンドを使用すると、カレント・ディレクトリ・オブジェクトの特定や指定を行うことができます。使用するデータベース・ユーザー名で読取りおよび書込み可能なファイルがあるディレクトリ・オブジェクトへのアクセス権については、Oracle DBAに問い合せてください。

LIST

エクスポートが開始されると、各オブジェクトの定義を現行の出力ファイルに送信します。ディメンションの場合、EXPORTはエクスポートされている値の数を示し、コンポジットの場合、ディメンション値の組合せの数を示します。さらに、2分ごとおよびエクスポート処理後の合計読取りバイト数を示すメッセージも生成されます。

NOPROP

PROPERTYを使用して各オブジェクトに割り当てたプロパティを、EIFファイルに書き込まないようにします。

NOREWRITE

REWRITE

ターゲット・ファイルがすでに存在する場合にEXPORTがそれを上書きするかどうかを指定します。NOREWRITE(デフォルト)は、既存のターゲット・ファイルをそのままにして現行の出力ファイルにエラー・メッセージを送信します。REWRITEは、EXPORTが既存のファイルを新しいEIFファイルに置き換えます。

FILESIZE n [K|M|G]

EIFファイルの各コンポーネント・ファイル(メイン・ファイルおよび拡張ファイル)の最大サイズを設定します。エクスポート処理にともなってファイルのサイズがFILESIZEの値を超えると、あるいは、現行のディスクまたは場所に空き領域がなくなると、Oracle OLAPはEIF拡張ファイルを作成します。「EIF拡張ファイル」を参照してください。

FILESIZEは、その設定後に作成されるコンポーネント・ファイルに影響します。その設定より前のコンポーネント・ファイルのサイズは、ファイルが作成されたときのFILESIZEの設定またはディスクがいっぱいになったときのファイルのサイズによって決まるので様々です。

K、M、Gのいずれも指定しない場合、nに対して指定する値はバイトとして解釈されます。値nの後にK、M、Gのいずれかを指定すると、この値はそれぞれKB、MB、GBとして解釈されます。

FILESIZEに設定可能な値は81,920バイト(80KB)から2,147,479,552バイト(2GB)です。

NOTEMPDATA

TEMP変数のデータをEIFファイルに書き込まないようにします。

NLS_CHARSET charset-exp

file-nameによって指定されるファイルにテキスト・データをエクスポートする際にOracle OLAPが使用するキャラクタ・セットを指定しますが、これによって、Oracle OLAPはデータをそのキャラクタ・セットに正確に変換できます。この引数は最後に指定する必要があります。この引数を省略すると、Oracle OLAPはNLS_LANGオプションに記録されているデータベース・キャラクタ・セットでデータをエクスポートします。

AGGREGATE

集計したデータをエクスポートします。(デフォルトの動作)

NOAGGR

集計したデータをエクスポートしません。

API

(デフォルト)指定した項目に対して定義されているキューブのメタデータをエクスポートします。

NOAPI

指定した項目に対して定義されているキューブのメタデータをエクスポートしません。

使用上の注意

異なるプラットフォーム間でのインポートとエクスポート

コンピュータ間でEIFファイルを転送する場合、バイナリ転送を使用してプラットフォーム間のファイル形式の非互換性の問題を回避します。EIFファイルは、EIFVERSIONをターゲット・ワークスペースのリリース番号以下のリリースに設定して作成する必要があります。ターゲット・リリース番号の確認に関する詳細は、EIFVERSIONオプションを参照してください。

リレーションのエクスポート

リレーションをエクスポートする場合、EXPORTは関連ディメンションに関する定義およびステータスにある値、ならびにそのリレーションのディメンションをエクスポートします。

結合ディメンションのエクスポート

結合ディメンションをエクスポートする場合、ベース・ディメンションのステータスと結合ディメンションのステータスが一致することを確認してください。結合ディメンションとベース・ディメンションには暗黙的なリレーションがあるので、Oracle OLAPは結合ディメンションとともにベース・ディメンションをエクスポートしますが、関連ベース値もステータスにない場合、現行のステータスの結合ディメンション値をすべてエクスポートできません。

ディメンション・サロゲートのエクスポート

ディメンション・サロゲートをエクスポートする場合、Oracle OLAPはそのサロゲートのディメンションもエクスポートします。詳細は、「ディメンション・サロゲートのインポートとエクスポート」を参照してください。

ワークスペース・サイズの削減

多数のオブジェクトまたはディメンション値を追加した後に削除した場合、EXPORT(EIFから)コマンドをIMPORT(EIF)とともに使用して、アナリティック・ワークスペースから余分な領域を削除できます。多くの場合、これによってワークスペースが十分に小さくなります。これを行うには、ALLキーワードとともにEXPORTコマンドを使用してすべてのデータをEIFファイルに入れ、そのEIFファイルを異なる名前で作成した新しいワークスペースにインポートします。次に、古いワークスペースを削除し、そのワークスペースで使用していたのと同じワークスペース別名が新しいワークスペースを指すようにします。

結合ディメンションの型の維持

HASH、BTREEまたはNOHASH結合ディメンションをEIFファイルにエクスポートする場合、EIFファイルにはその定義とともに結合型がエクスポートされます。その結合ディメンションをアナリティック・ワークスペースにインポートすると、新しいディメンションまたはその結合型をすでに使用しているディメンションにインポートしたときに、Oracle OLAPはその結合型を維持します。同じ結合型を使用しない既存のディメンションにそのディメンションをインポートしたときには、Oracle OLAPはEIFファイルに保存された元の結合型を維持しません。

名前のないコンポジットのエクスポート

定義に名前のないコンポジットがあるオブジェクトをエクスポートまたはインポートすると、そのコンポジットはオブジェクトとともに自動的にエクスポートまたはインポートされます。名前のないコンポジットの単独でのインポートやエクスポートはできません。

EIF拡張ファイル

EIF拡張ファイル名の構造はfilename.ennnで、ここで、nnnは001から始まる3桁の数字です。たとえば、export.eifというEIFファイルがある場合、拡張ファイルの名前は、export.e001やexport.e002などになります。EIFSHORTNAMESオプションを使用すると、拡張子を3文字に設定できます。EIFEXTENSIONPATHオプションを使用して異なるディレクトリ・オブジェクトを指定しないかぎり、拡張ファイルは元のEIFファイルと同じディレクトリ・オブジェクトに作成されます。

SEGWIDTH設定情報の維持

CHGDFNコマンドのSEGWIDTHキーワードを使用して変数セグメントの長さを指定した場合、セグメント情報は自動的にはエクスポートおよびインポートされません。SEGWIDTH設定を維持するには、ワークスペース全体をエクスポートして新しく作成したワークスペースにワークスペース・オブジェクトのみをインポートし、セグメント設定を指定してから変数データを新しいワークスペースにインポートします。

2つの異なるワークスペースから同じ名前のオブジェクトをエクスポートする方法

2つの異なるワークスペースから同じ名前の2つのオブジェクトをエクスポートする場合、ASキーワードを使用してエクスポートすることにより、EIFファイルでそのオブジェクトの一方の名前を変更する必要があります。EIFファイルのオブジェクトには重複した名前は付けられません。

PERMIT_READプログラムまたはPERMIT_WRITEプログラムのエクスポート

PERMIT_READプログラムまたはPERMIT_WRITEプログラムの内容は、エクスポート時に空になります。これらのプログラムの内容を正常にアナリティック・ワークスペースにコピーしたりアナリティック・ワークスペースからコピーしたりするには、EXPORT(EIFへ)を使用する前にプログラムの名前を変更してから、IMPORT(EIFから)を使用してプログラムをアナリティック・ワークスペースにコピーし、その後で再度PERMIT_READまたはPERMIT_WRITEという名前を付けます。

TEXT値とNTEXT値のエクスポート

TEXT値およびNTEXT値はエクスポートやインポートが可能です。どちらのデータ型も単一のEIFファイルにエクスポートされます。

エクスポートされるTEXT値は、EXPORTコマンドでファイルに指定されるキャラクタ・セットを使用してEIFファイルに格納されます。
エクスポートされるNTEXT値は、NTEXT(UTF8 Unicode)としてEIFファイルに格納されます。
TEXTオブジェクトにインポートされるNTEXT値は、データベース・キャラクタ・セットに変換されます。その結果、NTEXT値がデータベース・キャラクタ・セットで表せない場合にデータが失われることがあります。
NTEXTオブジェクトにインポートされるTEXT値は、NTEXT(UTF8 Unicode)キャラクタ・セットに変換されます。

例

例9-116 変数のエクスポート

ステータスにある値とともにactualおよびbudgetという名前の2つの変数のディメンションを、現行Oracle OLAPワークスペースからカレント・ディレクトリ・オブジェクトのfinance.eifという名前のディスク・ファイルにエクスポートするとします。次の文を使用します。

EXPORT actual budget TO EIF FILE 'finance.eif'

例9-117 ラージ・オブジェクトのエクスポート

複数のパスによってメモリーに書き込む必要があるような多次元のラージ・オブジェクトをエクスポートするとします。ファイルI/Oのパフォーマンスを向上させるために、1次元の変数を作成し、多次元変数を細かくスライスする方法をOracle OLAPに認識させます。また、このラージ・オブジェクトはsales変数であり、month、productおよびdistrictによってディメンション化されているとします。salesをスライスする方法を指定するために、次の文に示すように1次元の変数を作成します。

DEFINE salescatter VARIABLE TEXT <district>

salescatterはdistrictによってディメンション化されるので、この文によってsalesを複数のdistrictスライスに分割するようにOracle OLAPに認識させます。districtには6つの値があるので、salesは6つのスライスに分割されます。各スライスは名前を付ける必要があります。そのために、salescatterの各districtに値を割り当てます。次に、必要に応じてQDR(修飾データ参照)などを使用して、各スライスに適切なデータ型を割り当てます。

SALESをエクスポートするために、次の文を実行します。

EXPORT sales SCATTER AS salescatter TYPE TYPEVAR TO EIF FILE 'slice.eif'

変数をインポートするために、次の文のように必要な名前の付いたスライスを指定します。

IMPORT dist1 dist2 dist3 dist4 dist5 dist6 FROM EIF FILE 'slice.eif'

あるいは、次のようにすべての変数をインポートできます。

IMPORT ALL FROM EIF FILE 'slice.eif'

EXPORT(スプレッドシート)

EXPORT(スプレッドシートへ)コマンドは、作成したOracle OLAP Worksheetオブジェクトをスプレッドシート・ファイルにコピーし、それを適切な形式に自動的に変換します。アナリティック・ワークシートのディメンションが、スプレッドシート・ファイルの列および行を形成します。そのディメンションの現行のステータスによって、ワークシートのエクスポートされる部分が決定されます。

アナリティック・ワークシートをEIFファイルにエクスポートすることもできます(EXPORT(EIF)を参照)。EXPORT(スプレッドシートへ)は、一般に、Lotus 1-2-3、Symphonyなどの他のソフトウェアで読取り可能なファイルにOracle OLAPワークスペースの一部をコピーするために使用します。

構文

EXPORT worksheetname TO {WKS|WK1|WRK|WR1|DIF} FILE file-name -

[STATRANK] [NOREWRITE|REWRITE] [NLS_CHARSET charset-exp]

パラメータ

worksheetname

作成済のOracle OLAP Worksheetオブジェクト。1つのEXPORT(スプレッドシートへ)コマンドは、1つのみのworksheetnameを1つのスプレッドシート・ファイルにエクスポートします。

WKS

Oracle OLAP WorksheetをLotus 1-2-3のファイル(バージョン1)にエクスポートすることを示します。

WK1

Oracle OLAP WorksheetをLotus 1-2-3のファイル(バージョン2)にエクスポートすることを示します。

WRK

Oracle OLAP WorksheetをSymphonyのファイル(バージョン1.0)にエクスポートすることを示します。

WR1

Oracle OLAP WorksheetをSymphonyのファイル(バージョン1.1)にエクスポートすることを示します。

DIF

Oracle OLAP Worksheetをデータ交換フォーマット・ファイルにエクスポートすることを示します。

FILE file-name

FILEでは、作成するファイルを指定します。file-nameには、作成するファイルの名前を表すテキスト式を指定します。そのファイルがカレント・ディレクトリにない場合、ファイルの名前にディレクトリ・オブジェクトの名前を含める必要があります。

注意:

STATRANK

ワークシート・データとともにエクスポートされる行番号および列番号がWKSROWおよびWKSCOLディメンションの現行のステータスのランキングになることを指定します。

NOREWRITE

(デフォルト)ターゲット・ファイルがすでに存在する場合は、そのファイルを上書きせず、エラーを表示することを指定します。

REWRITE

ターゲット・ファイルがすでに存在する場合は、そのファイルを上書きすることを指定します。

NLS_CHARSET charset-exp

file-nameによって指定されるワークシート・ファイルにテキスト・データをエクスポートする際にOracle OLAPが使用するキャラクタ・セットを指定しますが、これによって、Oracle OLAPはデータをそのキャラクタ・セットに正確に変換できます。

指定可能なキャラクタ・セットについては、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください。

この引数は最後に指定する必要があります。この引数を省略すると、Oracle OLAPはNLS_LANGオプションに記録されているデータベース・キャラクタ・セットでデータをエクスポートします。

例

例9-118 エクスポート前の制限

この例では、EXPORTコマンドの前でディメンションWKSCOLおよびWKSROWを制限して価格ワークシートの一部をエクスポートします。

LIMIT WKSCOL TO 2 TO 4
LIMIT WKSROW TO 3 TO 4
EXPORT pricing TO WRK FILE 'price1.wrk'