データ層アプリケーションのアップグレードUpgrade a Data-tier Application

適用対象: ○SQL Server ○Azure SQL Database XAzure SQL Data Warehouse XParallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

データ層アプリケーションのアップグレード ウィザードまたは Windows PowerShell スクリプトを使用すると、現在配置されているデータ層アプリケーション (DAC) のスキーマとプロパティを、新しいバージョンの DAC で定義されているスキーマとプロパティに一致するように変更できます。Use either the Upgrade Data-tier Application Wizard or a Windows PowerShell script to change the schema and properties of a currently deployed data-tier application (DAC) to match the schema and properties defined in a new version of the DAC.

はじめにBefore You Begin

DAC アップグレードは、既存のデータベースのスキーマを新しい DAC バージョンで定義されているスキーマに一致するように変更するインプレース アップグレードです。A DAC upgrade is an in-place process that alters the schema of the existing database to match the schema defined in a new version of the DAC. 新しい DAC バージョンは、DAC パッケージ ファイルで提供されます。The new version of the DAC is supplied in a DAC package file. DAC パッケージの作成の詳細については、「 データ層アプリケーション」を参照してください。For more information about creating a DAC package, see Data-tier Applications.

DAC アップグレード オプションの選択Choosing DAC Upgrade Options

インプレース アップグレードには 4 つのアップグレード オプションがあります。There are four upgrade options for an in-place upgrade:

  • [データ損失を無視する] : True の場合、一部の操作によってデータが失われても、アップグレードは続行されます。Ignore Data Loss - If True, the upgrade will proceed even if some of the operations result in the loss of data. Falseの場合、これらの操作によってアップグレードは終了します。If False, these operations will terminate the upgrade. たとえば、現在のデータベースにあるテーブルが新しい DAC のスキーマにない場合は、 True が指定されていると、テーブルは削除されます。For example, if a table in the current database is not present in the schema of the new DAC, the table will be dropped if True is specified. 既定値の設定は Trueです。The default setting is True.

  • [変更時にブロック] : True の場合、データベース スキーマが前の DAC で定義したものと異なっていると、アップグレードは終了します。Block on Changes - If True, the upgrade is terminated if the database schema is different than that defined in the previous DAC. Falseの場合、変更が検出されても、アップグレードは続行されます。If False, the upgrade continues even if changes are detected. 既定の設定は Falseです。The default setting is False.

  • [失敗時にロールバック] : True の場合、アップグレードはトランザクションに含まれ、エラーが発生すると、ロールバックが試行されます。Rollback on Failure - If True, the upgrade is enclosed in a transaction, and if errors are encountered a rollback will be attempted. Falseの場合、すべての変更が実行時にコミットされます。エラーが発生する場合は、データベースの前のバックアップの復元が必要になる場合があります。If False, all changes are committed as they are made and if errors occur you may have to restore a previous backup of the database. 既定の設定は Falseです。The default setting is False.

  • [ポリシーの検証をスキップ] : True の場合、DAC サーバー選択ポリシーは評価されません。Skip Policy Validation - If True, the DAC server selection policy is not evaluated. Falseの場合は、ポリシーが評価され、検証エラーがあるとアップグレードは終了します。If False, the policy is evaluated and the upgrade terminates if there is a validation error. 既定の設定は Falseです。The default setting is False.

制限事項と制約事項Limitations and Restrictions

DAC アップグレードは、 SQL DatabaseSQL Databaseまたは SQL Server 2005 (9.x)SQL Server 2005 (9.x) Service Pack 4 (SP4) 以降でのみ実行できます。DAC uprades can only be performed in SQL DatabaseSQL Database, or SQL Server 2005 (9.x)SQL Server 2005 (9.x) Service Pack 4 (SP4) or later.

前提条件Prerequisites

アップグレードを開始する前に、データベースの完全バックアップを実行することをお勧めします。It is prudent to take a full database backup before starting the upgrade. アップグレード時にエラーが発生し、すべての変更をロールバックできない場合は、バックアップの復元が必要になる場合があります。If an upgrade encounters an error and cannot roll back all of its changes, you may need to restore the backup.

