다음을 통해 공유


SqlDacpacDeploymentOnMachineGroup@0 - SQL Server 데이터베이스 v0 배포 작업

이 작업을 사용하여 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 스크립트를 사용하여 데이터베이스를 배포하려는 방법을 지정합니다.


DACPAC 파일DacpacFile -
string; TaskType = dacpac때 필요합니다.

대상 컴퓨터 또는 UNC 경로(예: \\BudgetIT\Web\Deploy\FabrikamDB.dacpac)에서 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때 필요합니다.

앱 잠금 이름을 지정합니다.


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,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 로그인 및 암호를 제공해야 합니다.


SQL 사용자 이름SqlUsername -
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때 사용합니다.

/p:IgnoreAnsiNulls=True 또는 /p:IgnoreComments=True같은 SQL Server 데이터베이스를 배포할 때 적용되는 추가 SqlPackage.exe 인수를 지정합니다. 이러한 인수는 게시 프로필 XML 파일의 설정을 재정의합니다(제공된 경우).


추가 인수AdditionalArgumentsSql -
string; 선택 사항. TaskType = sqlQuery || TaskType = sqlInline때 사용합니다.

SQL Server 데이터베이스를 배포할 때 적용되는 추가 Invoke-Sqlcmd 인수를 지정합니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성참조하세요.

출력 변수

없음.

요구 사항

요구 사항 설명
파이프라인 유형 클래식 릴리스
다음에서 실행 에이전트, DeploymentGroup
요구 없음
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 어느 것이든
settable 변수 어느 것이든
에이전트 버전 1.102.0 이상
작업 범주 배치하다