SqlAzureDacpacDeployment@1 – Azure SQL database deployment v1 feladat

Ezzel a feladattal üzembe helyezhet egy Azure SQL-adatbázist a DACPAC használatával, vagy szkripteket futtathat az SQLCMD használatával.

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.

Bevitelek

azureConnectionType - Azure-szolgáltatás kapcsolattípusa
Bemeneti alias: ConnectedServiceNameSelector. string. Engedélyezett értékek: ConnectedServiceName (Klasszikus Azure), ConnectedServiceNameARM (Azure Resource Manager). Alapértelmezett érték: ConnectedServiceNameARM.

azureClassicSubscription - Klasszikus Azure-előfizetés
Bemeneti alias: ConnectedServiceName. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceName.

Megadja a klasszikus Azure-előfizetést az SQL-fájlok üzembe helyezéséhez.

azureSubscription - Azure-előfizetés
Bemeneti alias: ConnectedServiceNameARM. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceNameARM.

Meghatározza az SQL-fájlok üzembe helyezéséhez használni kívánt Azure Resource Manager-előfizetést.

AuthenticationType - Hitelesítési típus
string. Kötelező. Engedélyezett értékek: server (SQL Server hitelesítés), aadAuthenticationPassword (Active Directory – Jelszó), aadAuthenticationIntegrated (Active Directory – Integrált), connectionString (Kapcsolati sztring), servicePrincipal (Szolgáltatásnév). Alapértelmezett érték: server.

Megadja az adatbázis-hitelesítés típusát. Ez lehet SQL Server, Active Directory (integrált), Active Directory (jelszó), kapcsolati karakterlánc vagy szolgáltatásnév hitelesítése. Az integrált hitelesítés azt jelenti, hogy az ügynök az aktuális Active Directory-fiókkörnyezetével fér hozzá az adatbázishoz.

Adja meg a Azure SQL Server-adatbázishoz való csatlakozás lehetőségét. Megadhatja a Azure SQL Server-adatbázis adatait, a SQL Server kapcsolati karakterlánc, az AD-hitelesítést (jelszó vagy integrált), vagy használhat szolgáltatásnevet. SQL Server hitelesítéshez használja a SQL Server felhasználói hitelesítő adatait. Az AD-hitelesítéshez használja a SQL Server konfigurált AD-felhasználó hitelesítő adatait.

ServerName - Azure SQL Server
string. Akkor szükséges, ha AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

A Azure SQL kiszolgáló nevét adja meg, például Fabrikam.database.windows.net,1433 vagy Fabrikam.database.windows.net.

DatabaseName - Adatbázis
string. Akkor szükséges, ha AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Annak a Azure SQL adatbázisnak a nevét adja meg, amelyben a fájlok üzembe vannak helyezve.

SqlUsername - Logika
string. Akkor szükséges, ha AuthenticationType = server.

Megadja a Azure SQL kiszolgálói rendszergazdai bejelentkezést.

SqlPassword - Jelszó
string. Akkor szükséges, ha AuthenticationType = server.

Megadja a Azure SQL kiszolgáló rendszergazdájának jelszavát. A buildelési vagy kiadási folyamatokban definiált változók $(passwordVariable) elfogadottak. A változótípust biztonságosként secret jelölheti meg.

aadSqlUsername - Logika
string. Akkor szükséges, ha AuthenticationType = aadAuthenticationPassword.

Megadja az Active Directory felhasználónevét.

aadSqlPassword - Jelszó
string. Akkor szükséges, ha AuthenticationType = aadAuthenticationPassword.

Megadja az Active Directory-felhasználó jelszavát. A buildelési vagy kiadási folyamatokban definiált változók $(passwordVariable) elfogadottak. A változótípust biztonságosként secret jelölheti meg.

ConnectionString - Kapcsolati sztring
string. Akkor szükséges, ha AuthenticationType = connectionString.

Megadja a Azure SQL Server kapcsolati karakterlánc, például Server=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);: .

deployType - Üzembe helyezés típusa
Bemeneti alias: TaskNameSelector. string. Kötelező. Engedélyezett értékek: DacpacTask (SQL DACPAC-fájl), SqlTask (SQL-szkriptfájl), InlineSqlTask (beágyazott SQL-szkript). Alapértelmezett érték: DacpacTask.

DeploymentAction - Akció
string. Akkor szükséges, ha TaskNameSelector = DacpacTask. Engedélyezett értékek: Publish, Extract, Export, Import, ScriptDriftReport (Sodródási jelentés), DeployReport (Jelentés üzembe helyezése). Alapértelmezett érték: Publish.

A listából származó SQL-műveletek egyikét adja meg. További információ az SQL-műveletek listájáról.

DacpacFile - DACPAC-fájl
string. Akkor szükséges, ha DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Megadja a DACPAC-fájl helyét az automation-ügynökön vagy egy olyan UNC elérési úton, amely elérhető az automatizálási ügynök számára, például \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Előre definiált rendszerváltozók, például $(agent.releaseDirectory), szintén használhatók.

BacpacFile - BACPAC-fájl
string. Akkor szükséges, ha DeploymentAction = Import.

