このタスクを使用して、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.
入力
を使用して SQL をデプロイする TaskType -
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、$env:systemroot、$env:windir\FabrikamFibre\DBなどの環境変数もサポートされています。 ワイルドカードを使用することができます。 たとえば、すべてのサブ フォルダーに存在する DACPAC ファイルの **/*.dacpac します。
sql ファイルの SqlFile -
string。
TaskType = sqlQueryする場合に必要です。
ターゲット上の SQL ファイルの場所を指定します。 複数のファイルを実行するために、セミコロンで区切られた SQL スクリプト ファイルの一覧を指定します。 SQL スクリプトは、指定された順序で実行されます。 場所には、\\BudgetIT\Web\Deploy\FabrikamDB.sqlなどの UNC パスを指定することもできます。 UNC パスには、コンピューターの管理者アカウントからアクセスできる必要があります。
$env:windir、$env:systemroot、$env:windir\FabrikamFibre\DBなどの環境変数もサポートされています。 ワイルドカードを使用することができます。 たとえば、すべてのサブ フォルダーに存在する SQL ファイルの **/*.sql。
トランザクション内で実行する ExecuteInTransaction -
boolean。 任意
TaskType = sqlQueryするときに使用します。 既定値: false.
トランザクション内で SQL スクリプトを実行します。
ExclusiveLock
-
スクリプトの実行中に排他アプリ ロックを取得
boolean。 任意
ExecuteInTransaction = trueするときに使用します。 既定値: false.
スクリプトの実行中に排他アプリ ロックを取得します。
AppLockName
-
アプリ ロック名の
string。
ExclusiveLock = trueする場合に必要です。
アプリ ロック名を指定します。
インライン Sqlの InlineSql -
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,1433、localhost、.\SQL2012R2など、SQL 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 認証モードが選択されている場合にのみ使用できます。
SQL パスワードの SqlPassword -
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するときに使用します。
SqlPackage.exe や /p:IgnoreAnsiNulls=Trueなど、SQL Server データベースのデプロイ時に適用される追加の /p:IgnoreComments=True 引数を指定します。 これらの引数は、発行プロファイル XML ファイルの設定 (指定されている場合) をオーバーライドします。
AdditionalArgumentsSql
-
追加の引数
string。 任意
TaskType = sqlQuery || TaskType = sqlInlineするときに使用します。
SQL Server データベースのデプロイ時に適用される追加の Invoke-Sqlcmd 引数を指定します。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。