SqlAzureDacpacDeployment@1 – uppgift för Azure SQL-databasdistribution v1

Använd den här uppgiften om du vill distribuera en Azure SQL-databas med DACPAC eller köra skript med HJÄLP av 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.

Indata

azureConnectionType - Anslutningstyp för Azure-tjänst
Indataalias: ConnectedServiceNameSelector. string. Tillåtna värden: ConnectedServiceName (klassisk Azure), ConnectedServiceNameARM (Azure Resource Manager). Standardvärde: ConnectedServiceNameARM.

azureClassicSubscription - Klassisk Azure-prenumeration
Indataalias: ConnectedServiceName. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceName.

Anger den klassiska Azure-målprenumerationen för distribution av SQL-filer.

azureSubscription - Azure-prenumeration
Indataalias: ConnectedServiceNameARM. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceNameARM.

Anger målprenumerationen för Azure Resource Manager för distribution av SQL-filer.

AuthenticationType - Autentiseringstyp
string. Krävs. Tillåtna värden: server (SQL Server-autentisering), aadAuthenticationPassword (Active Directory – lösenord), aadAuthenticationIntegrated (Active Directory – integrerad), connectionString (anslutningssträng) servicePrincipal (tjänstens huvudnamn). Standardvärde: server.

Anger typen av databasautentisering. Det kan vara en SQL Server, Active Directory (integrerad), Active Directory (lösenord), anslutningssträng eller autentisering med tjänstens huvudnamn. Integrerad autentisering innebär att agenten får åtkomst till databasen med hjälp av den aktuella Active Directory-kontokontexten.

Ange alternativet för att ansluta till Azure SQL Server-databasen. Du kan ange Azure SQL Server-databasinformation, SQL Server anslutningssträng, AD-autentisering (lösenord eller integrerat) eller använda tjänstens huvudnamn. Använd SQL Server autentiseringsuppgifter för SQL Server-autentisering. För AD-autentisering använder du autentiseringsuppgifterna för AD-användaren som konfigurerats för SQL Server.

ServerName - Azure SQL Server
string. Krävs när AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Anger namnet på Azure SQL server, till exempel Fabrikam.database.windows.net,1433 eller Fabrikam.database.windows.net.

DatabaseName - Databas
string. Krävs när AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Anger namnet på den Azure SQL databas där filerna distribueras.

SqlUsername - Logga in
string. Krävs när AuthenticationType = server.

Anger inloggningen för Azure SQL Server-administratören.

SqlPassword - Lösenord
string. Krävs när AuthenticationType = server.

Anger lösenordet för Azure SQL Server-administratören. Variabler som definieras i bygg- eller versionspipelines som $(passwordVariable) accepteras. Du kan markera variabeltypen som secret för att skydda den.

aadSqlUsername - Logga in
string. Krävs när AuthenticationType = aadAuthenticationPassword.

Anger Active Directory-användarnamnet.

aadSqlPassword - Lösenord
string. Krävs när AuthenticationType = aadAuthenticationPassword.

Anger lösenordet för Active Directory-användaren. Variabler som definieras i bygg- eller versionspipelines som $(passwordVariable) accepteras. Du kan markera variabeltypen som secret för att skydda den.

ConnectionString - Anslutningssträng
string. Krävs när AuthenticationType = connectionString.

Anger Azure SQL Server anslutningssträng, till exempel Server=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.

deployType - Distributionstyp
Indataalias: TaskNameSelector. string. Krävs. Tillåtna värden: DacpacTask (SQL DACPAC-fil), SqlTask (SQL-skriptfil) InlineSqlTask (infogat SQL-skript). Standardvärde: DacpacTask.

DeploymentAction - Åtgärder
string. Krävs när TaskNameSelector = DacpacTask. Tillåtna värden: Publish, Extract, Export, Import, Script( DriftReport Drift-rapport) DeployReport (Distribuera rapport). Standardvärde: Publish.

Anger en av SQL-åtgärderna i listan. Läs mer om listan med SQL-åtgärder.

DacpacFile - DACPAC-fil
string. Krävs när DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Anger platsen för DACPAC-filen på automationsagenten eller på en UNC-sökväg som är tillgänglig för automationsagenten, till exempel \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Fördefinierade systemvariabler, till exempel $(agent.releaseDirectory), kan också användas.

BacpacFile - BACPAC-fil
string. Krävs när DeploymentAction = Import.

