データベースからの DAC の抽出

[アーティクル]
05/23/2023

適用対象:SQL Server Azure SQL Database Azure SQL Managed Instance

データ層アプリケーションの抽出ウィザード または Windows PowerShell スクリプトを使用すると、既存の SQL Server データベースからデータ層アプリケーション (DAC) パッケージを抽出できます。抽出プロセスでは、データベースオブジェクトの定義とそれに関連するインスタンスレベルの要素を格納した DAC パッケージファイルが作成されます。たとえば、DAC パッケージファイルには、データベーステーブル、ストアドプロシージャ、ビュー、ユーザー、およびデータベースユーザーにマップされているログインが含まれます。

開始する前に

SQL Database、または SQL Server 2000 (8.x) Service Pack 4 以降のインスタンスに存在するデータベースから DAC を抽出できます。 DAC から配置されたデータベースに対して抽出プロセスが実行された場合、データベース内のオブジェクトの定義のみが抽出されます。プロセスは msdb (のマスター SQL Database) で登録された DAC を参照しません。抽出プロセスは、データベースエンジンの現在のインスタンスの DAC 定義を登録しません。 DAC の登録の詳細については、「 Register a Database As a DAC」を参照してください。

制限事項と制約事項

DAC を抽出できるのは、 SQL Database、または SQL Server 2005 (9.x) Service Pack 4 (SP4) 以降のデータベースに限られます。 DAC でサポートされていないオブジェクトまたは包含ユーザーがデータベースに存在する場合は、DAC を抽出できません。 DAC でサポートされるオブジェクトの種類の詳細については、「 DAC Support For SQL Server Objects and Versions」を参照してください。

アクセス許可

DAC を抽出するには、少なくとも ALTER ANY LOGIN 権限とデータベーススコープの VIEW DEFINITION 権限、および sys.sql_expression_dependenciesに対する SELECT 権限が必要です。 DAC を抽出できるのは、DAC を抽出するデータベースの database_owner 固定データベースロールのメンバーでもある、securityadmin 固定サーバーロールのメンバーです。 sysadmin 固定サーバーロールのメンバーまたは sa という組み込みの SQL Server システム管理者アカウントも DAC を抽出できます。

データ層アプリケーションの抽出ウィザードの使用

ウィザードを使用して DAC を抽出するには

オブジェクトエクスプローラーで、DAC の抽出元となるデータベースを含んだインスタンスのノードを展開します。
[データベース] ノードを展開します。
DAC の抽出元となるデータベースのノードを右クリックし、 [タスク] をポイントして [データ層アプリケーションの抽出] を選択します。
ウィザードの各ダイアログの手順を実行します。

ウィザードの [説明] ページ

このページでは、データ層アプリケーションを抽出する手順について説明します。

[次回からこのページを表示しない] : 今後このページを表示しないようにするには、このチェックボックスをオンにします。

次に > - [ メソッドの選択 ] ページに進みます。

[キャンセル] : データベースからデータ層アプリケーションを抽出せずにウィザードを終了します。

[抽出ウィザード]

[データの選択] ページ

データ層アプリケーション (DAC) パッケージファイルに含める参照データを選択できます。 DAC パッケージにデータを含めることは必須ではありません。 DAC パッケージには、データベースに関連するサポート対象のデータベースオブジェクトおよびインスタンスオブジェクトのスキーマがすべて、既に含まれています。

DAC パッケージファイルには最大 10 MB の参照データを含めることができます。ただし、DAC に含まれるテーブルの場合、 image や varchar(max)などのバイナリラージオブジェクト (BLOB) データ型を含めることはできません。別のデータベースへ転送するためにより大量のデータを抽出するには、SQL Server Integration Services、一括コピーユーティリティ、または他の多くのデータ移行方法のいずれかを使用します。

[データベーステーブル] : DAC パッケージに含めるデータが含まれたデータベーステーブルの横にあるチェックボックスをオンにします。 10,000 行以下のテーブルを最大 10 個選択できます。

[抽出ウィザード]

[プロパティの設定] ページ

ウィザードのこのページでは、データ層アプリケーション (DAC) に関する情報を設定します。これらのプロパティは、DAC を識別し、他の DAC と区別するために使用されます。

[名前] : この名前で、DAC を識別します。 DAC パッケージファイルと異なる名前を設定できますが、アプリケーションを識別できる名前である必要があります。たとえば、データベースを財務アプリケーションで使用する場合は、"DAC Finance" などの名前を付けます。

[バージョン (xx.xx.xx.xx という形式で、x は数字)] : DAC のバージョンを表す数値。 DAC のバージョンは、開発者が操作している DAC のバージョンを特定するために Visual Studio で使用します。 DAC を配置すると、バージョンは msdb データベースに格納され、後での [データ層アプリケーション] SQL Server Management Studioノードの下に表示できます。

