import スクリプト¶
import
スクリプトは、1 つの Virtual DataPort サーバーに、または同時に複数の Virtual DataPort サーバーに、VQL ファイルまたはリポジトリの内容をインポートします。
以下のセクションでは、次の操作の方法について説明します。
VQL ファイルから、または VQL ファイルとプロパティファイルから、あるいは、これらのファイルのいずれかを含む zip ファイルから、メタデータをインポートする。下記の「 1 つのファイルからのメタデータのインポート 」を参照してください。
リポジトリからメタデータをインポートする。下記の「 リポジトリからのメタデータのインポート 」を参照してください。
このスクリプトは、 <DENODO_HOME>/bin
ディレクトリにあります。
このスクリプトは、以下のいずれかの終了コードを返します。
0: エラーなし。ファイルのすべての VQL ステートメントは正常に実行されました。
126: 1 つまたは複数の VQL ステートメントの実行が失敗しました。
1: 他のエラー。たとえば、スクリプトで Virtual DataPort サーバーとのコネクションを開くことができませんでした。
1 つのファイルからのメタデータのインポート¶
1 つの VQL ファイルのメタデータを 1 つまたは複数のサーバーにインポートするには、次の構文を使用します。
import --file <input filename>
[ --properties-file <properties file name>]
{ [ --server <server URI>
| --servers-file <servers file>
}
[ --singleuser ] [ --metadata-password <password>]
<server URI> =
host:port/database?user@password[&queryTimeout=value][&chunkTimeout=value][&chunkSize=value]
パラメータ名 |
説明 |
---|---|
-h --server <server URI> |
サーバーの URI。 サーバーのパスワードを暗号化して指定できます。これを行うには、 例: このスクリプトを使用して長時間かかる可能性があるクエリを実行する場合、パラメータ
このスクリプトを Windows で実行する場合は、以下のようにします。
"//localhost:9999/admin?login@pas""s"
このスクリプトを Linux で実行する場合は、以下のようにします。
'//localhost:9999/admin?login@pas'"'"'s'
パラメータ |
-s --servers-file <servers file> |
パラメータ
|
-f --file <input file> |
インポートするメタデータを含むファイルのパス。このファイルは、メタデータを含むプレーンテキストファイル (VQL ステートメント) または VQL ファイルとプロパティファイルを含む zip ファイルです。 1 つのファイルからではなく、リポジトリからメタデータをインポートする場合、このパラメータは意味が異なります。 |
-pf --properties-file <properties file> |
サーバーが実行されている環境に依存するパラメータの値を含むプロパティファイルのパス。 このオプションは、export スクリプトの |
-su --singleuser |
指定されている場合、import スクリプトは、 これにより、Virtual DataPort は、このファイルをインポートする間、シングルユーザーモードに切り替わります。 注: シングルユーザーモードで Virtual DataPort サーバーにメタデータをインポートすることが強く推奨されます。 |
-mp --metadata-password <password> |
指定したパスワードで機密値 (データソースのパスワードなど) を復号します。 インポートする VQL ファイルが以下のどちらかの方法で生成されている場合、このパラメータは必須です。
このパラメータを指定しない場合、機密パラメータ ( プレーンテキストでパスワードを入力するのを避けるため、暗号化したパスワードを指定することができます。これを行うには、 例: |
例
例 1:
import --singleuser --file export.vql
--server "localhost:9999/admin?admin@admin1"
--server "host2:9099/admin?admin@admin2"
この例では、 export.vql
ファイルのメタデータが 2 つのサーバーにインポートされます。
例 2:
import --singleuser -f export.vql -s servers.conf
この例では、 export.vql
ファイルのメタデータがインポートされます。ターゲットサーバーの URI は servers.conf
ファイルから読み取られます。
リポジトリからのメタデータのインポート¶
リポジトリのメタデータを 1 つまたは複数のサーバーにインポートするには、次の構文を使用します。
このスクリプトは、リポジトリのメタデータをサーバーにインポートする 代わりに 、リポジトリの VQL ステートメントがすべて含まれる単一のファイルを作成することもできます。これを行うには、 --file
オプションを使用します。
注釈
サーバーのメタデータを VCS に保存してそこからインポートする場合、Virtual DataPort の VCS 統合を使用することが推奨されます (「 バージョン管理システムの統合 」を参照)。
import --repository <path to repository>
[ { --element <path to element>
| --repository-element <identifier path> } ]*
[ --property <property name> = { yes | no } ]*
{ --server <server URI> [--server <server URI>]*
| --servers-file <servers file>
}
[ --file <output file> ] [ --singleuser ]
パラメータ名 |
説明 |
---|---|
-h --server <host>: <port>/<database> ?<user>@<password> |
サーバーの URI。 暗号化されたパスワードを使用する場合、 その場合、このパラメータの値に接頭辞 例: //localhost:9999/admin?admin@encrypted:Gr16MjvuXhRzPtPH/yTXHw== |
-s --servers-file |
パラメータ 各 URI は、パラメータ |
-r --repository |
リポジトリのディレクトリのパス。 |
-e --element |
インポートするエレメントのリポジトリ内でのパス。このオプションは、リポジトリの一部のエレメントのみをインポートする場合に使用します。 例: エレメントとその依存関係をインポートする場合、 例: |
-re --repository-element |
リポジトリに保存されているエレメントの ID パス。 構文: 例: 使用可能なタイプは、 サブタイプの値として、 |
-su --singleuser |
指定されている場合、import スクリプトは、 これにより、Virtual DataPort は、このファイルをインポートする間、シングルユーザーモードに切り替わります。 注: シングルユーザーモードで Virtual DataPort サーバーにメタデータをインポートすることが強く推奨されます。 |
-d --dependencies |
このパラメータを追加することで、レポジトリからインポートする際に、単一のエレメントとその依存関係 (jar、スキャナー、カスタムコンポーネントを除く) をインポートできます。 このパラメータは非推奨です。 |
-P --property |
インポートプロセスを制御する一連の設定。次の構文を使用して 1 つまたは複数のプロパティを指定できます。 <property name> = {yes | no} 使用可能なプロパティを、表「 Properties than can be passed to the import script (--property parameter): importing from a repository」に示します。 |
インポートプロセスを制御するプロパティ (-P
、 --property
) を以下に示します。
--property に指定可能な引数 |
説明 |
---|---|
includeCreateDatabase |
データベース全体をインポートする場合にのみ有効です。リポジトリ全体またはその一部のエレメントのみをインポートする場合は有効ではありません。
DROP DATABASE IF EXISTS <exported
db name>;
CREATE DATABASE <exported db
name>
ALTER DATABASE <exported db name>
CACHE OFF;
サーバーのすべてのメタデータをエクスポートする場合、出力にはすでに、データベースを作成するためのステートメントが含まれています。 デフォルト値: |
includeDependencies |
たとえば、このパラメータの値が デフォルト値: |
includeJars |
デフォルト値: |
includeEnvSpecificElements と includeNonEnvSpecificElements |
これらのオプションは、以下のどちらかを実行する場合に一緒に使用する必要があります。
以下のようにオプションを設定した場合、環境に依存するエレメントのメタデータのみがインポートされます。 -P includeNonEnvSpecificElements=no -P includeEnvSpecificElements=yes 以下のようにオプションを設定した場合、環境に依存しないエレメントのメタデータがインポートされます。 -P includeNonEnvSpecificElements=yes -P includeEnvSpecificElements=no 環境に依存しているとみなされるエレメントと、依存していないとみなされるエレメントのリストについては、「 環境に依存するエレメントと依存しないエレメントを別々のファイルにエクスポートする 」のセクションを参照してください。 注: これらのオプションは非推奨であり、使用しないでください。代わりに |
includeDeployments |
デフォルト値: |
例 1
import --singleuser --repository "C:/repository"
--server localhost:9999/admin?admin@admin
--server acme:12999/testing?admin@encrypted:iGTAJvv6CjEd1EvBVZyO4SSkgYCE7Z2C5PMZBLRUYk2YgeibnNZmk4HyTDcecoZuounNgjKxbsh1GO5bXjpRlRIkHOUaaVMj4INs7G3bLa3AE/1MGgSfiv3V4oC/1RVf
この例では、パス C:\repository
にあるリポジトリの内容が、以下の 2 つの Virtual DataPort サーバーにインポートされます。
localhost
のポート9999
で実行されているサーバー。admin
/admin
の資格情報を使用します。ホスト acme で実行されているサーバー。パスワードは暗号化されています。
例 2:
import --singleuser --repository "C:/repository"
--servers-file servers.conf
この例では、 servers.conf
ファイルからターゲットサーバーの URI が読み取られて、それらのサーバーにリポジトリの内容がインポートされます。
例 3:
import --singleuser --repository "C:/repository" --file output.vql
この例では、リポジトリのすべての VQL ステートメントを含む output.vql
ファイルが作成されます。このファイルが作成されるだけで、どのサーバーにも何もインポートされません。