Anger platsen för BACPAC-filen på automationsagenten eller på en UNC-sökväg som är tillgänglig för automationsagenten, till exempel \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. Fördefinierade systemvariabler, till exempel $(agent.releaseDirectory), kan också användas.

SqlFile - SQL-skript
string. Krävs när TaskNameSelector = SqlTask.

Anger platsen för SQL-skriptfilen på automationsagenten eller på en UNC-sökväg som är tillgänglig för automationsagenten, till exempel \\BudgetIT\Web\Deploy\FabrikamDB.sql. Fördefinierade systemvariabler, till exempel $(agent.releaseDirectory), kan också användas.

SqlInline - Infogat SQL-skript
string. Krävs när TaskNameSelector = InlineSqlTask.

Anger SQL-skriptet som ska köras på den tidigare valda databasen.

PublishProfile - Publicera profil
string. Valfritt. Använd när TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Ger detaljerad kontroll över Azure SQL databasskapande eller uppgraderingar.
Anger sökvägen till XML-filen för publiceringsprofilen på automationsagentdatorn eller på en UNC-resurs. Om publiceringsprofilen innehåller hemligheter, till exempel autentiseringsuppgifter, laddar du upp den till biblioteket för säkra filer där den lagras säkert med kryptering. Använd sedan uppgiften Ladda ned säker fil i början av pipelinen för att ladda ned den till agentdatorn när pipelinen körs. Ta bort den när pipelinen är klar. Fördefinierade systemvariabler, t.ex $(agent.buildDirectory) . eller $(agent.releaseDirectory), kan också användas.

AdditionalArguments - Ytterligare SqlPackage.exe argument
string. Valfritt. Använd när TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Anger de ytterligare SqlPackage.exe argument som ska användas när du distribuerar Azure SQL databas om alternativet DACPAC är valt, till exempel /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Dessa argument åsidosätter inställningarna i XML-filen för publiceringsprofilen (om så anges).

SqlAdditionalArguments - Ytterligare Invoke-Sqlcmd argument
string. Valfritt. Använd när TaskNameSelector = SqlTask.

Anger de ytterligare Invoke-Sqlcmd argument som tillämpas när du kör den angivna SQL-frågan på Azure SQL-databasen, till exempel -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - Ytterligare Invoke-Sqlcmd argument
string. Valfritt. Använd när TaskNameSelector = InlineSqlTask.

Anger de ytterligare Invoke-Sqlcmd argument som tillämpas när du kör den angivna SQL-frågan på Azure SQL Database, till exempel -ConnectionTimeout 100 -OutputSqlErrors.

IpDetectionMethod - Ange brandväggsregler med
string. Krävs. Tillåtna värden: AutoDetect, IPAddressRange. Standardvärde: AutoDetect.

För att uppgiften ska kunna köras måste IP-adressen för automationsagenten läggas till i tillåtna IP-adresser i Azure SQL-serverns brandvägg. Välj automatisk identifiering för att automatiskt lägga till brandväggsfelet för intervallet för automationsagentens möjliga IP-adress, eller ange intervallet explicit.

StartIpAddress - Starta IP-adress
string. Krävs när IpDetectionMethod = IPAddressRange.

Anger start-IP-adressen för automationsagentens datorpool, till exempel 196.21.30.50.

EndIpAddress - Slut-IP-adress
string. Krävs när IpDetectionMethod = IPAddressRange.

Anger den sista IP-adressen för automationsagentens datorpool, till exempel 196.21.30.65.

DeleteFirewallRule - Ta bort regel när aktiviteten har avslutats
boolean. Standardvärde: true.

Om du väljer det tas de IP-adresser som anges här bort från listan Tillåtna IP-adresser i Azure SQL Server-brandväggen när aktiviteten har avslutats.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Den här uppgiften definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och steg.

SqlDeploymentOutputFile
Den genererade utdatafilsökvägen när distributionspaketåtgärden är Extract, Export, Script, DriftReporteller DeployReport.

Kommentarer

Använd den här uppgiften för att distribuera en Azure SQL databas med hjälp av en DACPAC eller köra skript med SQLCMD.

Viktigt

Den här uppgiften stöds endast i en Windows-miljö. Om du försöker använda integrerad autentisering med Azure Active Directory (Azure AD) måste du skapa en privat agent. Integrerad autentisering med Azure AD stöds inte för värdbaserade agenter.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent
Krav	Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: sqlpackage
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	1.103.0 eller senare
Uppgiftskategori	Distribuera