アップグレードを開始する前に、DAC パッケージとアップグレード処理を検証するには、いくつかの操作を行う必要があります。Before starting the upgrade, there are several actions that you should take to validate the DAC package and the upgrade actions. これらのチェックの実行方法の詳細については、「 Validate a DAC Package」をご覧ください。For more information about how to perform these checks, see Validate a DAC Package.

  • アップグレード時には、ソースが不明または信頼されていない DAC パッケージは使用しないことをお勧めします。We recommend that you do not upgrade by using a DAC package from unknown or untrusted sources. こうしたパッケージには、意図しない Transact-SQL コードを実行したり、スキーマを変更してエラーを発生したりする、悪意のあるコードが含まれている可能性があります。Such packages could contain malicious code that might execute unintended Transact-SQL code or cause errors by modifying the schema. パッケージのソースが不明または信頼されていない場合は、使用する前に、DAC をアンパックして、ストアド プロシージャやその他のユーザー定義コードなどのコードもご確認ください。Before you use a package from an unknown or untrusted source, unpack the DAC and examine the code, such as stored procedures or other user-defined code.

  • 最新バージョンの DAC が配置された後に現在のデータベースに変更が加えられている場合は、一部の変更によってアップグレードが正常に完了しなかったり、アップグレードによって一部の変更が削除されたりすることがあります。If changes have been made to the current database after the last version of the DAC was deployed, some of the changes may prevent the successful completion of the upgrade, or be removed by the upgrade. まず、データベースで行った変更内容のレポートを生成して、確認してください。You should first generate and review a report of any such changes made in the database.

  • アップグレードによって実行されるスキーマの変更内容のリストを生成し、問題がないかどうかを確認してください。It is prudent to generate a list of the schema changes the upgrade will perform, and review the list for any problems.

DAC パッケージ内のアプリケーション名は、現在配置されている DAC のアプリケーション名と一致している必要があります。The application name in the DAC package must match the application name of the currently deployed DAC. たとえば、現在の DAC のアプリケーション名が GeneralLedgerの場合、アップグレードできるのは、アプリケーション名が GeneralLedgerの DAC パッケージを使用する場合だけです。For example, if the current DAC has an application name of GeneralLedger, you can only upgrade by using a DAC package that also has an application name of GeneralLedger.

すべての変更をログ記録するための十分なトランザクション ログ領域があることを確認します。Ensure there is enough transaction log space available to log all of the modifications.

セキュリティSecurity

セキュリティを強化するために、SQL Server 認証のログインは、パスワードなしで DAC パッケージに格納されます。To improve security, SQL Server Authentication logins are stored in a DAC package without a password. パッケージが配置またはアップグレードされると、ログインは、生成されたパスワードを伴う無効なログインとして作成されます。When the package is deployed or upgraded, the login is created as a disabled login with a generated password. ログインを有効にするには、ALTER ANY LOGIN 権限を持つユーザーとしてログインし、ALTER LOGIN を使用してログインを有効にします。さらに、新しいパスワードを割り当て、そのパスワードを該当ユーザーに通知します。To enable the logins, log in using a login that has ALTER ANY LOGIN permission and use ALTER LOGIN to enable the login and assign a new password that can be communicated to the user. Windows 認証ログインの場合、ログインのパスワードは SQL Server で管理されていないため、この操作は必要ありません。This is not needed for Windows Authentication logins because their passwords are not managed by SQL Server.

PermissionsPermissions

DAC をアップグレードできるのは、 sysadmin または serveradmin 固定サーバー ロールのメンバーか、 dbcreator 固定サーバー ロールに存在する ALTER ANY LOGIN 権限を持つログインのみです。A DAC can only be upgraded by members of the sysadmin or serveradmin fixed server roles, or by logins that are in the dbcreator fixed server role and have ALTER ANY LOGIN permissions. ログインは既存のデータベースの所有者である必要があります。The login must be the owner of the existing database. あらかじめ登録された SQL ServerSQL Server システム管理者アカウント ( sa ) も DAC をアップグレードできます。The built-in SQL ServerSQL Server system administrator account named sa can also upgrade a DAC.

データ層アプリケーションのアップグレード ウィザードの使用Using the Upgrade Data-tier Application Wizard

