SqlAzureDacpacDeployment@1 - Azure SQL Veritabanı dağıtımı v1 görevi

DACPAC kullanarak Azure SQL Veritabanı dağıtmak veya SQLCMD kullanarak betikleri çalıştırmak için bu görevi kullanın.

Sözdizimi

# 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.

Girişler

Azure Hizmet Bağlantı TürüazureConnectionType -
Giriş diğer adı: ConnectedServiceNameSelector. string. İzin verilen değerler: ConnectedServiceName (Azure Klasik), ConnectedServiceNameARM (Azure Resource Manager). Varsayılan değer: ConnectedServiceNameARM.

Klasik Azure AboneliğiazureClassicSubscription -
Giriş diğer adı: ConnectedServiceName. string. ConnectedServiceNameSelector = ConnectedServiceNamegerekir.

SQL dosyalarını dağıtmak için hedef Azure klasik aboneliğini belirtir.

Azure AboneliğiazureSubscription -
Giriş diğer adı: ConnectedServiceNameARM. string. ConnectedServiceNameSelector = ConnectedServiceNameARMgerekir.

SQL dosyalarını dağıtmak için hedef Azure Resource Manager aboneliğini belirtir.

AuthenticationType - Kimlik Doğrulaması Türü
string. Gerekli. İzin verilen değerler: server (SQL Server Kimlik Doğrulaması), aadAuthenticationPassword (Active Directory - Parola), aadAuthenticationIntegrated (Active Directory - Tümleşik), connectionString (Bağlantı Dizesi), servicePrincipal (Hizmet Sorumlusu). Varsayılan değer: server.

Veritabanı kimlik doğrulamasının türünü belirtir. Sql Server, Active Directory (tümleşik), Active Directory (parola), bağlantı dizesi veya hizmet sorumlusu kimlik doğrulaması olabilir. Tümleşik kimlik doğrulaması, aracının geçerli Active Directory hesabı bağlamını kullanarak veritabanına eriştiği anlamına gelir.

Azure SQL Server veritabanına bağlanma seçeneğini belirtin. Azure SQL Server veritabanı ayrıntılarını, SQL Server bağlantı dizesini, AD Kimlik Doğrulamasını (parola veya tümleşik) sağlayabilir veya bir hizmet sorumlusu kullanabilirsiniz. SQL Server kimlik doğrulaması için SQL Server'ın kullanıcı kimlik bilgilerini kullanın. AD kimlik doğrulaması için, SQL Server'da yapılandırılan AD kullanıcısının kimlik bilgilerini kullanın.

Azure SQL ServerServerName -
string. AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipalgerekir.

Fabrikam.database.windows.net.placeholder,1433 veya Fabrikam.database.windows.net.placeholdergibi Azure SQL Server adını belirtir.

DatabaseName - Veritabanı
string. AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipalgerekir.

Dosyaların dağıtıldığı Azure SQL veritabanının adını belirtir.

oturum açmaSqlUsername -
string. AuthenticationType = servergerekir.

Azure SQL Server yönetici oturum açma bilgilerini belirtir.

parolaSqlPassword -
string. AuthenticationType = servergerekir.

Azure SQL Server yöneticisinin parolasını belirtir. Derleme veya yayın işlem hatlarında $(passwordVariable) olarak tanımlanan değişkenler kabul edilir. Değişkenin güvenliğini sağlamak için değişken türünü secret olarak işaretleyebilirsiniz.

oturum açmaaadSqlUsername -
string. AuthenticationType = aadAuthenticationPasswordgerekir.

Active Directory kullanıcı adını belirtir.

parolaaadSqlPassword -
string. AuthenticationType = aadAuthenticationPasswordgerekir.

Active Directory kullanıcısının parolasını belirtir. Derleme veya yayın işlem hatlarında $(passwordVariable) olarak tanımlanan değişkenler kabul edilir. Değişkenin güvenliğini sağlamak için değişken türünü secret olarak işaretleyebilirsiniz.

ConnectionString - Bağlantı Dizesi
string. AuthenticationType = connectionStringgerekir.

Server=testServer.database.windows.net.placeholder;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);gibi Azure SQL Server bağlantı dizesini belirtir.

deployType - Tür dağıtma
Giriş diğer adı: TaskNameSelector. string. Gerekli. İzin verilen değerler: DacpacTask (SQL DACPAC Dosyası), SqlTask (SQL Betik Dosyası), InlineSqlTask (Satır içi SQL Betiği). Varsayılan değer: DacpacTask.

DeploymentAction - Eylem
string. TaskNameSelector = DacpacTaskgerekir. İzin verilen değerler: Publish, Extract, Export, Import, Script, DriftReport (Kayma Raporu), DeployReport (Raporu Dağıt). Varsayılan değer: Publish.

Listedeki SQL eylemlerinden birini belirtir. SQL eylemleri listesi hakkında daha fazla bilgi edinin.

DACPAC DosyaDacpacFile -
string. DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReportgerekir.

DACPAC dosyasının otomasyon aracısına veya \\BudgetIT\Web\Deploy\FabrikamDB.dacpacgibi otomasyon aracısı tarafından erişilebilen bir UNC yolundaki konumunu belirtir. $(agent.releaseDirectory)gibi önceden tanımlanmış sistem değişkenleri de kullanılabilir.

BACPAC DosyaBacpacFile -
string. DeploymentAction = Importgerekir.

BACPAC dosyasının otomasyon aracısının konumunu veya \\BudgetIT\Web\Deploy\FabrikamDB.bacpacgibi otomasyon aracısı tarafından erişilebilen bir UNC yolunda belirtir. $(agent.releaseDirectory)gibi önceden tanımlanmış sistem değişkenleri de kullanılabilir.

