import スクリプト¶
import
スクリプトは、1 つの Virtual DataPort サーバーに、または同時に複数の Virtual DataPort サーバーに、VQL ファイルまたはリポジトリの内容をインポートします。
以下のセクションでは、次の操作の方法について説明します。
VQL ファイルから、または VQL ファイルとプロパティファイルから、メタデータをインポートする。「 1 つの VQL ファイルからのメタデータのインポート 」を参照してください。
リポジトリからメタデータをインポートする。「 リポジトリからのメタデータのインポート 」を参照してください。
このスクリプトは、 <DENODO_HOME>/bin
ディレクトリにあります。
このスクリプトは、以下のいずれかの終了コードを返します。
0: エラーなし。ファイルのすべての VQL ステートメントは正常に実行されました。
126: 1 つまたは複数の VQL ステートメントの実行が失敗しました。
1: 他のエラー。たとえば、スクリプトで Virtual DataPort サーバーとのコネクションを開くことができませんでした。
1 つの VQL ファイルからのメタデータのインポート¶
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。 サーバーのパスワードを暗号化して指定できます。これを行うには、 例: このスクリプトを使用して長時間かかる可能性があるクエリを実行する場合、パラメーター
このパラメーターの値は、オペレーティングシステムで 1 つのパラメーターとみなされるように、引用符で囲む必要があります。 パラメーター |
-s -\-servers-file <servers file> |
パラメーター
|
-f -\-file <input file> |
インポートするメタデータを含むファイルのパス。 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 ]
パラメーター名 |
説明 |
---|---|
-r -\-repository |
リポジトリのディレクトリのパス。 |
-e -\-element |
インポートするエレメントのリポジトリ内でのパス。このオプションは、リポジトリの一部のエレメントのみをインポートする場合に使用します。 例: エレメントとその依存関係をインポートする場合、 例: |
-re -\-repository-element |
リポジトリに保存されているエレメントの ID パス。 構文: 例: 使用可能なタイプは、 サブタイプの値として、 |
-h -\-server <host>: <port>/<database> ?<user>@<password> |
サーバーの URI。 暗号化されたパスワードを使用する場合、 その場合、このパラメーターの値に接頭辞 例: //localhost:9999/admin?admin@encrypted:Gr16MjvuXhRzPtPH/yTXHw== |
-s -\-servers-file |
パラメーター 各 URI は、パラメーター |
-f -\-file <input file> |
インポートするメタデータを含む VQL ファイルのパス。 |
-su -\-singleuser |
指定されている場合、import スクリプトは、 これにより、Virtual DataPort は、このファイルをインポートする間、シングルユーザーモードに切り替わります。 注: シングルユーザーモードで Virtual DataPort サーバーにメタデータをインポートすることが強く推奨されます。 |
-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 環境に依存しているとみなされるエレメントと、依存していないとみなされるエレメントのリストについては、「 Exporting Environment-Dependent and Independent Elements to Different Files 」のセクションを参照してください。 注: これらのオプションは非推奨であり、使用しないでください。代わりに |
includeDeployments |
デフォルト値: |
例 1
import --singleuser --repository "C:/repository"
--server localhost:9999/admin?admin@admin
--server acme:12999/testing?admin@encrypted:Gr16MjvuXhRzPtPH/yTXHw==
この例では、パス 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
ファイルが作成されます。このファイルが作成されるだけで、どのサーバーにも何もインポートされません。
例 4:
import --singleuser --repository "c:\repository" --file output.vql
--element "databases\admin\folders\baseviews\views\bv_salesforce_lead.vql"
--dependencies --server localhost:13999/admin?admin@admin
この例では、 databases\admin\folders\baseviews\views\bv_salesforce_lead.vql
ファイルに含まれる VQL ステートメントが実行されます。
このファイルのパスは、パラメーター --repository
で指定されているパスを基準にした相対パスです。
パラメーター --dependencies
が追加されているため、まず bv_salesforce_lead.vql
の依存関係が実行されます。このエレメントの依存関係を判断するために、 bv_salesforce_lead.dependencies
ファイルが読み取られます。このファイルには、 bv_salesforce_lead.vql
が依存するエレメントを作成するために処理する必要がある VQL ファイルが記述されています。