Megosztás a következőn keresztül:

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}
  • A paraméterek határozzák meg a végrehajtandó műveletet, a forrás- és céladatbázisokat, valamint az egyéb általános beállításokat.
  • A tulajdonságok módosítják egy művelet alapértelmezett viselkedését.
  • Az SQLCMD-változók átadják az értékeket a forrásfájl SQLCMD-változóinak.

SqlPackage-parancs létrehozásához adjon meg egy műveletet és annak további paramétereit. Ha szeretné, adjon hozzá tulajdonságokat és SQLCMD-változókat a parancs további testreszabásához.

Az alábbi példa az SqlPackage használatával hozza létre .dacpac az aktuális adatbázisséma fájlját:

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

A példában szereplő paraméterek a következők:

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

A példában szereplő tulajdonságok a következők:

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

SqlPackage-műveletek

Tevékenység Description
verzió Az SqlPackage alkalmazás buildszámát adja vissza.
kinyerés 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 Növekményesen frissíti az adatbázisséma egy forrásfájl .dacpac sémáját. 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ási Csatlakoztatott SQL-adatbázist exportál egy BACPAC-fájlba (.bacpacbeleértve az adatbázissémát és a felhasználói adatokat is).
Importálás Importálja a séma- és táblaadatokat egy BACPAC-fájlból egy új felhasználói adatbázisba.
DeployReport Létrehoz egy XML-jelentést, amely azokat a módosításokat jelöli, amelyeket egy közzétételi művelet végrehajtana.
DriftReport Létrehoz egy XML-jelentést, amely a regisztrált adatbázisokra 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ábbi táblázat összefoglalja a paramétereket. További információkért a táblázat fejlécében található hivatkozásokkal keresse fel az adott műveletoldalakat.

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

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. Adja hozzá /p:PropertyName=Value a parancssorhoz a tulajdonságok opcionális használatához. Több tulajdonságot is megadhat, és egyes tulajdonságokat többször is megadhat. Használhatja például a következőt: /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

SQLCMD-változókat egy SQL-projektből származó fájlba .dacpac hozhat létre. Állítsa be ezeket a változókat az üzembe helyezés során az SqlPackage Publish vagy a Script használatával. Az SQLCMD-változók SQL-projektekhez való hozzáadásáról további információt az SQL Database Projects bővítményben talál.

Segédprogramparancsok

Verzió

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

SqlPackage /Version

Segítség

Az SqlPackage használati adatainak használata /? vagy /help:True megjelenítése.

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

Kapcsolódó tartalom

  • Last updated on