設定ファイルからオプションを読み込みます。@data dbeng12/dbsrv12 サーバーオプションを参照してください。

このオプションを使用すると、指定された環境変数または設定ファイルからオプションを読み込むことができます。同じ名前の環境変数と設定ファイルが両方存在する場合は、環境変数が使用されます。設定ファイルを参照してください。

設定ファイル内のパスワードなどの情報を保護する場合は、ファイル非表示ユーティリティを使用して、設定ファイルの内容を読みにくくすることができます。ファイル非表示ユーティリティ (dbfhide)を参照してください。

接続文字列で指定したデータベースに接続して、再ロードします。

このオプションを使用すると、データベースのアンロード処理と、既存データベースへの結果の再ロード処理を組み合わせることができます。

たとえば、次のコマンド (1 行で入力) は、field_user サブスクライバーのデータのコピーを既存のデータベースファイル c:\field.db にロードします。

dbxtract -c "UID=DBA;PWD=sql;DBF=c:\cons.db" 
-ac "UID=DBA;PWD=sql;DBF=c:\field.db" field_user

このオプションを使用した場合、データのコピーはディスク上に作成されないため、コマンドでアンロード用ディレクトリを指定する必要はありません。これによりデータのセキュリティは高まりますが、パフォーマンスは多少低下します。

抽出するデータベースと同じ設定でデータベースファイルを作成し、それを自動的に再ロードします。

このオプションを使用すると、データベースのアンロード、新規データベースの作成、データのロードを組み合わせて実行できます。

たとえば、次のコマンド (1 行で入力) は、新規のデータベースファイル c:\field.db を作成し、そこに c:\cons.db の field_user サブスクライバーのスキーマとデータをコピーします。

dbxtract -c "UID=DBA;PWD=sql;DBF=c:\cons.db" 
-an c:\field.db field_user

このオプションを使用した場合、データのコピーはディスク上に作成されないため、コマンドでアンロード用ディレクトリを指定する必要はありません。これによりデータのセキュリティは高まりますが、パフォーマンスは多少低下します。

データベース接続パラメーターを文字列として指定します。

ユーザーはデータベースの全テーブル上にパーミッションを持っている必要があるため、user ID には DBA 権限を持つユーザー ID を指定してください。

たとえば、次の文 (1 行で入力) は、ユーザー ID が DBA、パスワードが sql で接続している sample_server データベースサーバー上で実行しているサンプルデータベースから、リモートユーザー ID joe_remote のデータベースを抽出します。データは c:\extract ディレクトリにアンロードされます。

dbxtract -c "Server=sample_server;DBN=demo;
UID=DBA;PWD=sql" c:\extract joe_remote

接続パラメーターを指定しない場合、SQLCONNECT 環境変数が設定されていると、SQLCONNECT 環境変数からの接続パラメーターを使用します。

新しいデータベースで使用する暗号化アルゴリズムを指定します。このオプションにより、新しいデータベースの暗号化に強力な暗号化アルゴリズムを選択できます。AES (デフォルト) または AES_FIPS (FIPS 認定のアルゴリズム) のどちらかを選択できます。AES_FIPS は個別のライブラリを使用するため、AES との互換性はありません。

セキュリティを強化するには、128 ビットの場合は AES、256 ビットの場合は AES256 の強力な暗号化を指定します。FIPS 認定の暗号化を使用するには、128 ビットの場合は AES_FIPS、256 ビットの場合は AES256_FIPS をそれぞれ指定してください。強力な暗号化を使用するためには、-ek または -ep オプションも指定する必要があります。 強力な暗号化の詳細については、強力な暗号化を参照してください。

暗号化されていないデータベースを作成するには、-ea none を指定するか、-ea オプションを指定しません (-e、-et、-ep、-ek オプションも指定しません)。

-ea オプションを指定しない場合、デフォルトの動作は次のようになります。

• -ea none (-ek、-ep、-et が指定されない場合)
• -ea AES (-ek または -ep が指定される場合) (-et の指定とは無関係)
• -ea simple (-ek または -ep を指定せずに -et を指定する場合)

アルゴリズム名の大文字と小文字は区別されません。

新しいデータベースで使用する暗号化キーを指定する。このオプションを使用すると、コマンドに暗号化キーを直接指定することで、強力に暗号化されたデータベースを作成できます。データベースの暗号化に使用されるアルゴリズムは、-ea オプションで指定した AES または AES_FIPS です。 -ek オプションを指定して、-ea オプションを指定しないと、AES アルゴリズムが使用されます。

新しいデータベースで使用する暗号化キーの入力を要求します。このオプションを使用すると、ウィンドウに暗号化キーを入力することで、強力に暗号化されたデータベースを作成するように指定できます。クリアテキストでは暗号化キーを見ることができないようにすることで、高いセキュリティが得られます。

暗号化キーは、正確に入力されたことを確認するために 2 回入力してください。キーが一致しない場合は、初期化は失敗します。強力な暗号化を参照してください。

アンロード中に暗号化されたテーブルの暗号化を解除します。

テーブル暗号化が有効であるデータベースから抽出するとき、-er または -et を指定して、新しいデータベースのテーブルで暗号化を有効にするかどうかを指定する必要があります。このオプションを指定しないと、データを新しいデータベースにロードしようとしたときにエラーが発生します。

次のコマンド (すべて 1 行で入力) は、テーブルの暗号化を解除してデータベース (cons.db) を抽出し、テーブル暗号化が有効になっていない新しいデータベース (field.db) に再ロードします。

