データ層アプリケーションの配置

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

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

ウィザードまたは PowerShell スクリプトを使用して、データ層アプリケーション (DAC) パッケージからデータベースエンジンまたは Azure SQL Database の既存のインスタンスに DAC を配置できます。

デプロイプロセスでは、msdb システムデータベース (masterでは SQL Database) に DAC 定義を格納することで DAC インスタンスを登録し、データベースを作成して、DAC で定義されたすべてのデータベースオブジェクトをそのデータベースに設定します。

同じ DAC パッケージを複数回配置する

同じ DAC パッケージをデータベースエンジンの単一のインスタンスに複数回配置することはできますが、配置は一度に 1 つずつ実行する必要があります。各デプロイに指定される DAC インスタンス名は、データベースエンジンのインスタンス内で一意である必要があります。

データベースのオプションと設定

既定では、配置中に作成されたデータベースには、CREATE DATABASE ステートメントによる既定の設定すべてが適用されます。ただし、次の設定は除きます。

データベースの照合順序および互換性レベルは、DAC パッケージで定義された値に設定されます。 SQL Server 開発者ツールでデータベースプロジェクトから構築された DAC パッケージでは、データベースプロジェクトに設定された値が使用されます。既存のデータベースから抽出されたパッケージでは、元のデータベースの値が使用されます。
一部のデータベース設定 (データベース名やファイルパスなど) は、 [構成の更新] ページで調整できます。 SQL Database に配置する場合、ファイルパスは設定できません。

TRUSTWORTHY、DB_CHAINING、HONOR_BROKER_PRIORITY など、データベースオプションによっては、デプロイ作業中の調整はできない場合があります。ファイルグループの数、ファイルの数やサイズなどの物理プロパティは、デプロイ作業中に変更することはできません。デプロイが完了すれば、ALTER DATABASE ステートメント、SQL Server Management Studio、または SQL Server PowerShell を使用して、データベースを調整できます。

制限事項と制約事項

DAC を配置できるのは、SQL Database、または SQL Server 2005 (9.x) Service Pack 4 (SP4) 以降を実行しているデータベースエンジンのインスタンスです。新しいバージョンを使用して DAC を作成した場合、SQL Server 2005 (9.x) ではサポートされないオブジェクトが DAC に含まれている可能性があります。これらの DAC を SQL Server 2005 (9.x) のインスタンスにデプロイすることはできません。

セキュリティとアクセス許可

認証のログインは、パスワードなしで DAC パッケージに格納されます。パッケージが配置またはアップグレードされると、ログインは、生成されたパスワードを伴う無効なログインとして作成されます。ログインを有効にするには、ALTER ANY LOGIN 権限のあるログインでログインし、ALTER LOGIN を使用してログインを有効にします。さらに、新しいパスワードを割り当て、そのパスワードを該当ユーザーに通知します。 Windows 認証ログインの場合、ログインのパスワードは SQL Server で管理されていないため、この操作は必要ありません。

DAC を配置できるのは、sysadmin または serveradmin 固定サーバーロールのメンバーか、dbcreator 固定サーバーロールに存在する ALTER ANY LOGIN 権限を持つログインのみです。あらかじめ登録されたシステム管理者アカウント sa でも DAC をデプロイできます。

SQL Database へのログインが含まれる DAC をデプロイするには、loginmanager ロールまたは serveradmin ロールのメンバーシップが必要です。 SQL Database へのログインが含まれない DAC をデプロイするには、dbmanager ロールまたは serveradmin ロールのメンバーシップが必要です。

ウィザードを使用して DAC を配置する

オブジェクトエクスプローラーで、DAC を配置するインスタンスのノードを展開します。
[データベース] ノードを右クリックし、[データ層アプリケーションの配置] をクリックします。
ウィザードのダイアログを完了し、[完了] を選択します。

以下は、ウィザードページの詳細の一部です。

[DAC パッケージの選択] ページ

配置するデータ層アプリケーションを含む DAC パッケージを指定します。このページは、3 つの状態を遷移します。

DAC パッケージの選択

配置する DAC パッケージを選択します。 DAC パッケージは有効な DAC パッケージファイルで、拡張子は .dacpac である必要があります。

[DAC パッケージ] : 配置するデータ層アプリケーションを含む DAC パッケージのパスとファイル名を指定します。ボックスの右にある [参照] をクリックして、DAC パッケージの場所に移動することができます。

[アプリケーション名] : DAC が作成されたとき、またはデータベースから抽出されたときに割り当てられた DAC 名が表示される読み取り専用のボックスです。

[バージョン] : DAC が作成されたとき、またはデータベースから抽出されたときに割り当てられたバージョンが表示される読み取り専用のボックスです。

[説明] : DAC が作成されたとき、またはデータベースから抽出されたときに記述された説明が表示される読み取り専用のボックスです。

DAC パッケージの検証

選択したファイルが有効な DAC パッケージかどうかが確認され、進捗状況バーが表示されます。 DAC パッケージが検証されると、 [DAC パッケージの選択] ページの最終状態に進み、検証の結果を確認できます。ファイルが有効な DAC パッケージでない場合は、 [DAC パッケージの選択]が表示されたままになります。別の有効な DAC パッケージを選択するか、ウィザードを取り消して新しい DAC パッケージを生成してください。

[ポリシーの確認] ページ

DAC にポリシーが含まれている場合に DAC サーバーの選択ポリシーを評価した結果を確認します。 DAC サーバーの選択ポリシーは、省略可能で、Visual Studio で DAC を作成するときに割り当てられます。このポリシーでは、サーバーの選択ポリシーのファセットを使用して、データベースエンジンのインスタンスで DAC をホストするために満たす必要がある条件を指定します。

