指定された環境変数または設定ファイルからオプションを読み込みます。設定ファイルの使用を参照してください。

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

既存のデータベースに接続し、データをそのデータベースに直接再ロードすることによって、データベースのアンロードとその結果を既存のデータベースに再ロードする操作を一度に実行します。このオプションは、Windows Mobile ではサポートされていません。

たとえば、初期化ユーティリティを使用して新しいデータベースを作成し、このオプションを使用して再ロードすることもできます。この方法は、初期化オプションを変更する場合に便利です。

次のコマンド (すべて 1 行に入力) は、c:\mydata.db データベースのコピーを c:\mynewdata.db という既存のデータベース・ファイルにロードします。

dbunload -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"
         -ac "UID=DBA;PWD=sql;DBF=c:\mynewdata.db"

元のデータベースがバージョン 9 以前の SQL Anywhere で作成されており、新しいデータベースがまだ実行されていない場合は、-ac オプションでデータベース・サーバの名前を指定する必要があります。次に例を示します。

dbunload -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"
          -ac "UID=DBA;PWD=sql;DBF=c:\mynewdata.db;ENG=newserver"

このオプションを使用した場合、データの中間コピーはディスク上に作成されないため、コマンドにアンロード・ディレクトリは指定しないでください。これにより、データのセキュリティが向上します。

このオプションを使用すると、データベースのアンロード、新規データベースの作成、データのロードを一度に実行できます。このオプションは、Windows Mobile 上、または Intel ベースの Mac OS X でバージョン 9 以前のデータベースを再構築する場合にはサポートされません。

ソース・データベースを作成したときに指定されたオプションが、新しいデータベースの作成に使用されます。ただし、サポートされているその他の dbunload オプション (たとえば、ページ・サイズを変更するときは -ap、テーブル暗号化を有効にするときは -et) を指定して、必要に応じて初期化オプションを変更することができます。

たとえば、次のコマンド (すべて 1 行に入力) は、mydatacopy.db という名前の新規データベース・ファイルを作成し、mydata.db のスキーマとデータをその中にコピーします。

dbunload -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"
         -an c:\mydatacopy.db

このオプションを使用した場合、データの中間コピーはディスク上に作成されないため、コマンドにアンロード・ディレクトリは指定しません。これにより、データのセキュリティが向上します。

新しいデータベースが作成されると、DB 領域ファイル名に R が追加され、元のデータベースの DB 領域と同じディレクトリに新しいデータベースの DB 領域が作成された場合の名前の競合を防ぎます。たとえば、アンロードされたデータベースの library.db ファイルに library という DB 領域がある場合、新しいデータベースの library DB 領域は library.dbR となります。

-an には、ファイル名としてデータベース・サーバに対する相対パスを指定します。

古いデータベースと同じ設定を持つ新しいデータベースを作成し、新しいデータベースを再ロードして、古いデータベースと置き換えます。ただし、サポートされているその他の dbunload オプション (たとえば、ページ・サイズを変更するときは -ap、テーブル暗号化を有効にするときは -et) を指定して、必要に応じて初期化オプションを変更することができます。

このオプションを使用する場合は、データベースへの他の接続がなく、データベース接続が、ネットワークではなくローカルである必要があります。このオプションは、Windows Mobile 上、または Intel ベースの Mac OS X でバージョン 9 以前のデータベースを再構築する場合にはサポートされません。

オプションの directory を指定すると、レプリケーションを行うためにトランザクション・ログのオフセットがリセットされ、古いデータベースのトランザクション・ログが指定のディレクトリに移動されます。指定されたディレクトリは、Message Agent と Replication Agent が使用する古いトランザクション・ログを保持している必要があります。トランザクション・ログ管理は、データベースがレプリケーションで使用されるときだけ実行されます。SQL Remote パブリッシャや LTM チェックがない場合、古いトランザクション・ログは不要なので、指定するディレクトリにはコピーされず、削除されます。同期やレプリケーションに関連するデータベースのバックアップを参照してください。

新しいデータベースが作成されると、DB 領域ファイル名に R が追加され、元のデータベースの DB 領域と同じディレクトリに新しいデータベースの DB 領域が作成された場合の名前の競合を防ぎます。たとえば、アンロードされたデータベースの library.db ファイルに library という DB 領域がある場合、新しいデータベースの library DB 領域は library.dbR となります。

暗号化されたデータベースを再構築する場合は、新しいデータベースで元のデータベースと同じ暗号化キーを使用する必要があります。

-ar オプションを使用すると、データベースのトランケーション・ポイントが 0 にリセットされます。

ソース・データベースの接続パラメータを指定します。接続パラメータの説明については、接続パラメータを参照してください。ユーザはデータベースの全テーブル上にパーミッションを持っている必要があるため、user ID には DBA 権限を持つユーザ ID を指定してください。