ウィザードを使用して、DAC をアップグレードするにはTo Upgrade a DAC Using a Wizard

  1. オブジェクト エクスプローラーで、アップグレードする DAC を含んだインスタンスのノードを展開します。In Object Explorer, expand the node for the instance containing the DAC to be upgraded.

  2. [管理] ノードを展開し、 [データ層のアプリケーション] ノードを展開します。Expand the Management node, and then expand the Data-tier Applications node.

  3. アップグレードする DAC のノードを右クリックしてから、 [データ層アプリケーションのアップグレード] を選択します。Right-click the node for the DAC to be upgraded, and then select Upgrade Data-tier Application...

  4. ウィザードの各ダイアログの手順を実行します。Complete the wizard dialogs:

    1. [説明] ページIntroduction Page

    2. [パッケージの選択] ページSelect Package Page

    3. [ポリシーの確認] ページReview Policy Page

    4. [変更の検出] ページDetect Change Page

    5. [アップグレード計画の確認]Review the Upgrade Plan

    6. [概要] ページSummary Page

    7. [DAC のアップグレード] ページUpgrade DAC Page

[説明] ページIntroduction Page

このページでは、データ層アプリケーションをアップグレードする手順について説明します。This page describes the steps for upgrading a data-tier application.

[次回からこのページを表示しない]Do not show this page again. : 今後このページを表示しないようにするには、このチェック ボックスをオンにします。- Click the check box to stop the page from being displayed in the future.

[次へ] : [パッケージの選択] ページに進みます。Next > - Proceeds to the Select Package page.

[キャンセル] : DAC をアップグレードせずにウィザードを終了します。Cancel - Terminates the wizard without upgrading the DAC.

[パッケージの選択] ページSelect Package Page

このページでは、新しいバージョンのデータ層アプリケーションを含む DAC パッケージを指定します。Use this page to specify the DAC package that contains the new version of the data-tier application. このページは、2 つの状態を遷移します。The page transitions through two states.

DAC パッケージの選択Select the DAC Package

ページの初期状態では、配置する DAC パッケージを選択します。Use the initial state of the page to choose the DAC package to deploy. DAC パッケージは有効な DAC パッケージ ファイルで、拡張子は .dacpac である必要があります。The DAC package must be a valid DAC package file and must have a .dacpac extension. DAC パッケージ内の DAC アプリケーション名は、現在の DAC のアプリケーション名と同じである必要があります。The DAC application name in the DAC package must be the same as the application name of the current DAC.

[DAC パッケージ] : 新しいバージョンのデータ層アプリケーションを含む DAC パッケージのパスとファイル名を指定します。DAC Package - Specify the path and file name of the DAC package that contains the new version of the data-tier application. ボックスの右にある [参照] をクリックして、DAC パッケージの場所に移動することができます。You can select the Browse button at the right of the box to browse to the location of the DAC package.

[アプリケーション名] : DAC が作成されたとき、またはデータベースから抽出されたときに割り当てられた DAC アプリケーション名が表示される読み取り専用のボックスです。Application Name - A read-only box that displays the DAC application name assigned when the DAC was authored or extracted from a database.

[バージョン] : DAC が作成されたとき、またはデータベースから抽出されたときに割り当てられたバージョンが表示される読み取り専用のボックスです。Version - A read-only box that displays the version assigned when the DAC was authored or extracted from a database.

[説明] : DAC が作成されたとき、またはデータベースから抽出されたときに記述された説明が表示される読み取り専用のボックスです。Description - A read-only box that displays the description written when the DAC was authored or extracted from a database.

[戻る] : [説明] ページに戻ります。< Previous - Returns to the Introduction page.

[次へ] : 選択したファイルが有効な DAC パッケージかどうかが確認され、進捗状況バーが表示されます。Next > - Displays a progress bar as the wizard confirms that the selected file is a valid DAC package.

[キャンセル] : DAC をアップグレードせずにウィザードを終了します。Cancel - Terminates the wizard without upgrading the DAC.

DAC パッケージの検証Validating the DAC Package

