Import Data (集約ストレージ)

非集約ストレージ・バージョンはここをクリックしてください

ルール・ファイルの有無にかかわらず、テキストまたはスプレッドシート・データ・ファイルからデータをインポートします。

最低限必要な権限: 書込み。

構文

「図imp_data_as.gifの説明」

次の方法でimport dataを使用して、データを集約ストレージ・データベースにロードします:

キーワード

import database <dbs-name> data from...

データのインポート元がローカル・ファイルかサーバー・ファイルか、およびデータのインポート元のファイルのタイプを指定します。

...using ... rules_file

指定されたルール・ファイルを使用してデータベースにデータをインポートします。

...<data error spec> (on error...)

必須。データ・ロード中にエラーが発生した場合の処理をEssbaseに指示: 操作を中止するか、指定したエラー・ログに書込みまたは追加してください。

...<data record spec> from data_string

選択したデータベースに単一のデータ・レコードをロードします。 data_stringに続く文字列は、改行文字を含まない連続した行である必要があります。

...<SQL connect spec> (connect as...)

SQLソースからデータをインポートする場合は、SQLユーザー名とパスワードを指定します。 SQLデータ・ソースをロードする場合は、常にルール・ファイルを使用する必要があります。

SQLデータを集約ストレージ・データベースにロードする場合、最大8つのルール・ファイルを使用して、<buffer-block-spec>で指定された文法で「複数のrules_file」文法を使用してデータをパラレルにロードできます。 Essbaseは、複数の一時集約ストレージ・データ・ロード・バッファ(ルール・ファイルごとに1つずつ)を初期化し、データがバッファに完全にロードされると、すべてのバッファの内容を1回の操作でデータベースにコミットします。

各ルール・ファイルでは、同じ認証情報(SQLユーザー名およびパスワード)を使用する必要があります。

次の例では、SQLデータが2つのルール・ファイル(rule1.rulおよびrule2.rul)からロードされます:

import database ASOsamp.Sample data 
   connect as TBC identified by 'password' 
   using multiple rules_file 'rule1','rule2' 
   to load_buffer_block starting with buffer_id 100 
   on error write to "error.txt";

ルール・ファイルのリストを指定する場合は、ルール・ファイル名のカンマ区切り文字列を使用します(.rul拡張子を除く)。ルール・ファイルのファイル名は8バイト以下にする必要があり、ルール・ファイルは「Essbaseサーバー」に存在する必要があります。

各ルール・ファイルのデータ・ロード・バッファを初期化する際、Essbaseでは、リスト内の最初のルール・ファイルに指定した開始データ・ロード・バッファIDが使用され(たとえば、rule1の場合はID 100)、後続のデータ・ロード・バッファごとにID番号が1ずつ増分されます(たとえば、rule2の場合はID 101)。

使用するODBCドライバは、パラレルSQL接続用に構成する必要があります。

ノート:

集約ストレージ・データベースに対して複数のSQLデータ・ロードをパラレルに実行することは、to load_buffer with buffer_id文法を使用してデータをバッファにロードしてから、from load_buffer with buffer_id文法を使用してバッファの内容をデータベースに明示的にコミットすることとは異なります。

...to load_buffer with buffer_id

複数のデータ・ファイルから集約ストレージ・データベースにデータをインポートする場合、データ・インポート操作をより効率的にするために、まずバッファにインポートできます。

...from load_bufferとbuffer_id

複数のデータ・ファイルから集約ストレージ・データベースにデータをインポートする場合、データ・インポート操作をより効率的にするために、データ・ロード・バッファからインポートできます。

...from load_buffer with buffer_id...values

指定したデータ・ロード・バッファの内容をデータベースにコミットするときに、既存の値に追加するか、既存の値から部分処理するか、または既存の値をオーバーライドするかを指定します。

...from load_buffer with buffer_id...create slice

新しいデータ・スライスを作成して、指定されたデータ・ロード・バッファの内容をデータベースにコミットします。

...from load_buffer with buffer_id override all data

データベースの現在の内容を削除し、データベースを指定されたデータ・ロード・バッファの内容に置き換えます。

...from load_buffer with buffer_id override incremental data

データベース内のすべての増分データ・スライスの現在の内容を削除し、指定したデータ・ロード・バッファの内容で新しいデータ・スライスを作成します。新しいデータは、データ・ロード・プロパティ「値の追加」(aggregate_sum)を使用して作成されます。新しいデータとプライマリ・スライスの間に重複するセルがある場合、それらの値は問合せ時にまとめて追加されます。

ノート

この文では、データベースが起動している必要があります。
import文を使用する場合は、エラー発生時の動作を指定する必要があります。
SQLデータ・ソースからインポートするには、リレーショナル・ユーザー名として接続し、ルール・ファイルを使用する必要があります。

例

import database ASOsamp.Sample data from server data_file '/ASOsamp/Sample/expsamp.txt' on error abort;

ASOsamp.Sampleデータベースにデータをロードします。

import database ASOsamp.Sample data from load_buffer with buffer_id 1;

指定されたデータ・ロード・バッファの内容をASOsamp.Sampleデータベースにコミットします。

import database ASOsamp.Sample data from load_buffer with buffer_id 1, 2;

複数のデータ・ロード・バッファ(buffer_id 1およびbuffer_id 2)の内容をASOsamp.Sampleデータベースにコミットします。

import database ASOsamp.Sample data from load_buffer with buffer_id 1 add values;

値を追加して、指定したデータ・ロード・バッファの内容をASOsamp.Sampleデータベースにコミットします。

import database ASOsamp.Sample data from load_buffer with buffer_id 1 override values create slice;

指定されたデータ・ロード・バッファの内容をASOsamp.Sampleデータベースの新しいデータ・スライスにコミットします。

import database ASOsamp.Sample data from load_buffer with buffer_id 1 override all data;

ASOsamp.Sampleデータベースの内容を、指定したデータ・ロード・バッファの内容に置き換えます。

import database ASOsamp.Sample data from load_buffer with buffer_id 1 override incremental data;

指定されたデータ・ロード・バッファの内容で新しいデータ・スライスを作成して、ASOsamp.Sampleデータベース内のすべての増分データ・スライスの内容を置き換えます。新しいデータは、データ・ロード・プロパティ「値の追加」(aggregate_sum)を使用して作成されます。新しいデータとプライマリ・スライスの間に重複するセルがある場合、それらの値は問合せ時にまとめて追加されます。

「バッファを使用したデータのロード」を参照してください。