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は必須です。 使用できる値: server、 connectionString (接続文字列)、 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 以上
タスクのカテゴリ	デプロイ