選択したファイルが有効な DAC パッケージかどうかが確認され、進捗状況バーが表示されます。Displays a progress bar as the wizard confirms that the selected file is a valid DAC package. DAC パッケージが検証されると、ウィザードは [ポリシーの確認] ページに進みます。If the DAC package is validated, the wizard proceeds to the Review Policy page. ファイルが有効な DAC パッケージでない場合は、 [DAC パッケージの選択] ページが表示されたままになります。If the file is not a valid DAC package, the wizard remains on the Select DAC Package page. 別の有効な DAC パッケージを選択するか、ウィザードを取り消して新しい DAC パッケージを生成してください。Either select another valid DAC package or cancel the wizard and generate a new DAC package.

[DAC パッケージの内容を検証しています] : 検証プロセスの現在の状態を示す進捗状況バーです。Validating the contents of the DAC - The progress bar that reports the current status of the validation process.

[戻る] : [パッケージの選択] ページの初期状態に戻ります。< Previous - Returns to the initial state of the Select Package page.

[次へ >] : [パッケージの選択] ページの最終状態に進みます。Next > - Proceeds to the final version of the Select Package page.

[キャンセル] : DAC を配置せずにウィザードを終了します。Cancel - Terminates the wizard without deploying the DAC.

[ポリシーの確認] ページReview Policy Page

このページでは、DAC にポリシーが含まれている場合に DAC サーバーの選択ポリシーを評価した結果を確認します。Use this page to review the results of evaluating the DAC server selection policy, if the DAC has a policy. DAC サーバーの選択ポリシーは、省略可能で、Microsoft Visual Studio で作成された DAC に割り当てられます。The DAC server selection policy is optional, and is assigned to a DAC authored in Microsoft Visual Studio. このポリシーでは、サーバーの選択ポリシーのファセットを使用して、 データベース エンジンDatabase Engine のインスタンスで DAC をホストするために満たす必要がある条件を指定します。The policy uses the server selection policy facets to specify conditions an instance of the データベース エンジンDatabase Engine should meet to host the DAC.

[ポリシー条件の評価結果] : DAC サーバーの選択ポリシーの条件の評価に成功したかどうかを示す読み取り専用のレポートです。Evaluation results of policy conditions - A read-only report showing whether the evaluations of the conditions in the DAC server selection policy succeeded. 各条件の評価結果が、レポートの各行に表示されます。The results of evaluating each condition are reported on a separate line.

[ポリシー違反を無視します] : ポリシー条件が満たされていない場合にアップグレードを続行するには、このチェック ボックスを使用します。Ignore policy violations - Use this check box to proceed with the upgrade if one or more of the policy conditions failed. すべての条件が満たされていなくても DAC を正常に操作できるようにする場合のみ、このチェック ボックスをオンにしてください。Only select this option if you are sure that all of the conditions which failed will not prevent the successful operation of the DAC.

[戻る] : [パッケージの選択] ページに戻ります。< Previous - Returns to the Select Package page.

[次へ] : [変更の検出] ページに進みます。Next > - Proceeds to the Detect Change page.

[キャンセル] : DAC をアップグレードせずにウィザードを終了します。Cancel - Terminates the wizard without upgrading the DAC.

[変更の検出] ページDetect Change Page

このページでは、 msdb内の DAC メタデータに格納されているスキーマ定義とは異なるスキーマを作成する、データベースへの変更についてウィザードで確認した結果がレポートされます。Use this page reports the results of the wizards check for changes made to the database that make it's schema different than the schema definition stored in the DAC metadata in msdb. たとえば、最初に DAC が配置された後に、CREATE、ALTER または DROP ステートメントを使用してデータベースでオブジェクトを追加、変更、または削除した場合です。For example, if CREATE, ALTER, or DROP statements have been used to add, change, or remove objects from the database after the DAC was originally deployed. このページでは、まず進捗状況バーが表示されてから、分析結果が表示されます。The page first displays a progress bar, and then reports the results of the analysis.

[変更を検出しています。これには、数分間かかることがあります] : ウィザードでデータベースの現在のスキーマと DAC 定義のオブジェクトの間で相違点がチェックされるときに、進捗状況バーが表示されます。Detecting change, this may take a few minutes - Displays a progress bar as the wizard checks for differences between the current schema of the database and the objects in the DAC definition.

[変更の検出結果] : 分析が完了したことを示し、結果が下に表示されます。Change detection results: - Indicates that the analysis has completed and the results are reported below.

