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

Pomocí této úlohy můžete nasadit službu Azure SQL Database pomocí jazyka DACPAC nebo spustit skripty pomocí SQLCMD.

Syntaxe

# 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í ke službě Azure
Vstupní alias: ConnectedServiceNameSelector. string. Povolené hodnoty: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Výchozí hodnota: ConnectedServiceNameARM.

azureClassicSubscription - předplatného Azure Classic
Vstupní alias: ConnectedServiceName. string. Požadováno při ConnectedServiceNameSelector = ConnectedServiceName.

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

azureSubscription - předplatného Azure
Vstupní alias: ConnectedServiceNameARM. string. Požadováno při ConnectedServiceNameSelector = ConnectedServiceNameARM.

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

AuthenticationType - Typ ověření
string. Povinné. Povolené hodnoty: server (ověřování SQL Serveru), 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 SQL Server, Active Directory (integrované), Active Directory (heslo), připojovací řetězec nebo ověřování instančního objektu. Integrované ověřování znamená, že agent přistupuje k databázi pomocí kontextu aktuálního úč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, připojovací řetězec SQL Serveru, ověřování AD (heslo nebo integrované) nebo použít instanční objekt. Pro ověřování SQL Serveru použijte přihlašovací údaje uživatele SQL Serveru. Pro ověřování AD použijte přihlašovací údaje uživatele AD nakonfigurovaného na SQL Server.

ServerName - Azure SQL Server
string. Požadováno při AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

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

DatabaseName - Databáze
string. Požadováno při AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Určuje název databáze Azure SQL, do které se soubory nasazují.

SqlUsername - přihlášení
string. Požadováno při AuthenticationType = server.

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

SqlPassword - heslo
string. Požadováno při AuthenticationType = server.

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

aadSqlUsername - přihlášení
string. Požadováno při AuthenticationType = aadAuthenticationPassword.

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

aadSqlPassword - heslo
string. Požadováno při AuthenticationType = aadAuthenticationPassword.

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

připojovacího řetězce ConnectionString -
string. Požadováno při AuthenticationType = connectionString.

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

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

DeploymentAction - akce
string. Požadováno při TaskNameSelector = DacpacTask. Povolené hodnoty: Publish, Extract, Export, Import, 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.

souborů DACPAC DacpacFile -
string. Požadováno při DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

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

souboru BACPAC BacpacFile -
string. Požadováno při DeploymentAction = Import.

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

skript SQL SqlFile -
string. Požadováno při TaskNameSelector = SqlTask.

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

SqlInline - vložený skript SQL
string. Požadováno při TaskNameSelector = InlineSqlTask.

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

PublishProfile - profilu publikování
string. Volitelný. Používá se při TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Poskytuje podrobnou kontrolu nad vytvářením nebo upgrady databáze Azure SQL.
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 zabezpečené soubory knihovně, kde je bezpečně uložena pomocí šifrování. V dalším kroku pomocí úlohy Stáhnout zabezpečený soubor na začátku kanálu ho stáhněte do počítače agenta při spuštění kanálu. Po dokončení kanálu ho odstraňte. Lze také použít předdefinované systémové proměnné, například $(agent.buildDirectory) nebo $(agent.releaseDirectory).

AdditionalArguments - dalších argumentů SqlPackage.exe
string. Volitelný. Používá se při 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íší nastavení v souboru XML profilu publikování (pokud je k dispozici).

SqlAdditionalArguments - dalších argumentů Invoke-Sqlcmd
string. Volitelný. Používá se při TaskNameSelector = SqlTask.

Určuje další Invoke-Sqlcmd argumenty, 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ších argumentů Invoke-Sqlcmd
string. Volitelný. Používá se při TaskNameSelector = InlineSqlTask.

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

IpDetectionMethod - určení pravidel brány firewall pomocí
string. Povinné. 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ého zjišťování nebo explicitně zadejte rozsah.

StartIpAddress - počáteční IP adresy
string. Požadováno při 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. Požadováno při IpDetectionMethod = IPAddressRange.

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

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

Pokud je tato možnost vybraná, po skončení úkolu se IP adresy zadané tady 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 naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

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 výstupního souboru, pokud je akce balíčku nasazení Extract, Export, Script, DriftReportnebo DeployReport.

Poznámky

Pomocí této úlohy můžete nasadit databázi Azure SQL pomocí jazyka DACPAC nebo spustit skripty pomocí SQLCMD.

Důležité

Tato úloha je podporována pouze v prostředí systému 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, klasické sestavení, klasická verze
Běží na	Agenta
požadavky	Agenti v místním prostředí musí mít schopnosti, které odpovídají následujícím požadavkům ke spouštění úloh, které používají tuto úlohu: sqlpackage
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	1.103.0 nebo vyšší
Kategorie úkolu	Nasadit