Megadja a BACPAC-fájl helyét az automation-ügynökön vagy az automatizálási ügynök számára elérhető UNC-elérési úton, például \\BudgetIT\Web\Deploy\FabrikamDB.bacpac: . Előre definiált rendszerváltozók, például $(agent.releaseDirectory), szintén használhatók.

SqlFile - SQL-szkript
string. Akkor szükséges, ha TaskNameSelector = SqlTask.

Az SQL-szkriptfájl helyét határozza meg az automation-ügynökön vagy egy, az automatizálási ügynök számára elérhető UNC elérési úton, például \\BudgetIT\Web\Deploy\FabrikamDB.sql. Előre definiált rendszerváltozók, például $(agent.releaseDirectory), szintén használhatók.

SqlInline - Beágyazott SQL-szkript
string. Akkor szükséges, ha TaskNameSelector = InlineSqlTask.

Megadja a korábban kijelölt adatbázisban végrehajtandó SQL-szkriptet.

PublishProfile - Profil közzététele
string. Választható. Használja a következőt: TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Részletes vezérlést biztosít Azure SQL adatbázis-létrehozás vagy -frissítés felett.
Megadja a profil XML-fájljának közzétételi útvonalát az automation-ügynök gépén vagy egy UNC-megosztáson. Ha a közzétételi profil titkos kulcsokat (például hitelesítő adatokat) tartalmaz, töltse fel azt a biztonságos fájltárba , ahol titkosítással biztonságosan tárolja. Ezután a folyamat elején található Biztonságos fájl letöltése feladat használatával töltse le az ügynökgépre a folyamat futtatásakor. Törölje, amikor a folyamat befejeződött. Előre definiált rendszerváltozók (például $(agent.buildDirectory) vagy $(agent.releaseDirectory)) is használhatók.

AdditionalArguments - További SqlPackage.exe argumentumok
string. Választható. Használja a következőt: TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Megadja azokat a további SqlPackage.exe argumentumokat, amelyeket a Azure SQL adatbázis üzembe helyezésekor alkalmazni fog, ha a DACPAC lehetőség van kiválasztva, például /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Ezek az argumentumok felülbírálják a közzétételi profil XML-fájljának beállításait (ha vannak ilyenek).

SqlAdditionalArguments - További Invoke-Sqlcmd argumentumok
string. Választható. Használja a következőt: TaskNameSelector = SqlTask.

Megadja azokat a további Invoke-Sqlcmd argumentumokat, amelyeket az adott SQL-lekérdezés Azure SQL adatbázison való végrehajtásakor alkalmaznak, például -ConnectionTimeout 100 -OutputSqlErrors: .

InlineAdditionalArguments - További Invoke-Sqlcmd argumentumok
string. Választható. Használja a következőt: TaskNameSelector = InlineSqlTask.

Megadja azokat a további Invoke-Sqlcmd argumentumokat, amelyek a megadott SQL-lekérdezés Azure SQL adatbázison való végrehajtásakor lesznek alkalmazva, például -ConnectionTimeout 100 -OutputSqlErrors: .

IpDetectionMethod - Tűzfalszabályok megadása a használatával
string. Kötelező. Engedélyezett értékek: AutoDetect, IPAddressRange. Alapértelmezett érték: AutoDetect.

A feladat futtatásához az automation-ügynök IP-címét hozzá kell adni az engedélyezett IP-címekhez a Azure SQL kiszolgáló tűzfalán. Az automatikus észlelés lehetőséget választva automatikusan hozzáadhatja a tűzfalkivételt az automation-ügynök lehetséges IP-címének tartományához, vagy explicit módon megadhatja a tartományt.

StartIpAddress - IP-cím indítása
string. Akkor szükséges, ha IpDetectionMethod = IPAddressRange.

Az automatizálási ügynök gépkészletének kezdő IP-címét adja meg, például 196.21.30.50: .

EndIpAddress - Záró IP-cím
string. Akkor szükséges, ha IpDetectionMethod = IPAddressRange.

Az automation-ügynök gépkészletének záró IP-címét adja meg, például 196.21.30.65: .

DeleteFirewallRule - Szabály törlése a tevékenység befejezése után
boolean. Alapértelmezett érték: true.

Ha be van jelölve, a feladat befejezése után az itt megadott IP-címek törlődnek a Azure SQL kiszolgáló tűzfalának Engedélyezett IP-címek listájából.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.

SqlDeploymentOutputFile
A létrehozott kimeneti fájl elérési útja, ha az üzembehelyezési csomag művelete Extract, Export, Script, , DriftReportvagy DeployReport.

Megjegyzések

Ezzel a feladattal üzembe helyezhet egy Azure SQL-adatbázist DACPAC használatával, vagy szkripteket futtathat az SQLCMD használatával.

Fontos

Ez a feladat csak Windows-környezetben támogatott. Ha az Azure Active Directory (Azure AD) integrált hitelesítését kívánja használni, létre kell hozni egy privát ügynököt. Az Azure AD integrált hitelesítése bérelt ügynöknél nem támogatott.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás	Ügynök
Igények	A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: sqlpackage
Képességek	Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	1.103.0 vagy újabb
Feladatkategória	Üzembe helyezés