[説明] - 省略可能です。 DAC の説明です。 DAC を配置すると、説明は msdb データベースに格納され、後での [データ層アプリケーション] Management Studioノードの下に表示できます。

[DAC パッケージファイルに保存 (.dacpac 拡張子をファイル名に含める)] : DAC を拡張子が .dacpac の DAC パッケージファイルに保存します。 [参照] ボタンをクリックしてファイルの名前と場所を指定します。

[既存のファイルの上書き] : 同じ名前の DAC パッケージファイルが既に存在する場合にそのファイルを置き換えるには、このチェックボックスをオンにします。

[検証と概要] ページ

このページでは、すべてのデータベースオブジェクトがデータ層アプリケーション (DAC) でサポートされているかどうかを検証します。また、データベースオブジェクト間の依存関係を確認して、DAC に正常に含めることができるオブジェクトのセットを判断します。その後、検証レポートと、このウィザードで選択したオプションの概要を表示します。オプションを変更するには、 [戻る]をクリックします。 DAC の抽出を開始するには、 [次へ]をクリックします。

Note

1 つ以上のオブジェクトが DAC でサポートされていない場合は、 [次へ] ボタンは無効になり、抽出プロセスを続行できません。その場合は、サポートされていないオブジェクトを削除した後に、このウィザードを再度実行することをお勧めします。

[概要] : 選択したオプションの概要が [DAC のプロパティ]の下に表示されます。検証の結果は [DAC オブジェクト]の下に表示されます。検証の結果には、次の 3 種類があります。

[DAC に正常に含まれるオブジェクト]: これらのオブジェクトとその依存関係はサポートされており、DAC に正常に含めることができます。
[DAC に含まれるオブジェクト (警告あり)]: これらのオブジェクトはサポートされていますが、DAC でサポートされていない他のオブジェクトに依存しています。
[DAC に含まれないオブジェクト]: これらのオブジェクトはサポートされていないため、DAC を正常に抽出する前にデータベースから削除する必要があります。

検証プロセスでは、複数レベルで依存関係の確認が行われます。たとえば、あるストアドプロシージャがサポートされていない CLR データ型を使用するテーブルに依存している場合、そのストアドプロシージャは [DAC に含まれるオブジェクト (警告あり)]の下に表示されます。

[レポートの保存] : 概要の [DAC のオブジェクト] ノードの下に表示されるすべてのオブジェクトの一覧を示す HTML ベースのファイルを保存できるようにします。このレポートは、データベースオブジェクトの一部が DAC でサポートされていない場合に役立ちます。 DAC の抽出を再試行する前に、このレポートを使用してサポートされていないオブジェクトを変更または削除します。

[パッケージのビルド] ページ

このページでは、データ層アプリケーション (DAC) を抽出するウィザードの進行状況を監視できます。

[アクション] : [DAC パッケージファイルの作成と保存] では、SQL Server データベースから DAC が抽出されます。その後、DAC パッケージがメモリ内に作成され、指定した場所に保存されます。 [結果] 列のリンクを選択して、対応するステップの結果を確認します。

[レポートの保存] - 選択すると、ウィザードの進行状況の結果がファイルに保存されます。

[完了] - 処理が完了した後やエラーが発生した場合にクリックしてウィザードを閉じます。

PowerShell を使用して DAC を抽出する

PowerShell スクリプトで Extract() メソッドを使用してデータベースから DAC を抽出するには

SMO サーバーオブジェクトを作成し、それを DAC の抽出元データベースが含まれているインスタンスに設定します。
データベースの名前を指定する変数を追加します。
DAC のメタデータ (DAC 名、バージョン、説明など) を指定します。
抽出された DAC パッケージファイルのパスとファイル名を指定します。
上で指定した情報を使用して Extract メソッドを実行します。

例 (PowerShell)

次の例では、MyDB という名前のデータベースから MyApplication という名前の DAC を抽出します。

## Set a SMO Server object to the default instance on the local computer.  
CD SQLSERVER:\SQL\localhost\DEFAULT  
$srv = get-item .  
  
## Specify the database to extract to a DAC.  
$dbname = "MyDB"  
  
## Specify the DAC metadata.  
$applicationname = "MyApplication"  
$version = "1.0.0.0"  
$description = "This DAC defines the database used by my application."  
  
## Specify the location and name for the extracted DAC package.  
$dacpacPath = "C:\MyDACs\MyApplication.dacpac"  
  
## Extract the DAC.  
$extractionunit = New-Object Microsoft.SqlServer.Management.Dac.DacExtractionUnit($srv, $dbname, $applicationname, $version)  
$extractionunit.Description = $description  
$extractionunit.Extract($dacpacPath)