Sdílet prostřednictvím

Referenční informace k rozhraní příkazového řádku SqlPackage

SqlPackage je nástroj příkazového řádku pro přenositelnost a nasazení databáze v prostředích s Windows, Linuxem a macOS. Rozhraní příkazového řádku SqlPackage (CLI) analyzuje každé vyvolání parametrů, vlastností a proměnných SQLCMD.

SqlPackage {parameters} {properties} {SQLCMD variables}
  • Parametry určují akci, která se má provést, zdrojové a cílové databáze a další obecná nastavení.
  • Vlastnosti upravují výchozí chování akce.
  • Proměnné SQLCMD předávají hodnoty proměnným SQLCMD ve zdrojovém souboru.

Pokud chcete vytvořit příkaz SqlPackage, zadejte akci a její další parametry. Volitelně můžete přidat vlastnosti a proměnné SQLCMD pro další přizpůsobení příkazu.

Následující příklad používá SqlPackage k vytvoření .dacpac souboru aktuálního schématu databáze:

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

Toto jsou parametry z tohoto příkladu:

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

Toto jsou vlastnosti z tohoto příkladu:

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

Akce SqlPackage

Činnost Description
Verze Vrátí číslo sestavení aplikace SqlPackage.
extrahování Vytvoří soubor aplikace datové vrstvy obsahující.dacpac schéma nebo schéma a uživatelská data z připojené databáze SQL.
publikovat Přírůstkově aktualizuje schéma databáze tak, aby odpovídalo schématu zdrojového .dacpac souboru. Pokud databáze na serveru neexistuje, operace publikování ji vytvoří. V opačném případě se aktualizuje existující databáze.
exportu Exportuje připojenou databázi SQL včetně schématu databáze a uživatelských dat do souboru BACPAC (.bacpac).
importu Importuje data schématu a tabulky ze souboru BACPAC do nové uživatelské databáze.
DeployReport Vytvoří sestavu XML představující změny, které by akce publikování podnikla.
DriftReport Vytvoří sestavu XML představující změny použité u registrované databáze od poslední registrace.
skriptů Vytvoří skript přírůstkové aktualizace Jazyka Transact-SQL, který aktualizuje schéma cíle tak, aby odpovídalo schématu zdroje.

Poznámka

I když je ID Microsoft Entra novým názvem proAzure Active Directory (Azure AD), aby se zabránilo narušení existujících prostředí, Azure AD stále zůstává v některých pevně zakódovaných prvcích, jako jsou pole uživatelského rozhraní, zprostředkovatelé připojení, kódy chyb a rutiny. V tomto článku jsou tyto dva názvy zaměnitelné.

Parametry

Některé parametry jsou sdíleny mezi akcemi SqlPackage. Následující tabulka shrnuje parametry. Další informace najdete na konkrétních stránkách akcí pomocí odkazů v záhlaví tabulky.

Parametr Krátký formulář extrahování publikovat exportu importu DeployReport DriftReport skriptů
/AccessToken: /at Ano Ano Ano Ano Ano Ano Ano
/ClientId: /cid Ne Ano Ne Ne Ne Ne Ne
/DeployScriptPath: /dsp Ne Ano Ne Ne Ne Ne Ano
/DeployReportPath: /drp Ne Ano Ne Ne Ne Ne Ano
/Diagnostics: /d Ano Ano Ano Ano Ano Ano Ano
/DiagnosticsFile: /df Ano Ano Ano Ano Ano Ano Ano
/DiagnosticsPackageFile: /dpf Ne Ano Ne Ano Ne Ne Ne
/MaxParallelism: /mp Ano Ano Ano Ano Ano Ano Ano
/OutputPath: /op Ne Ne Ne Ne Ano Ano Ano
/OverwriteFiles: /of Ano Ano Ano Ne Ano Ano Ano
/Profile: /pr Ne Ano Ne Ne Ano Ne Ano
/Properties: /p Ano Ano Ano Ano Ano Ne Ano
/Quiet: /q Ano Ano Ano Ano Ano Ano Ano
/Secret: /secr Ne Ano Ne Ne Ne Ne Ne
/SourceConnectionString: /scs Ano Ano Ano Ne Ano Ne Ano
/SourceDatabaseName: /sdn Ano Ano Ano Ne Ano Ne Ano
/SourceEncryptConnection: /sec Ano Ano Ano Ne Ano Ne Ano
/SourceFile: /sf Ne Ano Ne Ano Ano Ne Ano
/SourcePassword: /sp Ano Ano Ano Ne Ano Ne Ano
/SourceServerName: /ssn Ano Ano Ano Ne Ano Ne Ano
/SourceTimeout: /st Ano Ano Ano Ne Ano Ne Ano
/SourceTrustServerCertificate: /stsc Ano Ano Ano Ne Ano Ne Ano
/SourceUser: /su Ano Ano Ano Ne Ano Ne Ano
/TargetConnectionString: /tcs Ne Ne Ne Ano Ano Ano Ano
/TargetDatabaseName: /tdn Ne Ano Ne Ano Ano Ano Ano
/TargetEncryptConnection: /tec Ne Ano Ne Ano Ano Ano Ano
/TargetFile: /tf Ano Ne Ano Ne Ano Ne Ano
/TargetPassword: /tp Ne Ano Ne Ano Ano Ano Ano
/TargetServerName: /tsn Ne Ano Ne Ano Ano Ano Ano
/TargetTimeout: /tt Ne Ano Ne Ano Ano Ano Ano
/TargetTrustServerCertificate: /ttsc Ne Ano Ne Ano Ano Ano Ano
/TargetUser: /tu Ne Ano Ne Ano Ano Ano Ano
/TenantId: /tid Ano Ano Ano Ano Ano Ano Ano
/UniversalAuthentication: /ua Ano Ano Ano Ano Ano Ano Ano
/Variables: /v Ne Ne Ne Ne Ano Ne Ano

Vlastnosti

Akce SqlPackage podporují mnoho vlastností pro úpravu výchozího chování akce. Přidáním /p:PropertyName=Value na příkazový řádek můžete volitelně použít vlastnosti. Můžete zadat více vlastností a zadat některé vlastnosti více než jednou. Můžete například použít /p:TableData=Product /p:TableData=ProductCategory. Další informace o vlastnostech najdete na konkrétních stránkách akcí.

Proměnné SQLCMD

Proměnné SQLCMD můžete sestavit do .dacpac souboru z projektu SQL. Nastavte tyto proměnné během nasazování pomocí nástroje SqlPackage Publish nebo Script. Další informace o přidání proměnných SQLCMD do projektu SQL naleznete v tématu Rozšíření projektů služby SQL Database.

Příkazy nástroje

Verze

Zobrazí verzi sqlpackage jako číslo buildu. Používejte ho v interaktivních výzev a v automatizovaných kanálech.

SqlPackage /Version

Pomoc

Použijte /? nebo /help:True zobrazte informace o využití SqlPackage.

SqlPackage /?

Informace o parametrech a vlastnostech specifické pro konkrétní akci použijte kromě parametru této akce také parametr nápovědy.

SqlPackage /Action:Publish /?

Ukončovací kódy

Příkazy SqlPackage vrátí následující ukončovací kódy:

  • 0 = úspěch
  • nonzero = selhání

Související obsah

  • Last updated on