たとえば、次の文は、パスワード sql を指定してユーザ ID DBA として接続し、サンプル・データベースをアンロードします。データは c:\unload ディレクトリにアンロードされます。

dbunload -c "DBF=samples-dir\demo.db;UID=DBA;PWD=sql" c:\unload

samples-dir の詳細については、サンプル・ディレクトリを参照してください。

サーバ・メッセージ・ウィンドウに、アンロードしているデータベースと同じデータベースを作成する CREATE DATABASE 文または dbinit コマンドを表示します。-an も一緒に指定した場合、表示されるコマンドは、新しいデータベースを作成するコマンドです。

既存の強力に暗号化された (-an を指定していない) データベースの文またはコマンドを表示するとき、データベースから暗号化キーを取得できないので、ENCRYPTED 句または -ek オプションに疑問符 (?) が表示されます。

データベース内のすべての計算カラムを再計算します。デフォルトでは、計算カラムは再計算されません。-dc オプションを指定すると、reload.sql スクリプトに計算カラムの再計算に対応するセクションが追加されます。追加される文は次のような形式です。

ALTER TABLE "owner"."table-name"
ALTER "computed-column" SET COMPUTE (compute-expression);

テーブルに CURRENT DATE などのコンテキスト依存の計算カラムがある場合は、-dc オプションを使用するのではなく、ALTER TABLE 文を使用して計算カラムの値を再計算することをおすすめします。ALTER TABLE 文を参照してください。

指定されたテーブルを reload.sql ファイルから除外します。大文字と小文字を区別するデータベースであっても、テーブル名では常に大文字と小文字が区別されません。

-e オプションを使用して作成した reload.sql ファイルにはすべてのデータベース・テーブルが含まれるわけではないので、このファイルを使用してデータベースを再構築しないでください。外部キーによって参照されているテーブルがある場合、そのテーブルの内容がなければ、データベースを再構築できません。

-e オプションを使用する場合は、必ず -d オプションも使用し、-e で指定したテーブルを除くすべてのテーブルのデータをアンロードすることをおすすめします。

データベース暗号化またはテーブル暗号化 (-et) で使用する暗号化アルゴリズムを指定します。単純暗号化の場合は、(-ek や -ep を指定するのではなく) -ea simple を指定します。単純暗号化はデータベースの難読化に相当し、データベース・ファイルが不用意に直接アクセスされた場合にデータが表示されないようにすることだけを目的としています。これにより第三者は、ディスク・ユーティリティを使用してファイルを表示し、データベースのデータを解読することが困難になります。

セキュリティを強化するには、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 を指定する場合)

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

(-an オプションを使用して) データベースのアンロードと再ロードを実行する場合に、作成する新しいデータベースに対する暗号化キーを dbunload コマンドに指定します。強力に暗号化されたデータベースを作成する場合、データベースやトランザクション・ログを使用するには必ず暗号化キーを指定します。データベースの暗号化に使用されるアルゴリズムは、-ea オプションで指定したアルゴリズムです。-ea オプションを指定せずに、-ek オプションを指定すると、AES アルゴリズムが使用されます。強力な暗号化を参照してください。

キーは保護してください。キーのコピーは、安全な場所に保管してください。キーを紛失すると、データベースにまったくアクセスできなくなり、リカバリも不可能になります。

(-an オプションを使用して) データベースのアンロードと再ロードを実行する場合に、作成する新しいデータベースに対する暗号化キーの指定を求めるプロンプトを表示します。クリア・テキストでは暗号化キーを見ることができないようにすることで、高いセキュリティが得られます。-an を指定せずに -ep を指定した場合、-ep オプションは無視されます。-ep と -an を指定する場合は、暗号化キーが正確に入力されたことを確認するために、2 回入力してください。キーが一致しない場合は、アンロードは失敗します。強力な暗号化を参照してください。

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

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

次のコマンドは、テーブルの暗号化を解除してデータベース (mydata.db) をアンロードし、テーブル暗号化が有効になっていない新しいデータベース (mydatacopy.db) に再ロードします。

dbunload -an c:\mydatacopy.db -er 
         -c "UID=DBA;PWD=sql;
         DBF=c:\mydata.db;
         DBKEY=29bN8cj1z"

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

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

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

dbunload -an c:\mydatacopy.db -et -ea AES_FIPS
         -ek 34jh
         -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"

マテリアライズド・ビュー   MANUAL REFRESH と定義されているマテリアライズド・ビューは、デフォルトでは再ロード後に初期化されません。このようなマテリアライズド・ビューを再ロード・プロセス中に初期化するには、-g オプションを指定してください。-g を指定すると、データベース・サーバによって sa_refresh_materialized_views システム・プロシージャが実行されます。sa_refresh_materialized_views システム・プロシージャを参照してください。

