SqlAzureDacpacDeployment@1 - 데이터베이스 배포 v1 작업 Azure SQL

이 작업을 사용하여 DACPAC를 사용하여 Azure SQL Database를 배포하거나 SQLCMD를 사용하여 스크립트를 실행합니다.

Syntax

# Azure SQL Database deployment v1
# Deploy an Azure SQL Database using DACPAC or run scripts using SQLCMD.
- task: SqlAzureDacpacDeployment@1
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Service Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
  # SQL Database
    AuthenticationType: 'server' # 'server' | 'aadAuthenticationPassword' | 'aadAuthenticationIntegrated' | 'connectionString' | 'servicePrincipal'. Required. Authentication Type. Default: server.
    #ServerName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Azure SQL Server. 
    #DatabaseName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Database. 
    SqlUsername: # string. Required when AuthenticationType = server. Login. 
    SqlPassword: # string. Required when AuthenticationType = server. Password. 
    #aadSqlUsername: # string. Required when AuthenticationType = aadAuthenticationPassword. Login. 
    #aadSqlPassword: # string. Required when AuthenticationType = aadAuthenticationPassword. Password. 
    #ConnectionString: # string. Required when AuthenticationType = connectionString. Connection String. 
  # Deployment Package
    deployType: 'DacpacTask' # 'DacpacTask' | 'SqlTask' | 'InlineSqlTask'. Alias: TaskNameSelector. Required. Deploy type. Default: DacpacTask.
    DeploymentAction: 'Publish' # 'Publish' | 'Extract' | 'Export' | 'Import' | 'Script' | 'DriftReport' | 'DeployReport'. Required when TaskNameSelector = DacpacTask. Action. Default: Publish.
    #DacpacFile: # string. Required when DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport. DACPAC File. 
    #BacpacFile: # string. Required when DeploymentAction = Import. BACPAC File. 
    #SqlFile: # string. Required when TaskNameSelector = SqlTask. SQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline SQL Script. 
    #PublishProfile: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport. Publish Profile. 
    #AdditionalArguments: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport. Additional SqlPackage.exe Arguments. 
    #SqlAdditionalArguments: # string. Optional. Use when TaskNameSelector = SqlTask. Additional Invoke-Sqlcmd Arguments. 
    #InlineAdditionalArguments: # string. Optional. Use when TaskNameSelector = InlineSqlTask. Additional Invoke-Sqlcmd Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.

입력

azureConnectionType - Azure 서비스 연결 유형
입력 별칭: ConnectedServiceNameSelector. string. 허용되는 값: ConnectedServiceName (Azure 클래식), ConnectedServiceNameARM (Azure Resource Manager). 기본값은 ConnectedServiceNameARM입니다.

azureClassicSubscription - Azure 클래식 구독
입력 별칭: ConnectedServiceName. string. 필요한 경우 ConnectedServiceNameSelector = ConnectedServiceName입니다.

SQL 파일을 배포하기 위한 대상 Azure 클래식 구독을 지정합니다.

azureSubscription - Azure 구독
입력 별칭: ConnectedServiceNameARM. string. 필요한 경우 ConnectedServiceNameSelector = ConnectedServiceNameARM입니다.

SQL 파일을 배포하기 위한 대상 Azure Resource Manager 구독을 지정합니다.

AuthenticationType - 인증 유형
string. 필수 요소. 허용되는 값: server (SQL Server 인증), aadAuthenticationPassword (Active Directory - 암호), aadAuthenticationIntegrated (Active Directory - 통합), connectionString (연결 문자열), servicePrincipal (서비스 주체). 기본값은 server입니다.

데이터베이스 인증 유형을 지정합니다. SQL Server, Active Directory(통합), Active Directory(암호), 연결 문자열 또는 서비스 주체 인증일 수 있습니다. 통합 인증은 에이전트가 현재 Active Directory 계정 컨텍스트를 사용하여 데이터베이스에 액세스한다는 것을 의미합니다.

Azure SQL Server 데이터베이스에 연결하는 옵션을 지정합니다. Azure SQL Server 데이터베이스 세부 정보, SQL Server 연결 문자열, AD 인증(암호 또는 통합)을 제공하거나 서비스 주체를 사용할 수 있습니다. SQL Server 인증의 경우 SQL Server 사용자 자격 증명을 사용합니다. AD 인증의 경우 SQL Server 구성된 AD 사용자에 대한 자격 증명을 사용합니다.