[データベース <DatabaseName> は変更されていません] : ウィザードで、データベースで定義されているオブジェクトと DAC 定義の対応するオブジェクトの間で相違点が検出されませんでした。The database DatabaseName has not changed - The wizard detected no differences in the objects defined in the database and their counterparts in the DAC definition.

[データベース <DatabaseName> が変更されました] : ウィザードで、データベースのオブジェクトと DAC 定義の対応するオブジェクトの間で変更点が検出されました。The database DatabaseName has changed - The wizard detected changes between the objects in the database and their counterparts in the DAC definition.

[変更が失われる可能性がありますが続行します] : 現在のデータベース内のオブジェクトやデータの一部が新しいデータベースに存在しない場合があることがわかっていて、アップグレードを続行することを指定します。Proceed despite possible loss of changes - Specifies that you understand some of the objects or data in the current database will not be present in the new database, and that you are willing to proceed with the upgrade. このボタンは、変更レポートの分析が完了し、新しいデータベースで必要なオブジェクトやデータを手動で転送するための手順がわかっている場合にのみクリックしてください。You should select this button only if you have analyzed the change report and understand the steps you must perform to manually transfer any objects or data required in the new database. わからない場合は、 [レポートの保存] をクリックして変更レポートを保存し、 [キャンセル] をクリックします。If you are not sure, click the Save Report button to save the change report, then click Cancel. レポートを分析して、アップグレードの完了後に必要なオブジェクトやデータを転送する方法を計画し、ウィザードを再起動します。Analyze the report, plan how to transfer any required objects and data after the upgrade completes, then restart the wizard.

[レポートの保存] : ウィザードで検出された、データベースのオブジェクトと DAC 定義の対応するオブジェクトの間の変更点のレポートを保存する場合に、このボタンをクリックします。Save Report - Click the button to save a report of the changes the wizard detected between the objects in the database and their counterparts in the DAC definition. その後、レポートを確認し、アップグレードの完了後に、レポートに表示されたオブジェクトの一部またはすべてを新しいデータベースに組み込む操作を行う必要があるかどうかを判断できます。You can then review the report to determine if you need to take actions after the upgrade completes to incorporate some or all of the objects listed in the report into the new database.

[戻る] : [DAC パッケージの選択] ページに戻ります。< Previous - Returns to the Select DAC Package page.

[次へ] : [オプション] ページに進みます。Next > - Proceeds to the Options page.

[キャンセル] : DAC を配置せずにウィザードを終了します。Cancel - Terminates the wizard without deploying the DAC.

[オプション] ページ)Options Page

このページを使用すると、アップグレードの失敗時のロールバック オプションを選択できます。Use this page to select the rollback on failure option for the upgrade.

[失敗時にロールバック] : このオプションを選択すると、アップグレードはトランザクションに含まれ、エラーが発生した場合はウィザードからロールバックを試行できます。Rollback on failure - Select this option to enclose the upgrade in a transaction which the wizard can attempt to roll back if errors occur. オプションの詳細については、「 DAC アップグレード オプションの選択」を参照してください。For more information about the option, see Choosing DAC Upgrade Options.

[既定値に戻す] : オプションを既定値の false に戻します。Restore Defaults - Returns the option to its default setting of false.

[戻る] : [変更の検出] ページに戻ります。< Previous - Returns to the Detect Change page.

[次へ] : [アップグレード計画の確認] ページに進みます。Next > - Proceeds to the Review the Upgrade Plan page.

[キャンセル] : DAC を配置せずにウィザードを終了します。Cancel - Terminates the wizard without deploying the DAC.

[アップグレード計画の確認] ページReview the Upgrade Plan Page

このページでは、アップグレード プロセスで実行されるアクションを確認します。Use this page to do review the actions that will be taken by the upgrade process. アップグレードによって問題が発生しないことが確実である場合にのみ、アップグレードを続行してください。Only proceed when you are confident the upgrade will not create problems.

[次のアクションを使用して DAC をアップグレードします。]The following actions will be used to upgrade the DAC. : 表示された情報を確認し、実行されるアクションが正しいかどうかを確認します。- Review the information displayed to ensure the actions taken will be correct. [アクション] 列には、アップグレードを行うために実行される Transact-SQL ステートメントなどのアクションが表示されます。The Action column displays the actions, such as Transact-SQL statements, that will be run to perform the upgrade. [データ損失] 列には、関連付けられたアクションによってデータが削除される可能性がある場合に、警告が表示されます。The Data Loss column will contain a warning if the associated action could delete data.