[ポリシー条件の評価結果] : DAC 配置ポリシーの条件が満たされたかどうかを示します。各条件の評価結果が、レポートの各行に表示されます。

サーバーの選択ポリシー (オペレーティングシステムのバージョン、言語、名前付きパイプの有効化、プラットフォーム、および TCP の有効化) は、DAC を SQL Database にデプロイする場合は常に false となります。

[ポリシー違反を無視します] : ポリシー条件が満たされていない場合に配置を続行するには、このチェックボックスを使用します。すべての条件が満たされていなくても DAC を正常に操作できるようにする場合のみ、このチェックボックスをオンにしてください。

[構成の更新] ページ

配置された DAC インスタンスの名前と、配置によって作成されたデータベースの名前を指定し、データベースオプションを設定します。

[データベース名] : 配置によって作成されるデータベースの名前を指定します。既定では、DAC の抽出元であるソースデータベースの名前です。この名前は、データベースエンジンのインスタンス内で一意であり、データベースエンジン識別子のルールに従っている必要があります。

データベース名を変更した場合、データファイルとログファイルの名前も新しいデータベース名に合わせて変更されます。

また、データベース名は、DAC インスタンスの名前としても使用されます。インスタンス名は、 オブジェクトエクスプローラー の [データ層アプリケーション]ノードの下にある、DAC のノードに表示されます。

次のオプションは SQL Database には適用されず、SQL Database へのデプロイ時には表示されません。

[既定のデータベースの場所の使用] : データベースのデータファイルおよびログファイルをデータベースエンジンのインスタンスの既定の場所に作成するには、このオプションを選択します。ファイル名は、データベース名を使用して作成されます。

[データベースファイルの指定] : データファイルおよびログファイルに別の場所または名前を指定するには、このオプションを選択します。

[データファイルのパスと名前] : データファイルの完全パスとファイル名を指定します。このボックスには、既定のパスとファイル名が表示されます。ボックス内の文字列を編集して既定値を変更するか、[参照] をクリックしてデータファイルを配置するフォルダーに移動してください。

[ログファイルのパスと名前] : ログファイルの完全パスとファイル名を指定します。このボックスには、既定のパスとファイル名が表示されます。ボックス内の文字列を編集して既定値を変更するか、 [参照] をクリックしてログファイルを配置するフォルダーに移動してください。

[概要] ページ

このページでは、DAC のデプロイ時にウィザードが行うアクションを確認します。

[次の設定を使用して DAC を配置します。] : 表示された情報を確認し、実行されるアクションが正しいかどうかを確認します。このウィンドウには、選択した DAC パッケージと、配置される DAC インスタンス用に選択した名前が表示されます。また、DAC に関連付けられたデータベースを作成する際に使用される設定も表示されます。

[配置] ページ

このページには、配置操作の成功または失敗が表示されます。

[DAC を配置しています] : DAC を配置するために行った各アクションの成功または失敗が表示されます。内容を確認して、各アクションの成功または失敗を判断します。エラーが発生したアクションには、 [結果] 列にリンクが表示されます。そのアクションのエラーのレポートを表示するには、リンクをクリックします。

[レポートの保存] : 配置レポートを HTML ファイルに保存します。ファイルには、アクションで発生したすべてのエラーを含む、各アクションのステータスが報告されます。既定のフォルダーは、Windows アカウントの Documents フォルダーにある SQL Server Management Studio\DAC Packages フォルダーです。

PowerShell の使用

SMO サーバーオブジェクトを作成し、DAC を配置するインスタンスに設定します。
ServerConnection オブジェクトを開いて、同じインスタンスに接続します。
System.IO.File を使用して、DAC パッケージファイルを読み込みます。
add_DacActionStarted と add_DacActionFinished を使用して、DAC 配置イベントをサブスクライブします。
DatabaseDeploymentPropertiesを設定します。
DacStore.Install メソッドを使用して、DAC を配置します。
DAC パッケージファイルの読み取りに使用するファイルストリームを閉じます。

次の例では、MyApplication.dacpac パッケージから DAC 定義を使用して、MyApplication という名前の DAC をデータベースエンジンの既定のインスタンスに配置します。

PowerShell の例

## Set a SMO Server object to the default instance on the local computer.
CD SQLSERVER:\SQL\localhost\DEFAULT
$server = Get-Item .
  
## Open a Common.ServerConnection to the same instance.
$serverConnection = New-Object Microsoft.SqlServer.Management.Common.ServerConnection($server.ConnectionContext.SqlConnectionObject)
$serverConnection.Connect()
$dacStore = New-Object Microsoft.SqlServer.Management.Dac.DacStore($serverConnection)
  
## Load the DAC package file.
$dacpacPath = "C:\MyDACs\MyApplication.dacpac"
$fileStream = [System.IO.File]::Open($dacpacPath,[System.IO.FileMode]::OpenOrCreate)
$dacType = [Microsoft.SqlServer.Management.Dac.DacType]::Load($fileStream)
  
## Subscribe to the DAC deployment events.
$dacStore.add_DacActionStarted({Write-Host `n`nStarting at $(Get-Date) :: $_.Description})
$dacStore.add_DacActionFinished({Write-Host Completed at $(Get-Date) :: $_.Description})
  
## Deploy the DAC and create the database.
$dacName  = "MyApplication"
$evaluateTSPolicy = $true
$deployProperties = New-Object Microsoft.SqlServer.Management.Dac.DatabaseDeploymentProperties($serverConnection,$dacName)
$dacStore.Install($dacType, $deployProperties, $evaluateTSPolicy)
$fileStream.Close()