SQL BetiğiSqlFile -
string. TaskNameSelector = SqlTaskgerekir.

SQL betik dosyasının otomasyon aracısı veya \\BudgetIT\Web\Deploy\FabrikamDB.sqlgibi otomasyon aracısı tarafından erişilebilen bir UNC yolundaki konumunu belirtir. $(agent.releaseDirectory)gibi önceden tanımlanmış sistem değişkenleri de kullanılabilir.

Satır içi SQL BetiğiSqlInline -
string. TaskNameSelector = InlineSqlTaskgerekir.

Daha önce seçilen veritabanında yürütülecek SQL betiğini belirtir.

Profil YayımlamaPublishProfile -
string. Opsiyonel. TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReportolduğunda kullanın.

Azure SQL veritabanı oluşturma veya yükseltme işlemleri üzerinde ayrıntılı denetim sağlar.
Otomasyon aracısı makinesinde veya UNC paylaşımında yayımlama profili XML dosyasının yolunu belirtir. Yayımlama profili kimlik bilgileri gibi gizli diziler içeriyorsa, şifrelemeyle güvenli bir şekilde depolandığı güvenli dosyalar kitaplığına yükleyin. Ardından, işlem hattı çalıştırıldığında aracı makineye indirmek için işlem hattınızın başındaki Güvenli dosya indir görevini kullanın. İşlem hattı tamamlandığında silin. $(agent.buildDirectory) veya $(agent.releaseDirectory)gibi önceden tanımlanmış sistem değişkenleri de kullanılabilir.

AdditionalArguments - Ek SqlPackage.exe Bağımsız Değişkenleri
string. Opsiyonel. TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReportolduğunda kullanın.

DACPAC seçeneği belirlenirse ( SqlPackage.exegibi) Azure SQL veritabanı dağıtılırken uygulanacak ek /p:IgnoreAnsiNulls=True /p:IgnoreComments=True bağımsız değişkenlerini belirtir. Bu bağımsız değişkenler, yayımlama profili XML dosyasındaki (varsa) ayarları geçersiz kılar.

SqlAdditionalArguments - Ek Invoke-Sqlcmd Bağımsız Değişkenleri
string. Opsiyonel. TaskNameSelector = SqlTaskolduğunda kullanın.

-ConnectionTimeout 100 -OutputSqlErrorsgibi Azure SQL veritabanında verilen SQL sorgusu yürütülürken uygulanan ek Invoke-Sqlcmd bağımsız değişkenlerini belirtir.

InlineAdditionalArguments - Ek Invoke-Sqlcmd Bağımsız Değişkenleri
string. Opsiyonel. TaskNameSelector = InlineSqlTaskolduğunda kullanın.

Azure SQL Veritabanı'nda verilen SQL sorgusu yürütülürken uygulanan ek Invoke-Sqlcmd bağımsız değişkenlerini belirtir, örneğin -ConnectionTimeout 100 -OutputSqlErrors.

IpDetectionMethod - Kullanarak Güvenlik Duvarı Kuralları Belirtme
string. Gerekli. İzin verilen değerler: AutoDetect, IPAddressRange. Varsayılan değer: AutoDetect.

Görevin çalışması için otomasyon aracısının IP adresinin Azure SQL Server'ın güvenlik duvarındaki İzin Verilen IP Adresleri eklenmesi gerekir. Otomatik algılama'yı seçerek otomasyon aracısının olası IP adresi aralığı için güvenlik duvarı özel durumunu otomatik olarak ekleyin veya aralığı açıkça belirtin.

StartIpAddress - Başlangıç IP Adresi
string. IpDetectionMethod = IPAddressRangegerekir.

196.21.30.50gibi otomasyon aracısı makine havuzunun başlangıç IP adresini belirtir.

EndIpAddress - Bitiş IP Adresi
string. IpDetectionMethod = IPAddressRangegerekir.

196.21.30.65gibi otomasyon aracısı makine havuzunun bitiş IP adresini belirtir.

görev sona erdikten sonra kuralı silmeyi DeleteFirewallRule -
boolean. Varsayılan değer: true.

Seçilirse, görev sona erdikten sonra burada belirtilen IP adresleri Azure SQL Server'ın güvenlik duvarındaki İzin Verilen IP Adresleri listesinden silinir.

Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Bu görevaşağıdaki çıkış değişkenlerini tanımlar. Bu değişkenleri aşağı akış adımlarında, işlerde ve aşamalarda kullanabilirsiniz.

SqlDeploymentOutputFile
Dağıtım paketi eylemi Extract, Export, Script, DriftReportveya DeployReportolduğunda oluşturulan çıkış dosyası yolu.

Açıklamalar

DACPAC kullanarak Azure SQL veritabanı dağıtmak veya SQLCMD kullanarak betikleri çalıştırmak için bu görevi kullanın.

Önemli

Bu görev yalnızca bir Windows ortamında desteklenir. Azure Active Directory (Azure AD) tümleşik kimlik doğrulamasını kullanmaya çalışıyorsanız özel bir aracı oluşturmanız gerekir. Barındırılan aracılar için Azure AD tümleşik kimlik doğrulaması desteklenmez.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Temsilci
Talepleri	Şirket içinde barındırılan aracıların, bu görevi kullanan işleri çalıştırmak için taleplerine uyan özellikleri olmalıdır: sqlpackage
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi bir
Ayarlanabilir değişkenleri	Herhangi bir
Aracı sürümü	1.103.0 veya üzeri
Görev kategorisi	Uygulamak