[更新] : アクション リストを更新します。Refresh - refreshes the action list.

[アクション レポートの保存] : アクション ウィンドウの内容を HTML ファイルに保存します。Save Action Report - saves the contents of the action window to an HTML file.

[変更が失われる可能性がありますが続行します] : 現在のデータベース内のオブジェクトやデータの一部が新しいデータベースに存在しない場合があることがわかっていて、アップグレードを続行することを指定します。Proceed despite possible loss of changes - Specifies that you understand some of the objects or data in the current database will not be present in the new database, and that you are willing to proceed with the upgrade. このボタンは、変更レポートの分析が完了し、新しいデータベースで必要なオブジェクトやデータを手動で転送するための手順がわかっている場合にのみクリックしてください。You should select this button only if you have analyzed the change report and understand the steps you must perform to manually transfer any objects or data required in the new database. わからない場合は、 [アクション レポートの保存] をクリックして変更レポートを保存し、 [スクリプトの保存] をクリックして Transact-SQL スクリプトを保存してから、 [キャンセル] をクリックします。If you are not sure, click the Save Action Report button to save the change report and the Save Scripts button to save the Transact-SQL script, then click Cancel. レポートとスクリプトを分析して、アップグレードの完了後に必要なオブジェクトやデータを転送する方法を計画し、ウィザードを再起動します。Analyze the report and script, and then plan how to transfer any required objects and data after the upgrade completes, then restart the wizard.

[スクリプトの保存] : アップグレードを実行するために使用される Transact-SQL ステートメントをテキスト ファイルに保存します。Save Scripts - saves the Transact-SQL statements that will be used to perform the upgrade to a text file.

[既定値に戻す] : オプションを既定値の false に戻します。Restore Defaults - Returns the option to its default setting of false.

[戻る] : [変更の検出] ページに戻ります。< Previous - Returns to the Detect Change page.

[次へ] : [概要] ページに進みます。Next > - Proceeds to the Summary page.

[キャンセル] : DAC を配置せずにウィザードを終了します。Cancel - Terminates the wizard without deploying the DAC.

[概要] ページSummary Page

このページでは、DAC のアップグレード時にウィザードが行うアクションを最終的に確認します。Use this page to do a final review of the actions the wizard will take when upgrading the DAC.

[次の設定を使用して DAC をアップグレードします。]The following settings will be used to upgrade your DAC. : 表示された情報を確認し、実行されるアクションが正しいかどうかを確認します。- Review the information displayed to ensure the actions taken will be correct. このウィンドウには、アップグレード対象として選択した DAC と、新しいバージョンの DAC が含まれている DAC パッケージが表示されます。The window displays the DAC you selected to be upgraded, and the DAC package containing the new version of the DAC. また、現在のバージョンのデータベースが現在の DAC 定義と同じかどうか、またはデータベースが変更されているかどうかも表示されます。The window also displays whether the current version of the database is the same as the current DAC definition, or if the database has changed.

[戻る] : [アップグレード計画の確認] ページに戻ります。< Previous - Returns you to the Review the Upgrade Plan page.

[次へ] : DAC を配置し、 [DAC のアップグレード] ページに結果を表示します。Next > - Deploys the DAC and displays the results in the Upgrade DAC page.

[キャンセル] : DAC を配置せずにウィザードを終了します。Cancel - Terminates the wizard without deploying the DAC.

[DAC のアップグレード] ページUpgrade DAC Page

このページには、アップグレード操作の成功または失敗が表示されます。This page reports the success or failure of the upgrade operation.

[DAC をアップグレードしています] : DAC をアップグレードするために行った各アクションの成功または失敗が表示されます。Upgrading the DAC - Reports the success or failure of each action taken to upgrade the DAC. 内容を確認して、各アクションの成功または失敗を判断します。Review the information to determine the success or failure of each action. エラーが発生したアクションには、 [結果] 列にリンクが表示されます。Any action that encountered an error will have a link in the Result column. そのアクションのエラーのレポートを表示するには、リンクをクリックします。Select the link to view a report of the error for that action.

