Dela via

SqlAzureDacpacDeployment@1 – Azure SQL Database-distribution v1-uppgift

Använd den här uppgiften för att distribuera en Azure SQL Database med hjälp av DACPAC eller köra skript med 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.

# 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'. Required. Authentication Type. Default: server.
    #ServerName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated. Azure SQL Server. 
    #DatabaseName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated. 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.

Ingångar

azureConnectionType - Azure-tjänstanslutningstyp
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 Azure Resource Manager-målprenumerationen för distribution av SQL-filer.


AuthenticationType - Autentiseringstyp
string. Obligatoriskt. 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 kommer åt databasen med hjälp av sin aktuella Active Directory-kontokontext.

Ange alternativet för att ansluta till Azure SQL Server-databasen. Du kan ange information om Azure SQL Server-databasen, SQL Server-anslutningssträngen, AD-autentisering (lösenord eller integrerat) eller använda tjänstens huvudnamn. För SQL Server-autentisering använder du SQL Server-autentiseringsuppgifterna. För AD-autentisering använder du autentiseringsuppgifterna för DEN AD-användare som konfigurerats för SQL Server.


AuthenticationType - Autentiseringstyp
string. Obligatoriskt. Tillåtna värden: server (SQL Server-autentisering), aadAuthenticationPassword (Active Directory – lösenord), aadAuthenticationIntegrated (Active Directory – integrerad), connectionString (anslutningssträng). 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 kommer åt databasen med hjälp av sin aktuella Active Directory-kontokontext.

Ange alternativet för att ansluta till Azure SQL Server-databasen. Du kan ange information om Azure SQL Server-databasen, SQL Server-anslutningssträngen, AD-autentisering (lösenord eller integrerat) eller använda tjänstens huvudnamn. För SQL Server-autentisering använder du SQL Server-autentiseringsuppgifterna. För AD-autentisering använder du autentiseringsuppgifterna för DEN AD-användare 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.placeholder,1433 eller Fabrikam.database.windows.net.placeholder.


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

Anger Namnet på Azure SQL Server, till exempel Fabrikam.database.windows.net.placeholder,1433 eller Fabrikam.database.windows.net.placeholder.


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.


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

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


SqlUsername - Inloggning
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 - Inloggning
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 Anslutningssträngen för Azure SQL Server, till exempel Server=testServer.database.windows.net.placeholder;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.


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


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

Anger en av SQL-åtgärderna från listan. Läs mer om listan 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, som $(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, som $(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, som $(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 skapande eller uppgraderingar av Azure SQL-databaser.
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 säkra filer bibliotek 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, till exempel $(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 vid distribution av Azure SQL-databasen om alternativet DACPAC är markerat, 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 används när du kör den angivna SQL-frågan i 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 i Azure SQL Database, till exempel -ConnectionTimeout 100 -OutputSqlErrors.


IpDetectionMethod - ange brandväggsregler med hjälp av
string. Obligatoriskt. 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 Server-brandväggen. Välj automatisk identifiering för att automatiskt lägga till brandväggsfelet för intervallet för den möjliga IP-adressen för automationsagenten, 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 slut-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 här alternativet tas de IP-adresser som anges här bort från listan Tillåtna IP-adresser i Azure SQL Server-brandväggen.


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 utdatafilens sökväg när distributionspaketåtgärden är Extract, Export, Script, DriftReporteller DeployReport.

Anmärkningar

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 hjälp av SQLCMD.

Viktigt!

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

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Ombud
kräver Lokalt installerade agenter måste ha funktioner som matchar följande kräver för att köra jobb som använder den här uppgiften: sqlpackage
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Vilken som helst
variabler som kan Vilken som helst
Agentversion 1.103.0 eller senare
Aktivitetskategori Gruppera