ServerName - Azure SQL Server
string. 필요한 경우 AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal입니다.

또는 Fabrikam.database.windows.net와 같은 Fabrikam.database.windows.net,1433 Azure SQL 서버 이름을 지정합니다.

DatabaseName - 데이터베이스
string. 필요한 경우 AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal입니다.

파일이 배포되는 Azure SQL 데이터베이스의 이름을 지정합니다.

SqlUsername - 로그인
string. 필요한 경우 AuthenticationType = server입니다.

Azure SQL 서버 관리자 로그인을 지정합니다.

SqlPassword - 암호
string. 필요한 경우 AuthenticationType = server입니다.

Azure SQL Server 관리자의 암호를 지정합니다. 빌드 또는 릴리스 파이프라인에 정의된 변수가 $(passwordVariable) 허용됩니다. 변수 형식 secret 을 로 표시하여 보호할 수 있습니다.

aadSqlUsername - 로그인
string. 필요한 경우 AuthenticationType = aadAuthenticationPassword입니다.

Active Directory 사용자 이름을 지정합니다.

aadSqlPassword - 암호
string. 필요한 경우 AuthenticationType = aadAuthenticationPassword입니다.

Active Directory 사용자의 암호를 지정합니다. 빌드 또는 릴리스 파이프라인에 정의된 변수가 $(passwordVariable) 허용됩니다. 변수 형식 secret 을 로 표시하여 보호할 수 있습니다.

ConnectionString - 연결 문자열
string. 필요한 경우 AuthenticationType = connectionString입니다.

와 같은 Server=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);Azure SQL Server 연결 문자열 지정합니다.

deployType - 배포 유형
입력 별칭: TaskNameSelector. string. 필수 요소. 허용되는 값: DacpacTask (SQL DACPAC 파일), SqlTask (SQL 스크립트 파일), InlineSqlTask (인라인 SQL 스크립트). 기본값은 DacpacTask입니다.

DeploymentAction - 작업
string. 필요한 경우 TaskNameSelector = DacpacTask입니다. 허용되는 값: Publish, , Extract, Export, Import, ScriptDriftReport (Drift Report), DeployReport (보고서 배포). 기본값은 Publish입니다.

목록에서 SQL 작업 중 하나를 지정합니다. SQL 작업 목록에 대해 자세히 알아봅니다.

DacpacFile - DACPAC 파일
string. 필요한 경우 DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport입니다.

자동화 에이전트 또는 자동화 에이전트에서 액세스할 수 있는 UNC 경로(예: \\BudgetIT\Web\Deploy\FabrikamDB.dacpac)에서 DACPAC 파일의 위치를 지정합니다. 와 같은 $(agent.releaseDirectory)미리 정의된 시스템 변수도 사용할 수 있습니다.

BacpacFile - BACPAC 파일
string. 필요한 경우 DeploymentAction = Import입니다.

자동화 에이전트 또는 자동화 에이전트에서 액세스할 수 있는 UNC 경로(예: \\BudgetIT\Web\Deploy\FabrikamDB.bacpac)에서 BACPAC 파일의 위치를 지정합니다. 와 같은 $(agent.releaseDirectory)미리 정의된 시스템 변수도 사용할 수 있습니다.

SqlFile - SQL 스크립트
string. 필요한 경우 TaskNameSelector = SqlTask입니다.

자동화 에이전트 또는 자동화 에이전트에서 액세스할 수 있는 UNC 경로(예: \\BudgetIT\Web\Deploy\FabrikamDB.sql)에서 SQL 스크립트 파일의 위치를 지정합니다. 와 같은 $(agent.releaseDirectory)미리 정의된 시스템 변수도 사용할 수 있습니다.

SqlInline - 인라인 SQL 스크립트
string. 필요한 경우 TaskNameSelector = InlineSqlTask입니다.

이전에 선택한 데이터베이스에서 실행할 SQL 스크립트를 지정합니다.

PublishProfile - 프로필 게시
string. 선택 사항입니다. 를 사용하는 경우 TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport를 사용합니다.

