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

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

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

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

次のコマンド (すべて 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"

新しいデータベースが元のデータベースと同じファイル名を持つ必要がある場合、DBN 接続パラメーターを使用して正しいデータベース名を指定します。DatabaseName (DBN) 接続パラメーターを参照してください。

次のコマンド (すべてを 1 行で入力する) は、同じファイル名 mydata.db を持つ新しいデータベースに古いデータベースのコピーをロードします。

dbunload -c "UID=DBA;PWD=sql;DBN=old;DBF=c:\old_directory\mydata.db"
         -ac "UID=DBA;PWD=sql;DBN=new;DBF=c:\new_directory\mydata.db"

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

dbunload -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"
          -ac "UID=DBA;PWD=sql;DBF=c:\mynewdata.db;Server=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 が使用する古いトランザクションログを保持している必要があります。トランザクションログ管理は、データベースがレプリケーションで使用されるときだけ実行されます。SQL Remote パブリッシャーがない場合、古いトランザクションログは不要なので、指定するディレクトリにはコピーされず、削除されます。同期やレプリケーションに関連するデータベースのバックアップを参照してください。

新しいデータベースが作成されると、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=%SQLANYSAMP12%\demo.db;UID=DBA;PWD=sql" c:\unload

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

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

バージョン 10 以前のデータベースサーバーで作成したデータベースをアンロードする場合は、データベースを作成するコマンドまたは文は表示されません。

データベース内のすべての計算カラムを再計算します。デフォルトでは、計算カラムは再計算されません。-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 オプションで指定したアルゴリズムです。-ek オプションを指定して、-ea オプションを指定しないと、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"

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

データベースを 1 つの DB 領域ファイルに再ロードします。このオプションは、トレーシングデータベースを作成しているコンピューターのディレクトリ構造が運用データベースと同じでない場合に、トレーシングデータベースを作成するのに便利です。外部トレーシングデータベースの作成 (Sybase Central の場合)を参照してください。

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

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

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

参照：

• AUTOINCREMENT カラムのあるテーブルの再ロード
• 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 のアップグレードを参照してください。