SqlAzureDacpacDeployment@1 – úloha nasazení Azure SQL Database v1

Pomocí této úlohy můžete nasadit databázi Azure SQL pomocí dacpac nebo spouštět skripty pomocí 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.

Vstupy

azureConnectionType - Typ připojení služby Azure
Alias vstupu: ConnectedServiceNameSelector. string. Povolené hodnoty: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Výchozí hodnota: ConnectedServiceNameARM.

azureClassicSubscription - Předplatné Azure Classic
Alias vstupu: ConnectedServiceName. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName.

Určuje cílové předplatné Azure Classic pro nasazení souborů SQL.

azureSubscription - Předplatné Azure
Alias vstupu: ConnectedServiceNameARM. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceNameARM.

Určuje cílové předplatné Azure Resource Manager pro nasazení souborů SQL.

AuthenticationType - Typ ověřování
string. Povinná hodnota. Povolené hodnoty: server (ověřování SQL Server), aadAuthenticationPassword (Active Directory – heslo), aadAuthenticationIntegrated (Active Directory – integrované), connectionString (připojovací řetězec), servicePrincipal (instanční objekt). Výchozí hodnota: server.

Určuje typ ověřování databáze. Může to být ověřování SQL Server, Active Directory (integrované), Active Directory (heslo), připojovací řetězec nebo instanční objekt. Integrované ověřování znamená, že agent přistupuje k databázi pomocí aktuálního kontextu účtu služby Active Directory.

Zadejte možnost připojení k databázi Azure SQL Serveru. Můžete zadat podrobnosti o databázi Azure SQL Serveru, SQL Server připojovací řetězec, ověřování AD (heslo nebo integrované) nebo použít instanční objekt. K ověřování SQL Server použijte přihlašovací údaje uživatele SQL Server. Pro ověřování AD použijte přihlašovací údaje pro uživatele AD nakonfigurované pro SQL Server.

ServerName - Azure SQL Server
string. Vyžaduje se, když AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Určuje název serveru Azure SQL, například Fabrikam.database.windows.net,1433 nebo Fabrikam.database.windows.net.

DatabaseName - Databáze
string. Vyžaduje se, když AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Určuje název databáze Azure SQL, ve které jsou soubory nasazené.

SqlUsername - Přihlášení
string. Vyžaduje se, když AuthenticationType = server.

Určuje přihlášení správce Azure SQL Serveru.

SqlPassword - Heslo
string. Vyžaduje se, když AuthenticationType = server.

Určuje heslo správce Azure SQL Serveru. Proměnné definované v kanálech buildu nebo verze jako $(passwordVariable) jsou přijímány. Typ proměnné můžete označit jako secret zabezpečený.

aadSqlUsername - Přihlášení
string. Vyžaduje se, když AuthenticationType = aadAuthenticationPassword.

Určuje uživatelské jméno služby Active Directory.

aadSqlPassword - Heslo
string. Vyžaduje se, když AuthenticationType = aadAuthenticationPassword.

Určuje heslo pro uživatele služby Active Directory. Proměnné definované v kanálech buildu nebo verze jako $(passwordVariable) jsou přijímány. Typ proměnné můžete označit jako secret zabezpečený.

ConnectionString - Připojovací řetězec
string. Vyžaduje se, když AuthenticationType = connectionString.

Určuje připojovací řetězec Azure SQL Server, například Server=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.

deployType - Typ nasazení
Alias vstupu: TaskNameSelector. string. Povinná hodnota. Povolené hodnoty: DacpacTask (soubor DACPAC SQL), SqlTask (soubor skriptu SQL) InlineSqlTask (vložený skript SQL). Výchozí hodnota: DacpacTask.

DeploymentAction - Akce
string. Vyžaduje se, když TaskNameSelector = DacpacTask. Povolené hodnoty: Publish, Extract, , ImportExport, Script, , ( DriftReport Sestava posunu), DeployReport (Nasazení sestavy). Výchozí hodnota: Publish.

Určuje jednu z akcí SQL ze seznamu. Přečtěte si další informace o seznamu akcí SQL.

DacpacFile - Soubor DACPAC
string. Vyžaduje se, když DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Určuje umístění souboru DACPAC v agentovi automatizace nebo v cestě UNC, která je pro agenta automatizace přístupná, například \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Můžete také použít předdefinované systémové proměnné, jako $(agent.releaseDirectory)je .

BacpacFile - Soubor BACPAC
string. Vyžaduje se, když DeploymentAction = Import.

Určuje umístění souboru BACPAC v agentovi automatizace nebo v cestě UNC, která je pro agenta automatizace přístupná, například \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. Můžete také použít předdefinované systémové proměnné, jako $(agent.releaseDirectory)je .

