SqlDacpacDeploymentOnMachineGroup@0 - SQL Server 데이터베이스 배포 v0 작업
이 작업을 사용하여 DACPAC 또는 SQL 스크립트를 사용하여 SQL Server 데이터베이스를 배포합니다.
Syntax
# 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 경로(예: \\BudgetIT\Web\Deploy\FabrikamDB.dacpac
)에서 DACPAC 파일의 위치를 지정합니다. UNC 경로는 컴퓨터의 관리자 계정에 액세스할 수 있어야 합니다. 환경 변수도 지원됩니다(예: $env:windir
, $env:systemroot
또는 $env:windir\FabrikamFibre\DB
). 와일드카드를 사용할 수 있습니다. 예를 들어 **/*.dacpac
모든 하위 폴더에 있는 DACPAC 파일의 경우입니다.
SqlFile
- Sql 파일
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
입니다.
앱 잠금 이름을 지정합니다.
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
입니다.
, localhost
또는 .\SQL2012R2
와 같은 machinename\FabriakmSQL,1433
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 인증 모드를 선택한 경우에만 사용할 수 있습니다.
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
인수를 지정합니다.
작업 제어 옵션
모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.
출력 변수
없음
요구 사항
요구 사항 | Description |
---|---|
파이프라인 유형 | 클래식 릴리스 |
실행 중 | 에이전트, DeploymentGroup |
요청 | 없음 |
Capabilities | 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다. |
명령 제한 사항 | 모두 |
Settable 변수 | 모두 |
에이전트 버전 | 1.102.0 이상 |
작업 범주 | 배포 |
요구 사항 | Description |
---|---|
파이프라인 유형 | 클래식 릴리스 |
실행 중 | DeploymentGroup |
요청 | 없음 |
Capabilities | 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다. |
명령 제한 사항 | 모두 |
Settable 변수 | 모두 |
에이전트 버전 | 1.102.0 이상 |
작업 범주 | 배포 |