Azure SQL 데이터베이스 만들기 또는 업그레이드에 대한 세분화된 제어를 제공합니다.
자동화 에이전트 컴퓨터 또는 UNC 공유에 게시 프로필 XML 파일의 경로를 지정합니다. 게시 프로필에 자격 증명과 같은 비밀이 포함된 경우 암호화를 사용하여 안전하게 저장된 보안 파일 라이브러리에 업로드합니다. 다음으로 파이프라인 시작 시 보안 파일 다운로드 작업을 사용하여 파이프라인이 실행되면 에이전트 컴퓨터에 다운로드합니다. 파이프라인이 완료되면 삭제합니다. 또는 $(agent.releaseDirectory)와 같은 $(agent.buildDirectory) 미리 정의된 시스템 변수도 사용할 수 있습니다.

AdditionalArguments - 추가 SqlPackage.exe 인수
string. 선택 사항입니다. 를 사용하는 경우 TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport를 사용합니다.

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

SqlAdditionalArguments - 추가 Invoke-Sqlcmd 인수
string. 선택 사항입니다. 를 사용하는 경우 TaskNameSelector = SqlTask를 사용합니다.

와 같이 -ConnectionTimeout 100 -OutputSqlErrorsAzure SQL 데이터베이스에서 지정된 SQL 쿼리를 실행할 때 적용되는 추가 Invoke-Sqlcmd 인수를 지정합니다.

InlineAdditionalArguments - 추가 Invoke-Sqlcmd 인수
string. 선택 사항입니다. 를 사용하는 경우 TaskNameSelector = InlineSqlTask를 사용합니다.

와 같이 -ConnectionTimeout 100 -OutputSqlErrorsAzure SQL 데이터베이스에서 지정된 SQL 쿼리를 실행할 때 적용되는 추가 Invoke-Sqlcmd 인수를 지정합니다.

IpDetectionMethod - 를 사용하여 방화벽 규칙 지정
string. 필수 요소. 허용되는 값: AutoDetect, IPAddressRange. 기본값은 AutoDetect입니다.

작업을 실행하려면 자동화 에이전트의 IP 주소를 Azure SQL 서버 방화벽의 허용된 IP 주소에 추가해야 합니다. 자동 검색을 선택하여 자동화 에이전트의 가능한 IP 주소 범위에 대한 방화벽 예외를 자동으로 추가하거나 범위를 명시적으로 지정합니다.

StartIpAddress - IP 주소 시작
string. 필요한 경우 IpDetectionMethod = IPAddressRange입니다.

자동화 에이전트 머신 풀의 시작 IP 주소(예: 196.21.30.50)를 지정합니다.

EndIpAddress - 끝 IP 주소
string. 필요한 경우 IpDetectionMethod = IPAddressRange입니다.

자동화 에이전트 컴퓨터 풀의 끝 IP 주소(예 196.21.30.65: )를 지정합니다.

DeleteFirewallRule - 작업이 종료된 후 규칙 삭제
boolean. 기본값은 true입니다.

이 옵션을 선택하면 작업이 종료된 후 여기에 지정된 IP 주소가 Azure SQL 서버 방화벽의 허용된 IP 주소 목록에서 삭제됩니다.

작업 제어 옵션

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

출력 변수

이 작업은 다운스트림 단계, 작업 및 단계에서 사용할 수 있는 다음 출력 변수를 정의합니다.

SqlDeploymentOutputFile
배포 패키지 작업이 , , , DriftReportScript또는 DeployReport일 Export때 생성된 출력 파일 경로입니다Extract.

설명

이 작업을 사용하여 DACPAC를 사용하여 Azure SQL 데이터베이스를 배포하거나 SQLCMD를 사용하여 스크립트를 실행합니다.

중요

이 작업은 Windows 환경에서만 지원됩니다. Azure AD(Azure Active Directory) 통합 인증을 사용하려는 경우 프라이빗 에이전트를 만들어야 합니다. 호스트된 에이전트에는 Azure AD 통합 인증이 지원되지 않습니다.

요구 사항

요구 사항	Description
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
실행 중	에이전트
요청	자체 호스팅 에이전트에는 이 작업을 사용하는 작업을 실행하기 위한 다음 요구 사항과 일치하는 기능이 있어야 합니다. sqlpackage
Capabilities	이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항	모두
Settable 변수	모두
에이전트 버전	1.103.0 이상
작업 범주	배포