dbxtract -an c:\field.db -er -c "UID=DBA;PWD=sql;
DBF=c:\cons.db;DBKEY=29bN8cj1z field_user"

新しいデータベースのテーブル暗号化を有効にします (-an または -ar も一緒に指定する必要があります)。-ea オプションを指定せずに -et オプションを指定すると、AES アルゴリズムが使用されます。-et オプションを指定する場合、-ep または -ek も指定しないと操作は失敗します。新しいデータベースのテーブル暗号化設定を変更して、アンロードしているデータベースのテーブル暗号化設定とは異なるものに設定できます。

テーブル暗号化が有効であるデータベースを再構築するとき、-er または -et を指定して、新しいデータベースのテーブルで暗号化を有効にするかどうかを指定する必要があります。このオプションを指定しないと、データを新しいデータベースにロードしようとしたときにエラーが発生します。

次の例 (すべて 1 行で入力) は、テーブルが単純暗号化アルゴリズムによって暗号化されたデータベース (cons.db) を、テーブル暗号化が有効になっている新しいデータベース (field.db) にアンロードし、キーを 34jh として AES_FIPS アルゴリズムを使用します。

dbxtract -an c:\field.db -et -ea AES_FIPS -ek 34jh 
-c "UID=DBA;PWD=sql;DBF=c:\cons.db field_user"

完全に修飾されたパブリケーションを抽出します。ほとんどの場合、完全に修飾されたパブリケーション定義をリモートデータベース用に抽出する必要はありません。通常、すべてのローはレプリケートされ、統合データベースに戻されます。

しかし、多層の設定や、統合データベースにないローがリモートデータベースにある設定では、完全に修飾されたパブリケーションが必要な場合もあります。

内部アンロードと内部再ロードを実行します。このオプションを使用すると、再ロードスクリプトは、データのアンロードとロードそれぞれに対して、Interactive SQL の OUTPUT 文と INPUT 文ではなく、内部の UNLOAD 文と LOAD TABLE 文を強制的に使用します。このオペレーションの組み合わせがデフォルトの動作です。

データファイルのパスには、外部オペレーションでは dbxtract の現在の作業ディレクトリからの相対パスを使用し、内部の文ではデータベースサーバーからの相対パスを使用します。

内部アンロードと外部再ロードを実行します。このオプションを使用すると、再ロードスクリプトは、データのアンロードに対して内部の UNLOAD 文を強制的に使用し、新しいデータベースへのデータのロードに対して Interactive SQL の INPUT 文を強制的に使用します。

データファイルのパスには、外部オペレーションでは dbxtract の現在の作業ディレクトリからの相対パスを使用し、内部の文ではデータベースサーバーからの相対パスを使用します。

スキーマ定義のみ抽出します。この定義を指定すると、データはアンロードされません。再ロードファイルには、データベーススキーマだけを構築する SQL 文が記述されています。SYNCHRONIZE SUBSCRIPTION 文を使用すると、メッセージシステム全体のデータをロードできます。SYNCHRONIZE SUBSCRIPTION 文 [SQL Remote]を参照してください。 パブリケーション、サブスクリプション、PUBLISH パーミッション、SUBSCRIBE パーミッションは、スキーマの一部です。

dbxtract -c "UID=DBA;PWD=sql;DBF=c:\remote\cons\cons.db" 
-n "c:\remote\reload.sql" UserName

構造体を抽出します (-n オプションと同じ動作)。ただし、生成される reload.sql ファイルには、各テーブルに対する LOAD TABLE 文または INPUT 文も含まれます。このオプションを使用した場合、ユーザーデータは抽出されません。-nl を指定するときには、LOAD/INPUT 文を生成できるようにデータディレクトリも指定する必要があります。ただし、このディレクトリにファイルは書き込まれません。このオプションを指定すると、データをアンロードしない再ロードスクリプトを生成できます。データを抽出するには、-d を指定します。データベースにデータのアンロードが不要なテーブルがある場合は、dbxtract -d -e table-name と指定することによって、データのアンロードを回避できます。

クワイエットモードで処理を実行し、メッセージまたはウィンドウの表示を行いません。このオプションは -y オプションと一緒に指定してください。そうしないと操作は失敗します。

このオプションは、コマンドラインユーティリティに対してのみ使用できます。

生成された再ロード Interactive SQL スクリプトファイルの名前を指定します。

再ロードスクリプトファイルのデフォルト名は、現在のディレクトリの reload.sql です。このオプションを使用して異なるファイル名を指定できます。

外部アンロードと内部再ロードを実行します。データベースのアンロードでは、デフォルトの動作として UNLOAD 文を使用します。これはデータベースサーバーが実行します。外部アンロードを選択すると、dbxtract は UNLOAD 文の代わりに OUTPUT 文を使用します。OUTPUT 文はクライアントで実行されます。

データファイルのパスには、外部オペレーションでは dbxtract の現在の作業ディレクトリからの相対パスを使用し、内部の文ではデータベースサーバーからの相対パスを使用します。

外部アンロードと外部ロードを実行する。データをアンロードする場合には、OUTPUT 文が使用されます。また、新規データベースにデータをロードする場合には、INPUT 文が使用されます。

アンロードのデフォルト動作では UNLOAD 文が使用され、ロードのデフォルト動作では LOAD TABLE 文が使用されます。内部の UNLOAD 文と LOAD TABLE 文を使用すると、OUTPUT 文と INPUT 文よりも高速で処理します。

データファイルのパスには、外部オペレーションでは dbxtract の現在の作業ディレクトリからの相対パスを使用し、内部の文ではデータベースサーバーからの相対パスを使用します。