SqlAzureDacpacDeployment@1 - Attività distribuzione del database SQL di Azure v1

Usare questa attività per distribuire un database SQL di Azure usando 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.

Ingressi dati

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

azureClassicSubscription - della 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 (autenticazione di SQL Server), aadAuthenticationPassword (Active Directory - Password), aadAuthenticationIntegrated (Active Directory - Integrated), connectionString (stringa di connessione), servicePrincipal (entità servizio). Valore predefinito: server

Specifica il tipo di autenticazione del database. Può essere un'autenticazione di SQL Server, Active Directory (integrata), Active Directory (password), stringa di connessione o 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 di SQL Server di Azure. È possibile specificare i dettagli del database SQL Server di Azure, la stringa di connessione di SQL Server, l'autenticazione di AD (password o integrata) o usare un'entità servizio. Per l'autenticazione di SQL Server, usare le credenziali utente di SQL Server. Per l'autenticazione di ACTIVE Directory, usare le credenziali per l'utente di ACTIVE Directory configurato per SQL Server.

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

Specifica il nome di Azure SQL Server, ad esempio Fabrikam.database.windows.net.placeholder,1433 o Fabrikam.database.windows.net.placeholder.

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

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

SqlUsername - account di accesso
string. Obbligatorio quando AuthenticationType = server.

Specifica l'account di accesso amministratore di SQL Server di Azure.

SqlPassword - password
string. Obbligatorio quando AuthenticationType = server.

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

aadSqlUsername - account di accesso
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 come secret per proteggerlo.

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

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

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

DeploymentAction - 'azione
string. Obbligatorio quando TaskNameSelector = DacpacTask. Valori consentiti: Publish, Extract, Export, Import, Script, DriftReport (rapporto di deriva), DeployReport (distribuisci report). Valore predefinito: Publish

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

DacpacFile - file DACPAC
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. È anche possibile usare variabili di sistema predefinite, ad esempio $(agent.releaseDirectory).

BacpacFile - file BACPAC
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. È anche possibile usare variabili di sistema predefinite, ad esempio $(agent.releaseDirectory).

SqlFile - script SQL
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. È anche possibile usare variabili di sistema predefinite, ad esempio $(agent.releaseDirectory).

SqlInline - script SQL inline
string. Obbligatorio quando TaskNameSelector = InlineSqlTask.

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

profilo di pubblicazione PublishProfile -
string. Opzionale. Usare quando TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Fornisce un controllo dettagliato sulla creazione o sugli aggiornamenti del database SQL di Azure.
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 file sicuri libreria in cui è archiviato in modo sicuro con la crittografia. Successivamente, usare l 'attività Download secure file all'inizio della pipeline per scaricarla nel computer dell'agente quando viene eseguita la pipeline. Eliminarlo al termine della pipeline. È anche possibile usare variabili di sistema predefinite, ad esempio $(agent.buildDirectory) o $(agent.releaseDirectory).

AdditionalArguments - argomenti aggiuntivi SqlPackage.exe
string. Opzionale. 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 SQL di Azure se è selezionata l'opzione DACPAC, ad esempio /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Questi argomenti sostituiranno le impostazioni nel file XML del profilo di pubblicazione (se specificato).

SqlAdditionalArguments - argomenti aggiuntivi Invoke-Sqlcmd
string. Opzionale. Usare quando TaskNameSelector = SqlTask.

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

InlineAdditionalArguments - argomenti aggiuntivi Invoke-Sqlcmd
string. Opzionale. Usare quando TaskNameSelector = InlineSqlTask.

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

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

Affinché l'attività venga eseguita, è necessario aggiungere l'indirizzo IP dell'agente di automazione all'Indirizzi IP consentiti nel firewall di SQL Server di Azure. Selezionare Rilevamento automatico per aggiungere automaticamente l'eccezione del firewall per l'intervallo dell'indirizzo IP possibile dell'agente di automazione oppure specificare l'intervallo in modo esplicito.

StartIpAddress - Start IP Address
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 al termine dell'attività
boolean. Valore predefinito: true

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

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 utilizzare nei passaggi downstream, nei processi e nelle fasi.

SqlDeploymentOutputFile
Percorso del file di output generato quando l'azione del pacchetto di distribuzione viene Extract, Export, Script, DriftReporto DeployReport.

Osservazioni:

Usare questa attività per distribuire un database SQL di Azure usando un pacchetto di applicazione livello dati o eseguire script usando SQLCMD.

Importante

Questa attività è supportata solo in un ambiente Windows. Se si sta provando a 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
Viene eseguito in	Agente
richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: sqlpackage
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	1.103.0 o versione successiva
Categoria attività	Distribuire