-g オプションを指定するかどうかを決定するときには、すべてのマテリアライズド・ビューを初期化すると再ロード・プロセスの実行時間が大幅に長くなる可能性があることを考慮に入れてください。一方、-g オプションを指定しない場合、初期化されていないマテリアライズド・ビューを最初に使用しようとしたクエリはビューの初期化が完了するまで待つことになり、予想外の遅延が生じることがあります。-g オプションを指定しない場合は、再ロードの完了後に、マテリアライズド・ビューを手動で初期化することもできます。マテリアライズド・ビューの初期化を参照してください。

テキスト・インデックス   MANUAL REFRESH と定義されているテキスト・インデックスは、デフォルトでは再ロード後に初期化されません。このようなテキスト・インデックスを再ロード・プロセス中に初期化するには、-g オプションを指定してください。-g を指定すると、データベース・サーバによって sa_refresh_text_indexes システム・プロシージャが実行されます。sa_refresh_text_indexes システム・プロシージャを参照してください。

sa_diagnostic_auxiliary_catalog テーブルにデータを移植します。このテーブルは、テーブル、ユーザ、プロシージャなどのデータベース・オブジェクト ID をソース・データベースからトレーシング・データベースにマッピングします。このとき、すべてのヒストグラムがアンロード／再ロードされます。このオプションは、診断トレーシング情報を受け取るトレーシング・データベースを作成する場合に使用します。sa_diagnostic_auxiliary_catalog テーブルによって、サーバはトレーシング・データを収集したときの状態を (インデックス・コンサルタントやアプリケーション・プロファイリングなどの目的で) シミュレートすることができます。このオプションが特に役立つのは、-n オプションと一緒に指定した場合です。診断トレーシングを使用した詳細なアプリケーション・プロファイリングとsa_diagnostic_auxiliary_catalog テーブルを参照してください。

データベースを再構築しても SYSTABCOL.max_identity の現在の値を維持します。

デフォルトでは、オートインクリメント・カラムがあるテーブルを含むデータベースを再構築すると、データベース・サーバでは、テーブルの現在の内容に基づいて、各オートインクリメント・カラムに使用できる次の値が計算されます。ほとんどの場合はこの処理で十分です。ただし、値の範囲の最後からローが削除されている場合は、値が再利用される可能性があり、この処理が適切ではない場合があります。

-l オプションを指定すると、オートインクリメント値が含まれるテーブルごとに、sa_reset_identity システム・プロシージャへの呼び出しが生成される reload.sql スクリプトに追加され、SYSTABCOL.max_identity の現在の値が維持されます。

参照

• オートインクリメント・カラムのあるテーブルの再ロード
• SYSTABCOL システム・ビュー
• sa_reset_identity システム・プロシージャ

データベース・オブジェクトを名前順にアンロードします。デフォルトでは、dbunload は作成された順にオブジェクトを生成します。作成順序が異なる同一のオブジェクトが複数のデータベース内にある場合は、-no オプションを指定すると、データベース・スキーマを比較する際に役立ちます。

-no を指定すると、オブジェクトの定義は reload.sql ファイル内でオブジェクト・タイプのアルファベット順で分類されます。

• ユーザ
• グループ・メンバシップ
• テーブル
• インデックスと外部キー
• ビュー
• プロシージャ
• 関数
• トリガ
• イベント
• Web サービス

オブジェクトの定義は、所有者と名前の順で出力されます。場合によっては、3 つ目の要素 (たとえば、外部キーのロール名や、トリガ名) が順序の決定に関与することもあります。

-no オプションは、-n、-nl、-ar、-an、-ac オプションと一緒には使用できません。同じバージョンのデータベース・サーバを使用して作成されたデータベースの再ロード・スクリプトを比較するときは、比較を簡単にするために、-no オプションを使用することをおすすめします。これは、オブジェクトの定義間にわずかな違いがあるからです。

アンロードするテーブルのリストを指定します。デフォルトでは、すべてのテーブルがアンロードされます。-n オプションと一緒に使うと、テーブル定義のセットだけをアンロードできます。大文字と小文字を区別するデータベースであっても、テーブル名では常に大文字と小文字が区別されません。

-t オプションを使用して作成した reload.sql ファイルにはすべてのデータベース・テーブルが含まれるわけではないので、このファイルを使用してデータベースを再構築しないでください。外部キーによって参照されているテーブルがある場合、そのテーブルの内容がなければ、データベースを再構築できません。

-t オプションを使用する場合は、必ず -d オプションも使用し、-t で指定したテーブルのデータをアンロードすることをおすすめします。

確認メッセージを表示することなく、既存のコマンド・ファイルを置き換えます。-q を指定する場合、-y も指定する必要があります。-y を指定しなければ、dbunload が既存のコマンド・ファイルを検出した場合、アンロードは失敗します。

レプリケーションに参加しているデータベースをアンロードする場合、特殊な考慮事項がいくつかあります。リモート・データベースの抽出とSQL Remote のアップグレードを参照してください。