SqlAzureDacpacDeployment@1 - Attività distribuzione database Azure SQL v1

Usare questa attività per distribuire un database Azure SQL tramite DACPAC o eseguire script usando SQLCMD.

Sintassi

# 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.

Input

azureConnectionType - Tipo di connessione del servizio di Azure
Alias di input: ConnectedServiceNameSelector. string. Valori consentiti: ConnectedServiceName (versione classica di Azure), ConnectedServiceNameARM (Azure Resource Manager). Valore predefinito: ConnectedServiceNameARM.

azureClassicSubscription - Sottoscrizione classica di Azure
Alias di input: ConnectedServiceName. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName.

Specifica la sottoscrizione classica di Azure di destinazione per la distribuzione di file SQL.

azureSubscription - Sottoscrizione di Azure
Alias di input: ConnectedServiceNameARM. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Specifica la sottoscrizione di Azure Resource Manager di destinazione per la distribuzione di file SQL.

AuthenticationType - Tipo di autenticazione
string. Obbligatorio. Valori consentiti: server (SQL Server Authentication), aadAuthenticationPassword (Active Directory - Password), aadAuthenticationIntegrated (Active Directory - Integrated), (Stringa di connessione), connectionStringservicePrincipal (Entità servizio). Valore predefinito: server.

Specifica il tipo di autenticazione del database. Può essere un SQL Server, Active Directory (integrato), Active Directory (password), stringa di connessione o autenticazione dell'entità servizio. L'autenticazione integrata indica che l'agente accede al database usando il contesto dell'account Active Directory corrente.

Specificare l'opzione per connettersi al database del server Azure SQL. È possibile specificare i dettagli del database di Azure SQL Server, il SQL Server stringa di connessione, l'autenticazione di AD (password o integrata) o usare un'entità servizio. Per SQL Server l'autenticazione, usare le credenziali utente del SQL Server. Per l'autenticazione di Active Directory, usare le credenziali per l'utente di Active Directory configurato per il SQL Server.

ServerName - server Azure SQL
string. Obbligatorio quando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Specifica il nome del server Azure SQL, ad esempio Fabrikam.database.windows.net,1433 o Fabrikam.database.windows.net.

DatabaseName - Database
string. Obbligatorio quando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Specifica il nome del database Azure SQL in cui vengono distribuiti i file.

SqlUsername - Login
string. Obbligatorio quando AuthenticationType = server.

Specifica l'account di accesso amministratore del server Azure SQL.

SqlPassword - Password
string. Obbligatorio quando AuthenticationType = server.

Specifica la password per l'amministratore del server Azure SQL. Le variabili definite nelle pipeline di compilazione o versione come $(passwordVariable) vengono accettate. È possibile contrassegnare il tipo di variabile per secret proteggerlo.

aadSqlUsername - Login
string. Obbligatorio quando AuthenticationType = aadAuthenticationPassword.

Specifica il nome utente di Active Directory.

aadSqlPassword - Password
string. Obbligatorio quando AuthenticationType = aadAuthenticationPassword.

Specifica la password per l'utente di Active Directory. Le variabili definite nelle pipeline di compilazione o versione come $(passwordVariable) vengono accettate. È possibile contrassegnare il tipo di variabile per secret proteggerlo.

ConnectionString - Stringa di connessione
string. Obbligatorio quando AuthenticationType = connectionString.

Specifica il stringa di connessione del server Azure SQL, ad esempio Server=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.

deployType - Tipo di distribuzione
Alias di input: TaskNameSelector. string. Obbligatorio. Valori consentiti: DacpacTask (file DACPAC SQL), SqlTask (file script SQL), InlineSqlTask (script SQL) (script SQL inline). Valore predefinito: DacpacTask.

DeploymentAction - Azione
string. Obbligatorio quando TaskNameSelector = DacpacTask. Valori consentiti: Publish, Extract, Export, Import, Script, DriftReport (report deviazione), DeployReport (distribuisci report). Valore predefinito: Publish.

Specifica una delle azioni SQL dall'elenco. Altre informazioni sull'elenco di azioni SQL.

DacpacFile - DACPAC File
string. Obbligatorio quando DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Specifica il percorso del file DACPAC nell'agente di automazione o in un percorso UNC accessibile all'agente di automazione, ad esempio \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Le variabili di sistema predefinite, ad esempio $(agent.releaseDirectory), possono essere usate anche.

BacpacFile - BACPAC File
string. Obbligatorio quando DeploymentAction = Import.

Specifica il percorso del file BACPAC nell'agente di automazione o in un percorso UNC accessibile all'agente di automazione, ad esempio \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. Le variabili di sistema predefinite, ad esempio $(agent.releaseDirectory), possono essere usate anche.

