プロジェクト プロパティの [パッケージ/SQL の発行] タブ

プロパティ のページの SQL のパッケージ化/発行 のタブでは、SQL Server データベースの配置設定を指定するためのレガシ メソッドです。

ここでは、次の製品に適用されます:

SQL のパッケージ化/発行 のタブのデータベースの公開を構成するときに、データベースの初期配置のみが、および自動化するカスタム SQL スクリプトを作成して、データベースの更新の増分配置を手動で構成する必要があります。 発行プロファイルのデータベースの配置を構成する場合、インクリメンタル データベースの更新、初期のデータベースの配置が自動化されます。 詳細については、「Visual Studio および ASP.NET の Web アプリケーション プロジェクトの配置の概要」を参照してください。

SQL のパッケージ化/発行 のタブでは、レガシ プロジェクトで既に構成されているか、または発行プロファイルのデータベースの配置を設定できない場合に使用します。 たとえば、Windows XP を使用するか、または Windows Server 2003 と、アプリケーションが Entity Framework の Code First の移行を使用する、発行プロファイルの Database Publishing は構成できません。 このシナリオでは、SQL のパッケージ化/発行 のタブを使用します。

SQL のパッケージ化/発行 のタブに構成されているデータベースの配置設定されているプロジェクトに発行プロファイルを作成するとき Web の発行 ウィザードは警告メッセージを表示します。

Publish_Web_Settings_tab_with_Package_Publish_

SQL のパッケージ化/発行 のタブの設定を使用する場合は、**新しいデータベースの発行設定のアップグレードを有効にします。**をクリックしないでください。 **新しいデータベースの発行設定のアップグレードを有効にします。**をクリックすると、発行プロファイルの設定が優先され、SQL のパッケージ化/発行 の設定は無視されます。 新しいデータベースの発行設定のアップグレードを有効にします。 をクリックし、SQL のパッケージ化/発行 の設定を使用する場合は、その判断した場合 (新しいプロファイルを作成する必要があります)。