[レポートの保存] : アップグレード レポートを HTML ファイルに保存します。Save Report - Select this button to save the upgrade report to an HTML file. ファイルには、アクションで発生したすべてのエラーを含む、各アクションのステータスが報告されます。The file reports the status of each action, including all errors generated by any of the actions. 既定のフォルダーは、Windows アカウントの Documents フォルダーにある SQL Server Management Studio\DAC Packages フォルダーです。The default folder is a SQL Server Management Studio\DAC Packages folder in the Documents folder of your Windows account.

[完了] : ウィザードを終了します。Finish - Terminates the wizard.

PowerShell の使用Using PowerShell

PowerShell スクリプトから IncrementalUpgrade() メソッドを使用して DAC をアップグレードするにはTo upgrade a DAC using the IncrementalUpgrade() method in a PowerShell script

  1. SMO サーバー オブジェクトを作成し、アップグレードする DAC が含まれたインスタンスにそれを設定します。Create a SMO Server object and set it to the instance that contains the DAC to be upgraded.

  2. ServerConnection オブジェクトを開いて、同じインスタンスに接続します。Open a ServerConnection object and connect to the same instance.

  3. System.IO.File を使用して、DAC パッケージ ファイルを読み込みます。Use System.IO.File to load the DAC package file.

  4. add_DacActionStartedadd_DacActionFinished を使用して、DAC アップグレード イベントをサブスクライブします。Use add_DacActionStarted and add_DacActionFinished to subscribe to the DAC upgrade events.

  5. DacUpgradeOptionsを設定します。Set the DacUpgradeOptions.

  6. IncrementalUpgrade メソッドを使用して DAC をアップグレードします。Use the IncrementalUpgrade method to upgrade the DAC.

  7. DAC パッケージ ファイルの読み取りに使用するファイル ストリームを閉じます。Close the file stream used to read the DAC package file.

例 (PowerShell)Example (PowerShell)

次の例では、MyApplication2017.dacpac パッケージで新しい DAC バージョンを使用して、データベース エンジンDatabase Engine の既定のインスタンスの MyApplication という名前の DAC をアップグレードします。The following example upgrades a DAC named MyApplication on a default instance of the データベース エンジンDatabase Engine, using a new DAC version in a MyApplication2017.dacpac package.

## Set a SMO Server object to the default instance on the local computer.  
CD SQLSERVER:\SQL\localhost\DEFAULT  
$srv = get-item .  
  
## Open a Common.ServerConnection to the same instance.  
$serverconnection = New-Object Microsoft.SqlServer.Management.Common.ServerConnection($srv.ConnectionContext.SqlConnectionObject)  
$serverconnection.Connect()  
$dacstore = New-Object Microsoft.SqlServer.Management.Dac.DacStore($serverconnection)  
  
## Load the DAC package file.  
$dacpacPath = "C:\MyDACs\MyApplication2017.dacpac"  
$fileStream = [System.IO.File]::Open($dacpacPath,[System.IO.FileMode]::OpenOrCreate)  
$dacType = [Microsoft.SqlServer.Management.Dac.DacType]::Load($fileStream)  
  
## Subscribe to the DAC upgrade events.  
$dacstore.add_DacActionStarted({Write-Host `n`nStarting at $(get-date) :: $_.Description})  
$dacstore.add_DacActionFinished({Write-Host Completed at $(get-date) :: $_.Description})  
  
## Upgrade the DAC and close the package.  
$dacName  = "MyApplication"  
  
## Set the upgrade options.  
$upgradeProperties = New-Object Microsoft.SqlServer.Management.Dac.DacUpgradeOptions  
$upgradeProperties.blockonchanges = $true  
$upgradeProperties.ignoredataloss = $false  
$upgradeProperties.rollbackonfailure = $true  
$ upgradeProperties.skippolicyvalidation = $false  
  
## Upgrade the DAC  
$dacstore.IncrementalUpgrade($dacName, $dacType, $upgradeProperties)  
## Close the package file.  
$fileStream.Close()  

参照See Also

[データ層アプリケーション] Data-tier Applications
SQL Server PowerShellSQL Server PowerShell