SqlPackage CLI-referencia

Az SqlPackage egy parancssori segédprogram az adatbázisok hordozhatóságához és a Windows, Linux és macOS környezetekben történő üzembe helyezéséhez. Az SqlPackage parancssori felülete (CLI) elemzi a paraméterek, tulajdonságok és SQLCMD-változók minden egyes meghívását.

SqlPackage {parameters} {properties} {SQLCMD variables}

• paraméterekkel adhatja meg a végrehajtandó műveletet, a forrás- és céladatbázisokat, valamint egyéb általános beállításokat.
• Tulajdonságok egy művelet alapértelmezett viselkedésének módosítására szolgál.
• SQLCMD-változók az értékek forrásfájlban lévő SQLCMD-változóinak való átadására szolgálnak.

SqlPackage-parancs létrehozásához meg kell adnia egy műveletet és annak további paramétereit. Igény szerint tulajdonságokat és SQLCMD-változókat is hozzáadhat a parancs további testreszabásához.

Az alábbi példában az SqlPackage az aktuális adatbázisséma .dacpac fájljának létrehozására szolgál:

SqlPackage /Action:Extract /TargetFile:"C:\sqlpackageoutput\output_current_version.dacpac" \
 /SourceServerName:"localhost" /SourceDatabaseName:"Contoso" \
 /p:IgnoreUserLoginMappings=True /p:Storage=Memory

Ebben a példában a paraméterek a következőek voltak:

• /Action:Extract
• /TargetFile:"C:\sqlpackageoutput\output_current_version.dacpac"
• /SourceServerName:"localhost"
• /SourceDatabaseName:"Contoso"

Ebben a példában a tulajdonságok a következők voltak:

• /p:IgnoreUserLoginMappings=True
• /p:Storage=Memory

SqlPackage-műveletek

• Verzió: Az SqlPackage alkalmazás buildszámát adja vissza.

• kinyerése: Létrehoz egy adatrétegű alkalmazásfájlt (.dacpac), amely egy csatlakoztatott SQL-adatbázis sémáját vagy sémáját és felhasználói adatait tartalmazza.

• Közzétételi: Az adatbázisséma növekményes frissítése a forrás .dacpac fájl sémájának megfelelően. Ha az adatbázis nem létezik a kiszolgálón, a közzétételi művelet létrehozza azt. Ellenkező esetben egy meglévő adatbázis frissül.

• exportálása: Csatlakoztatott SQL-adatbázis exportálása – beleértve az adatbázissémát és a felhasználói adatokat is – BACPAC-fájlba (.bacpac).

• Importálási: A séma- és táblaadatokat egy BACPAC-fájlból importálja egy új felhasználói adatbázisba.

• DeployReport: Létrehoz egy XML-jelentést, amely a közzétételi művelet által végrehajtott módosításokat jelöli.

• DriftReport: Létrehoz egy XML-jelentést, amely a regisztrált adatbázisra az utolsó regisztráció óta alkalmazott módosításokat jelöli.

• szkript: Létrehoz egy Transact-SQL növekményes frissítési szkriptet, amely frissíti a cél sémáját a forrás sémájának megfelelően.

Jegyzet

Bár a Microsoft Entra ID az Azure Active Directory (Azure AD) új neve, a meglévő környezetek megzavarásának megakadályozása érdekében az Azure AD továbbra is megmarad néhány rögzített elemben, például felhasználói felületi mezőkben, kapcsolatszolgáltatókban, hibakódokban és parancsmagokban. Ebben a cikkben a két név felcserélhető.

Paraméterek

Egyes paraméterek meg vannak osztva az SqlPackage-műveletek között. Az alábbiakban egy, a paramétereket összegző táblázatot talál, amely további információkért kattintson az adott műveletoldalakra.

Paraméter	Rövid űrlap	kinyerés	Közzétételi	exportálási	Importálás	DeployReport	DriftReport	szkript
/AccessToken:	/at	x	x	x	x	x	x	x
/ClientId:	/cid		x
/DeployScriptPath:	/dsp		x					x
/DeployReportPath:	/drp		x					x
/Diagnosztika:	/d	x	x	x	x	x	x	x
/DiagnosticsFile:	/df	x	x	x	x	x	x	x
/DiagnosticsPackageFile:	/dpf		x		x
/MaxParallelism:	/mp	x	x	x	x	x	x	x
/OutputPath:	/op					x	x	x
/OverwriteFiles:	/of	x	x	x		x	x	x
/Profil:	/pr		x			x		x
/Tulajdonságok:	/p	x	x	x	x	x		x
/Quiet:	/q	x	x	x	x	x	x	x
/Titkos:	/secr		x
/SourceConnectionString:	/scs	x	x	x		x		x
/SourceDatabaseName:	/sdn	x	x	x		x		x
/SourceEncryptConnection:	/mp	x	x	x		x		x
/SourceFile:	/sf		x		x	x		x
/SourcePassword:	/sp	x	x	x		x		x
/SourceServerName:	/ssn	x	x	x		x		x
/SourceTimeout:	/st	x	x	x		x		x
/SourceTrustServerCertificate:	/stsc	x	x	x		x		x
/SourceUser:	/su	x	x	x		x		x
/TargetConnectionString:	/tcs				x	x	x	x
/TargetDatabaseName:	/tdn		x		x	x	x	x
/TargetEncryptConnection:	/tec		x		x	x	x	x
/TargetFile:	/tf	x		x		x		x
/TargetPassword:	/tp		x		x	x	x	x
/TargetServerName:	/tsn		x		x	x	x	x
/TargetTimeout:	/tt		x		x	x	x	x
/TargetTrustServerCertificate:	/ttsc		x		x	x	x	x
/TargetUser:	/tu		x		x	x	x	x
/TenantId:	/tid	x	x	x	x	x	x	x
/UniversalAuthentication:	/ua	x	x	x	x	x	x	x
/Változók:	/v					x		x

Kellékek

Az SqlPackage-műveletek számos tulajdonságot támogatnak egy művelet alapértelmezett viselkedésének módosításához. A tulajdonságok opcionális használata /p:PropertyName=Value parancssorba való hozzáadásával valósítható meg. Több tulajdonság is megadható, egyes tulajdonságok pedig többször is megadhatóak (például /p:TableData=Product /p:TableData=ProductCategory). A tulajdonságokról további információt az adott műveletoldalakon talál.

SQLCMD-változók

Az SQLCMD-változók egy SQL-projektből származó .dacpac fájlba építhetők be, majd az SqlPackage Publish vagy Scripthasználatával állíthatók be. Az SQLCMD-változók SQL-projektekhez való hozzáadásáról további információt az SQL-projektek dokumentációjában .

Segédprogramparancsok

Verzió

Az sqlpackage verziót buildszámként jeleníti meg. Használható interaktív parancssorokban és automatizált folyamatokban.

SqlPackage /Version

Segítség

Az SqlPackage használati adatait /? vagy /help:Truehasználatával jelenítheti meg.

SqlPackage /?

Az adott műveletre vonatkozó paraméter- és tulajdonságinformációkhoz használja a súgóparamétert a művelet paraméterén kívül.

SqlPackage /Action:Publish /?

Kilépési kódok

Az SqlPackage parancsok a következő kilépési kódokat adják vissza:

• 0 = siker
• nonzero = hiba

Következő lépések

• További információ SqlPackage extract
• További információ az SqlPackage Publish
• További információ az SqlPackage Export
• További információ az SqlPackage importálási
• További információ az SqlPackage hibaelhárítási problémáiról
• Visszajelzés megosztása az SqlPackage-ről a DacFx GitHub-adattárban