SqlFile - SQL Script
string. Obbligatorio quando TaskNameSelector = SqlTask.

Specifica il percorso del file di script SQL nell'agente di automazione o in un percorso UNC accessibile all'agente di automazione, ad esempio \\BudgetIT\Web\Deploy\FabrikamDB.sql. Le variabili di sistema predefinite, ad esempio $(agent.releaseDirectory), possono essere usate anche.

SqlInline - Inline SQL Script
string. Obbligatorio quando TaskNameSelector = InlineSqlTask.

Specifica lo script SQL da eseguire nel database selezionato in precedenza.

PublishProfile - Pubblica profilo
string. facoltativo. Usare quando TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Fornisce un controllo con granularità fine su Azure SQL creazione o aggiornamenti del database.
Specifica il percorso del file XML del profilo di pubblicazione nel computer dell'agente di automazione o in una condivisione UNC. Se il profilo di pubblicazione contiene segreti, ad esempio le credenziali, caricarlo nella libreria dei file sicuri in cui è archiviato in modo sicuro con la crittografia. Usare quindi l'attività Scarica file sicuro all'inizio della pipeline per scaricarla nel computer agente durante l'esecuzione della pipeline. Eliminarlo al termine della pipeline. Le variabili di sistema predefinite, ad esempio $(agent.buildDirectory) o $(agent.releaseDirectory), possono essere usate anche.

AdditionalArguments - Argomenti di SqlPackage.exe aggiuntivi
string. facoltativo. Usare quando TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Specifica gli argomenti aggiuntivi SqlPackage.exe che verranno applicati durante la distribuzione del database Azure SQL se l'opzione DACPAC è selezionata, ad esempio /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Questi argomenti eseguiranno l'override delle impostazioni nel file XML del profilo di pubblicazione (se specificato).

SqlAdditionalArguments - Argomenti di Invoke-Sqlcmd aggiuntivi
string. facoltativo. Usare quando TaskNameSelector = SqlTask.

Specifica gli argomenti di Invoke-Sqlcmd aggiuntivi applicati durante l'esecuzione della query SQL specificata nel database Azure SQL, ad esempio -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - Argomenti di Invoke-Sqlcmd aggiuntivi
string. facoltativo. Usare quando TaskNameSelector = InlineSqlTask.

Specifica gli argomenti di Invoke-Sqlcmd aggiuntivi applicati durante l'esecuzione della query SQL specificata nel database Azure SQL, ad esempio -ConnectionTimeout 100 -OutputSqlErrors.

IpDetectionMethod - Specificare le regole del firewall usando
string. Obbligatorio. Valori consentiti: AutoDetect, IPAddressRange. Valore predefinito: AutoDetect.

Per l'esecuzione dell'attività, l'indirizzo IP dell'agente di automazione deve essere aggiunto agli indirizzi IP consentiti nel firewall del server di Azure SQL. Selezionare Rilevamento automatico per aggiungere automaticamente l'eccezione del firewall per l'intervallo dell'indirizzo IP possibile dell'agente di automazione o specificare in modo esplicito l'intervallo.

StartIpAddress - Avviare l'indirizzo IP
string. Obbligatorio quando IpDetectionMethod = IPAddressRange.

Specifica l'indirizzo IP iniziale del pool di computer dell'agente di automazione, ad esempio 196.21.30.50.

EndIpAddress - Indirizzo IP finale
string. Obbligatorio quando IpDetectionMethod = IPAddressRange.

Specifica l'indirizzo IP finale del pool di computer dell'agente di automazione, ad esempio 196.21.30.65.

DeleteFirewallRule - Elimina regola dopo il termine dell'attività
boolean. Valore predefinito: true.

Se selezionata, al termine dell'attività, gli indirizzi IP specificati qui vengono eliminati dall'elenco Indirizzi IP consentiti nel firewall del server di Azure SQL.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Questa attività definisce le variabili di output seguenti, che è possibile usare nei passaggi, nei processi e nelle fasi downstream.

SqlDeploymentOutputFile
Percorso del file di output generato quando l'azione del pacchetto di distribuzione è Extract, , ExportScript, DriftReporto DeployReport.

Commenti

Usare questa attività per distribuire un database Azure SQL usando un daCPAC o eseguire script usando SQLCMD.

Importante

Questa attività è supportata solo in un ambiente Windows. Se si sta tentando di usare l'autenticazione integrata di Azure Active Directory (Azure AD), è necessario creare un agente privato. L'autenticazione integrata di Azure AD non è supportata per gli agenti ospitati.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Agente
Richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: sqlpackage
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.103.0 o versione successiva
Categoria attività	Distribuire