次の方法で共有


SqlDacpacDeploymentOnMachineGroup@0 - データベース配置 v0 タスクSQL Server

このタスクを使用して、DACPAC または SQL スクリプトを使用してSQL Server データベースをデプロイします。

構文

# This task is supported on classic release pipelines only.
# Use the classic designer to add and configure this task in a classic release pipeline.
# See the following Inputs section for details on the inputs that this task supports.

入力

TaskType - を使用して SQL をデプロイする
string. 必須です。 使用できる値: dacpac (Sql Dacpac)、 sqlQuery (Sql クエリ ファイル)、 sqlInline (インライン Sql)。 既定値: dacpac

Dacpac または SQL スクリプトを使用して、データベースをデプロイする方法を指定します。


DacpacFile - DACPAC ファイル
string. の場合 TaskType = dacpacは必須です。

ターゲット コンピューターまたは UNC パス上の DACPAC ファイルの場所を指定します (例: \\BudgetIT\Web\Deploy\FabrikamDB.dacpac)。 UNC パスには、コンピューターの管理者アカウントからアクセスできる必要があります。 環境変数は、、 $env:windir\FabrikamFibre\DBなど$env:windir$env:systemrootでもサポートされています。 ワイルドカードを使用できます。 たとえば、 **/*.dacpac すべてのサブ フォルダーに存在する DACPAC ファイルの場合です。


SqlFile - Sql ファイル
string. の場合 TaskType = sqlQueryは必須です。

ターゲット上の SQL ファイルの場所を指定します。 複数のファイルを実行するために、セミコロンで区切られた SQL スクリプト ファイルの一覧を指定します。 SQL スクリプトは、指定された順序で実行されます。 場所には、 のような \\BudgetIT\Web\Deploy\FabrikamDB.sqlUNC パスを指定することもできます。 UNC パスには、コンピューターの管理者アカウントからアクセスできる必要があります。 環境変数は、、 $env:windir\FabrikamFibre\DBなど$env:windir$env:systemrootでもサポートされています。 ワイルドカードを使用できます。 たとえば、 **/*.sql すべてのサブ フォルダーに存在する SQL ファイルの場合です。


ExecuteInTransaction - トランザクション内で実行する
boolean. 任意。 の場合は TaskType = sqlQueryを使用します。 既定値: false

トランザクション内で SQL スクリプトを実行します。


ExclusiveLock - スクリプトの実行中に排他アプリ ロックを取得する
boolean. 省略可能。 の場合は ExecuteInTransaction = trueを使用します。 既定値: false

スクリプトの実行中に排他アプリ ロックを取得します。


AppLockName - アプリ ロック名
string. の場合 ExclusiveLock = trueは必須です。

アプリ ロック名を指定します。


InlineSql - インライン Sql
string. の場合 TaskType = sqlInlineは必須です。

SQL クエリをインラインで指定します。


TargetMethod - 使用して SQL を指定する
string. の場合 TaskType = dacpacは必須です。 使用できる値: serverconnectionString (接続文字列)、 publishProfile (発行プロファイル)。 既定値: server

ターゲット SQL Server データベースに接続するオプションを指定します。 SQL Serverデータベースの詳細、SQL Server接続文字列、または発行プロファイル XML ファイルを指定できます。


ServerName - サーバー名
string. の場合 TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInlineは必須です。 既定値: localhost

、 などのmachinename\FabriakmSQL,1433localhost.\SQL2012R2SQL Server名を指定します。 をlocalhost指定すると、マシン上の既定のSQL Server インスタンスに接続されます。


DatabaseName - データベース名
string. の場合 TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInlineは必須です。

SQL Server データベースの名前を指定します。


AuthScheme - 認証
string. の場合 TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInlineは必須です。 使用できる値: windowsAuthentication (Windows 認証)、 sqlServerAuthentication (SQL Server認証)。 既定値: windowsAuthentication

SQL Serverに接続するための認証モードを指定します。 Windows 認証 モードでは、デプロイ エージェントの構成に使用されるアカウントを使用して、SQL Serverに接続します。 SQL Server認証モードでは、次のパラメーターに SQL ログインとパスワードを指定する必要があります。


SqlUsername - SQL ユーザー名
string. の場合 AuthScheme = sqlServerAuthenticationは必須です。

SQL Serverに接続する SQL ログインを指定します。 このオプションは、SQL Server認証モードが選択されている場合にのみ使用できます。


SqlPassword - SQL パスワード
string. の場合 AuthScheme = sqlServerAuthenticationは必須です。

SQL ログインのパスワードを指定します。 このオプションは、SQL Server認証モードが選択されている場合にのみ使用できます。


ConnectionString - 接続文字列
string. の場合 TargetMethod = connectionStringは必須です。

などのServer=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;SQL Server接続文字列を指定します。


PublishProfile - プロファイルの発行
string. 省略可能。 の場合は TaskType = dacpacを使用します。

SQL Serverデータベースのデプロイをきめ細かく制御できます。
ターゲット コンピューターまたはコンピューター管理者の資格情報からアクセスできる UNC 共有上の発行プロファイル XML ファイルへのパスを指定します。


AdditionalArguments - その他の引数
string. 任意。 の場合は TaskType = dacpacを使用します。

/p:IgnoreComments=Trueなど/p:IgnoreAnsiNulls=True、SQL Server データベースをデプロイするときに適用される追加SqlPackage.exeの引数を指定します。 これらの引数は、発行プロファイル XML ファイルの設定をオーバーライドします (指定されている場合)。


AdditionalArgumentsSql - その他の引数
string. 任意。 の場合は TaskType = sqlQuery || TaskType = sqlInlineを使用します。

SQL Server データベースをデプロイするときに適用される追加Invoke-Sqlcmdの引数を指定します。


タスク コントロールのオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

必要条件

要件 説明
パイプラインの種類 クラシック リリース
実行日 エージェント、DeploymentGroup
確認要求 なし
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 1.102.0 以上
タスクのカテゴリ デプロイ
要件 説明
パイプラインの種類 クラシック リリース
実行日 DeploymentGroup
確認要求 なし
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 1.102.0 以上
タスクのカテゴリ 配置