SqlAzureDacpacDeployment@1 - veritabanı dağıtımı v1 görevini Azure SQL

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

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.

Girişler

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

azureClassicSubscription - Klasik Azure Aboneliği
Giriş diğer adı: ConnectedServiceName. string. olduğunda ConnectedServiceNameSelector = ConnectedServiceNamegereklidir.

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

azureSubscription - Azure Aboneliği
Giriş diğer adı: ConnectedServiceNameARM. string. olduğunda ConnectedServiceNameSelector = ConnectedServiceNameARMgereklidir.

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

AuthenticationType - Kimlik Doğrulama Türü
string. Gereklidir. İ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. Bu bir 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 Sunucusu veritabanına bağlanma seçeneğini belirtin. Azure SQL Server veritabanı ayrıntılarını, SQL Server bağlantı dizesi, AD Kimlik Doğrulamasını (parola veya tümleşik) sağlayabilir veya hizmet sorumlusu kullanabilirsiniz. SQL Server kimlik doğrulaması için SQL Server kullanıcı kimlik bilgilerini kullanın. AD kimlik doğrulaması için, SQL Server yapılandırılan AD kullanıcısının kimlik bilgilerini kullanın.

ServerName - Azure SQL Sunucusu
string. olduğunda AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipalgereklidir.

veya Fabrikam.database.windows.netgibi Fabrikam.database.windows.net,1433 Azure SQL Sunucusu adını belirtir.

DatabaseName - Veritabanı
string. olduğunda AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipalgereklidir.

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

SqlUsername - Oturum açma
string. olduğunda AuthenticationType = servergereklidir.

Azure SQL Sunucusu yöneticisi oturum açma bilgilerini belirtir.

SqlPassword - Parola
string. olduğunda AuthenticationType = servergereklidir.

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

aadSqlUsername - Oturum açma
string. olduğunda AuthenticationType = aadAuthenticationPasswordgereklidir.

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

aadSqlPassword - Parola
string. olduğunda AuthenticationType = aadAuthenticationPasswordgereklidir.

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

ConnectionString - Bağlantı Dizesi
string. olduğunda AuthenticationType = connectionStringgereklidir.

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

deployType - Dağıtım türü
Giriş diğer adı: TaskNameSelector. string. Gereklidir. İ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. olduğunda TaskNameSelector = DacpacTaskgereklidir. İ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.

DacpacFile - DACPAC Dosyası
string. olduğunda DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReportgereklidir.

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

BacpacFile - BACPAC Dosyası
string. olduğunda DeploymentAction = Importgereklidir.

BACPAC dosyasının otomasyon aracısının veya otomasyon aracısı tarafından erişilebilen unc yolundaki konumunu belirtir, örneğin \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. gibi $(agent.releaseDirectory)önceden tanımlanmış sistem değişkenleri de kullanılabilir.

SqlFile - SQL Betiği
string. olduğunda TaskNameSelector = SqlTaskgereklidir.

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

SqlInline - Satır içi SQL Betiği
string. olduğunda TaskNameSelector = InlineSqlTaskgereklidir.

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

PublishProfile - Profili Yayımla
string. İsteğe bağlı. when TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReportkullanı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, şifreleme ile 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 dosyayı indir görevini kullanın. İşlem hattı tamamlandığında silin. veya $(agent.releaseDirectory)gibi $(agent.buildDirectory) önceden tanımlanmış sistem değişkenleri de kullanılabilir.

AdditionalArguments - Ek SqlPackage.exe Bağımsız Değişkenleri
string. İsteğe bağlı. when TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReportkullanın.

DACPAC seçeneği belirlenirse Azure SQL veritabanı dağıtılırken uygulanacak ek SqlPackage.exe bağımsız değişkenleri belirtir, örneğin/p:IgnoreAnsiNulls=True /p:IgnoreComments=True. 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. İsteğe bağlı. when TaskNameSelector = SqlTaskkullanı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: .

InlineAdditionalArguments - Ek Invoke-Sqlcmd Bağımsız Değişkenleri
string. İsteğe bağlı. when TaskNameSelector = InlineSqlTaskkullanı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. Gereklidir. İzin verilen değerler: AutoDetect, IPAddressRange. Varsayılan değer: AutoDetect.

Görevin çalışması için otomasyon aracısının IP adresi, Azure SQL Sunucusunun güvenlik duvarındaki İzin Verilen IP Adresleri'ne eklenmelidir. Otomatik algıla'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. olduğunda IpDetectionMethod = IPAddressRangegereklidir.

Otomasyon aracısı makine havuzunun başlangıç IP adresini belirtir, örneğin 196.21.30.50.

EndIpAddress - Bitiş IP Adresi
string. olduğunda IpDetectionMethod = IPAddressRangegereklidir.

Otomasyon aracısı makine havuzunun bitiş IP adresini belirtir, örneğin 196.21.30.65.

DeleteFirewallRule - Görev Sona Erdikten Sonra Kuralı Sil
boolean. Varsayılan değer: true.

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

Görev denetim seçenekleri

Tüm görevlerde 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örev aşağı akış adımlarında, işlerde ve aşamalarda kullanabileceğiniz aşağıdaki çıkış değişkenlerini tanımlar.

SqlDeploymentOutputFile
Dağıtım paketi eylemi , , ScriptExport, DriftReportveya DeployReportolduğunda Extractoluşturulan çıkış dosyası yolu.

Açıklamalar

DACPAC kullanarak bir 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 tümleşik kimlik doğrulamasını kullanmaya çalışıyorsanız bir özel aracı oluşturmanız gerekir. Azure AD tümleşik kimlik doğrulaması, barındırılan aracılar için desteklenmez.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Aracı
Talep	Şirket içi barındırılan aracılar, bu görevi kullanan işleri çalıştırmak için aşağıdaki taleplerle eşleşen özelliklere sahip olmalıdır: sqlpackage
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	1.103.0 veya üzeri
Görev kategorisi	Dağıtma