SqlFile - Skript SQL
string. Vyžaduje se, když TaskNameSelector = SqlTask.

Určuje umístění souboru skriptu SQL v agentovi automatizace nebo v cestě UNC, která je pro agenta automatizace přístupná, například \\BudgetIT\Web\Deploy\FabrikamDB.sql. Můžete také použít předdefinované systémové proměnné, jako $(agent.releaseDirectory)je .

SqlInline - Vložený skript SQL
string. Vyžaduje se, když TaskNameSelector = InlineSqlTask.

Určuje skript SQL, který se má spustit v dříve vybrané databázi.

PublishProfile - Publikovat profil
string. Nepovinný parametr. Použijte, když TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Poskytuje podrobnou kontrolu nad vytvářením nebo upgrady Azure SQL databáze.
Určuje cestu k souboru XML profilu publikování na počítači agenta automatizace nebo ve sdílené složce UNC. Pokud profil publikování obsahuje tajné kódy, jako jsou přihlašovací údaje, nahrajte ho do knihovny zabezpečených souborů , kde je bezpečně uložený se šifrováním. Potom ho po spuštění kanálu stáhněte do počítače agenta pomocí úlohy Stáhnout zabezpečený soubor na začátku kanálu. Po dokončení kanálu ho odstraňte. Lze také použít předdefinované systémové proměnné, jako $(agent.buildDirectory) je nebo $(agent.releaseDirectory).

AdditionalArguments - Další argumenty SqlPackage.exe
string. Nepovinný parametr. Použijte, když TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Určuje další SqlPackage.exe argumenty, které se použijí při nasazování databáze Azure SQL, pokud je vybraná možnost DACPAC, například /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Tyto argumenty přepíšou nastavení v souboru XML profilu publikování (pokud jsou k dispozici).

SqlAdditionalArguments - Další argumenty Invoke-Sqlcmd
string. Nepovinný parametr. Použijte, když TaskNameSelector = SqlTask.

Určuje další argumenty Invoke-Sqlcmd, které se použijí při provádění daného dotazu SQL v databázi Azure SQL, například -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - Další argumenty Invoke-Sqlcmd
string. Nepovinný parametr. Použijte, když TaskNameSelector = InlineSqlTask.

Určuje další Invoke-Sqlcmd argumenty, které se použijí při provádění daného dotazu SQL na Azure SQL Database, například -ConnectionTimeout 100 -OutputSqlErrors.

IpDetectionMethod - Zadání pravidel brány firewall pomocí
string. Povinná hodnota. Povolené hodnoty: AutoDetect, IPAddressRange. Výchozí hodnota: AutoDetect.

Aby se úloha spustila, musí být IP adresa agenta automatizace přidána do povolené IP adresy v bráně firewall Azure SQL Serveru. Pokud chcete automaticky přidat výjimku brány firewall pro rozsah možných IP adres agenta automatizace, vyberte možnost Automatické zjišťování, nebo oblast zadejte explicitně.

StartIpAddress - Počáteční IP adresa
string. Vyžaduje se, když IpDetectionMethod = IPAddressRange.

Určuje počáteční IP adresu fondu počítačů agenta automatizace, například 196.21.30.50.

EndIpAddress - Koncová IP adresa
string. Vyžaduje se, když IpDetectionMethod = IPAddressRange.

Určuje koncovou IP adresu fondu počítačů agenta automatizace, například 196.21.30.65.

DeleteFirewallRule - Odstranit pravidlo po dokončení úkolu
boolean. Výchozí hodnota: true.

Pokud je tato možnost zaškrtnutá, po dokončení úkolu se ip adresy, které jsou zde uvedené, odstraní ze seznamu Povolené IP adresy v bráně firewall Azure SQL Serveru.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Tato úloha definuje následující výstupní proměnné, které můžete využívat v podřízených krocích, úlohách a fázích.

SqlDeploymentOutputFile
Vygenerovaná cesta k výstupnímu souboru, pokud je Extractakce balíčku nasazení , ExportScript, DriftReportnebo DeployReport.

Poznámky

Tuto úlohu použijte k nasazení Azure SQL databáze pomocí DACPAC nebo ke spouštění skriptů pomocí SQLCMD.

Důležité

Tato úloha je podporována pouze v prostředí Windows. Pokud se pokoušíte použít integrované ověřování Azure Active Directory (Azure AD), musíte vytvořit privátního agenta. Integrované ověřování Azure AD není podporováno pro hostované agenty.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům , aby bylo možné spouštět úlohy, které používají tuto úlohu: sqlpackage
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.103.0 nebo vyšší
Kategorie úloh	Nasazení