プロパティ ページのこのタブにアクセスするには

  1. Visual Studio で Web アプリケーション プロジェクトを開きます。

  2. ソリューション エクスプローラーでプロジェクト名を右クリックし、[プロパティ] (C#) または [MyProject] (Visual Basic) を選択して [プロパティ] ページを表示します。

  3. [SQL のパッケージ化/発行] タブをクリックします。

    プロジェクト プロパティの [SQL のパッケージ化/発行] タブ

    Web の発行 ウィザードをインストールして、プロジェクトの設定が SQL のパッケージ化/発行 のタブで、書き入れられなかったら、このタブの通常の UI は警告をこのタブは、新しい開発に使用することがないように置き換えられます。 SQL のパッケージ化/発行 のタブのデータベースの配置を構成する必要がある場合は、図に表示される UI を表示します このページを有効にします。

UI 要素

  • 構成
    このタブの設定を適用する構成の種類を指定します。 たとえば、デバッグ構成 (デバッグ) のパッケージ設定には、運用構成 (リリース) の設定とは異なる内容を指定できます。 構成の種類を選択する場合、指定した設定は構成の種類と共に保存されます。 すべての構成に同じ設定を使用する場合は、[すべての構成] を選択します。 [ビルド] メニューの [構成マネージャー] を選択して、カスタムの構成の種類を作成できます。

  • プラットフォーム
    設定を適用するオペレーティング システムの種類を指定します。

  • [データベース エントリ]
    配置するデータベースのリストを指定します。 このセクションのグリッドには、配置する各データベースのエントリを 1 つ含めます。 [データベース エントリの詳細] セクションでは、選択したデータベースの設定を指定します。

  • データベース エントリ テーブルの [配置]
    選択したデータベースを配置するかどうかを指定します。 これは、Web プロジェクトを初めて配置するときだけデータベースを配置するときに使うと便利です。 この場合、アプリケーションを初めて配置した後にこのチェック ボックスをオフにすると、同じプロジェクトを再配置するときにデータベースは含まれなくなります。

  • データベース エントリ テーブルの [名前]
    配置するデータベースを識別する名前を指定します。 データベースが Web.config ファイルに格納されている接続文字列で表されている場合、通常、この値は、"-Deployment" または "-Web.config" などのサフィックスの付いた接続文字列の名前になります。

    サフィックス "-Web.config" (たとえば、"ConnectionStringName-Web.config" など) は、配置には Web.config ファイル内の接続文字列値を使用する必要があることを指定します。 詳細については、このドキュメントで後述する「対象データベースの接続文字列」を参照してください。

  • 上向き/下向きの矢印ボタン
    データベースを配置する順序を指定できます。

  • [Web.config からのインポート]
    Web.config ファイルで接続文字列を見つけ、"-Deployment" を付加して [データベース エントリ] グリッドに名前を入力します。

    Web.config ファイルの接続文字列値を配置に使用する必要があることを指定する場合、"-Deployment" サフィックスを "-Web.config" に変更できます (たとえば、"ConnectionStringName-Deployment" を "ConnectionStringName-Web.config" に変更します)。 詳細については、このドキュメントで後述する「対象データベースの接続文字列」を参照してください。

  • [追加]
    [データベース エントリ] グリッドに行を追加します。

  • [削除]
    [データベース エントリ] グリッドから行を削除します。

  • [対象データベースの接続文字列]
    配置を行うときに対象データベースへの接続に使用する接続文字列を指定します。

    この接続文字列は、配置を行う場合にのみ使用されます。配置した Web アプリケーションの Web.config ファイルでは使用されません。ただし、次の例外があります。 サフィックス「前にある名前の一部は、Web.config の接続文字列」存在する場合は終了このデータベースの 名前 の値はアプリケーションの Web.config ファイルの接続文字列名として「、次の規則が適用され、次の接続文字列- Web.config」 (たとえば、「ConnectionStringName-Web.config 接続文字列」) :

    • このフィールドを空白のままにしておくと、Web.config ファイルの接続文字列値が配置に使用されます。 接続文字列の変換を指定すると、変換された接続文字列が配置に使用されます。

    • このフィールドに値を入力すると、入力した値が配置に使用され、対象の Web.config ファイルが更新されてこの値が反映されます。

      注意

      「でデータベース名を指定した場合の接続文字列- Web.config」と、同じ接続文字列の変換を、変換は使用されません。このフィールドに入力した値は、対象の Web.config ファイルで使用されます。

  • [既存のデータベースからのデータおよびスキーマの取得]
    配置プロセスで、ソース データベースにソース データベース スキーマを再作成する (さらにオプションでデータを再作成する) コマンドを含むスクリプト (.sql ファイル) を生成するかどうかを指定します。

  • [ソース データベースへの接続文字列]
    ソース データベースに使用する接続文字列を指定します。

  • [データベース スクリプト オプション]
    対象データベースに、データベース スキーマのみを配置するか、データのみを配置するか、またはスキーマとデータの両方を配置するかを指定します。

    スキーマを配置するために生成されるスクリプトには、完全なデータベース スキーマが格納されます。 初期配置後に行われたスキーマの変更のみを反映するスクリプトを自動的に生成するオプションはありません。 これは、データにも当てはまります。 データを配置するために生成されるスクリプトには、データベース内のすべてのデータが格納されます。 初期配置後に行われたデータの変更のみを反映するスクリプトを自動的に生成するオプションはありません。

    既定では、配置のときに実行されるスクリプトは、トランザクションで実行されます。

  • [データベース スクリプト] テーブル
    配置プロセスの一部として対象データベースで実行するスクリプトを指定します。

    既定では、ここで追加するカスタム スクリプトは、トランザクションで自動的に実行されることはありません。 トランザクションで実行する場合は、スクリプト自体でそれを指定します。 スクリプトの Transacted の属性を設定する方法の詳細については、" "を参照してください。方法: プロジェクト ファイルの編集の配置設定

  • データベース スクリプト テーブルの [インクルード]
    [スクリプト パス] 列に指定されているスクリプトを、Web プロジェクトを配置するときに実行するかどうかを指定します。 これは、プロジェクトを初めて配置するときだけ一部のスクリプトを実行するときに使うと便利です。

  • データベース スクリプト テーブルの [スクリプト パス]
    スキーマの変更やデータを配置するため、対象データベースで実行する必要のあるスクリプトのパスを指定します (自動生成されるスクリプトの場合、スクリプトのパスはありません。 代わりに、スクリプトの説明が表示されます)。

  • 上向き/下向きの矢印ボタン
    配置で実行するスクリプトの順序を指定できます。

  • [スクリプトの追加]
    カスタム スクリプトを追加できます。 SQL スクリプトと SqlCmd スクリプトの両方がサポートされます。 カスタム スクリプトは SqlCmd 変数のスキャン対象であり、これらは IIS Web 配置ツール のインストール時のパラメーターに自動的に変換されます。 SqlCmd スクリプトの詳細については、「sqlcmd ユーティリティ」を参照してください。

  • [スクリプトの削除]
    スクリプトを削除できます。

  • [データベースの配置メモ]
    ここには、配置に関するメモを自由に入力できます。 ここに入力するテキストは、自動的に実行される関数では使用されません。

参照

概念

Visual Studio および ASP.NET の Web 配置コンテンツ マップ