Aracılığıyla paylaş

SqlPackage CLI başvurusu

SqlPackage, Windows, Linux ve macOS ortamlarında veritabanı taşınabilirliği ve dağıtımları için bir komut satırı yardımcı programıdır. SqlPackage komut satırı arabirimi (CLI), parametreler, özellikler ve SQLCMD değişkenleri için her çağrıyı ayrıştırıyor.

SqlPackage {parameters} {properties} {SQLCMD variables}
  • Parametreler gerçekleştirilecek eylemi, kaynak ve hedef veritabanlarını ve diğer genel ayarları belirtir.
  • Özellikler bir eylemin varsayılan davranışını değiştirir.
  • SQLCMD değişkenleri , kaynak dosyadaki SQLCMD değişkenlerine değerleri geçirir.

SqlPackage komutu oluşturmak için bir eylem ve ek parametrelerini belirtin. İsteğe bağlı olarak, komutu daha fazla özelleştirmek için özellikler ve SQLCMD değişkenleri ekleyin.

Aşağıdaki örnek, geçerli veritabanı şemasının dosyasını .dacpac oluşturmak için SqlPackage'ı kullanır:

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

Bu örnekteki parametreler şunlardır:

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

Bu örnekteki özellikler şunlardır:

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

SqlPackage eylemleri

Eylem Description
Sürüm SqlPackage uygulamasının derleme numarasını döndürür.
Ayıklama Bağlı bir SQL veritabanından şemayı veya şemayı ve kullanıcı verilerini içeren bir veri katmanı uygulaması (.dacpac) dosyası oluşturur.
Yayımlama Veritabanı şemasını bir kaynak .dacpac dosyanın şemasıyla eşleşecek şekilde artımlı olarak güncelleştirir. Veritabanı sunucuda yoksa yayımlama işlemi bunu oluşturur. Aksi takdirde, mevcut bir veritabanı güncelleştirilir.
Dışarı Aktarma Veritabanı şeması ve kullanıcı verileri dahil olmak üzere bağlı bir SQL veritabanını bir BACPAC dosyasına (.bacpac ) aktarır.
İçeri Aktarma Şema ve tablo verilerini bir BACPAC dosyasından yeni bir kullanıcı veritabanına aktarır.
DeployReport Yayımlama eyleminin gerçekleştireceği değişiklikleri temsil eden bir XML raporu oluşturur.
DriftReport Kayıtlı veritabanına son kaydedildiğinden bu yana uygulanan değişiklikleri temsil eden bir XML raporu oluşturur.
Betik Hedefin şemasını bir kaynağın şemasıyla eşleşecek şekilde güncelleştiren bir Transact-SQL artımlı güncelleştirme betiği oluşturur.

Not

Microsoft Entra ID, Azure Active Directory (Azure AD) içinyeni ad olsa da, mevcut ortamların kesintiye uğramasını önlemek için Azure AD yine de kullanıcı arabirimi alanları, bağlantı sağlayıcıları, hata kodları ve cmdlet'ler gibi sabit kodlanmış bazı öğelerde kalır. Bu makalede, iki ad birbirinin yerine kullanılabilir.

Parametre

Bazı parametreler SqlPackage eylemleri arasında paylaşılır. Aşağıdaki tabloda parametreler özetlemektedir. Daha fazla bilgi için, belirli eylem sayfalarını ziyaret etmek için tablo başlığındaki bağlantıları kullanın.

Parametre Kısa Form Ayıklama Yayımlama Dışarı Aktarma İçeri Aktarma DeployReport DriftReport Betik
/AccessToken: /at Yes Yes Yes Yes Yes Yes Yes
/ClientId: /cid Hayı Yes Hayı Hayı Hayı Hayı Hayı
/DeployScriptPath: /dsp Hayı Yes Hayı Hayı Hayı Hayı Yes
/DeployReportPath: /drp Hayı Yes Hayı Hayı Hayı Hayı Yes
/Diagnostics: /d Yes Yes Yes Yes Yes Yes Yes
/DiagnosticsFile: /df Yes Yes Yes Yes Yes Yes Yes
/DiagnosticsPackageFile: /dpf Hayı Yes Hayı Yes Hayı Hayı Hayı
/MaxParallelism: /mp Yes Yes Yes Yes Yes Yes Yes
/OutputPath: /op Hayı Hayı Hayı Hayı Yes Yes Yes
/OverwriteFiles: /of Yes Yes Yes Hayı Yes Yes Yes
/Profile: /pr Hayı Yes Hayı Hayı Yes Hayı Yes
/Properties: /p Yes Yes Yes Yes Yes Hayı Yes
/Quiet: /q Yes Yes Yes Yes Yes Yes Yes
/Secret: /secr Hayı Yes Hayı Hayı Hayı Hayı Hayı
/SourceConnectionString: /scs Yes Yes Yes Hayı Yes Hayı Yes
/SourceDatabaseName: /sdn Yes Yes Yes Hayı Yes Hayı Yes
/SourceEncryptConnection: /sec Yes Yes Yes Hayı Yes Hayı Yes
/SourceFile: /sf Hayı Yes Hayı Yes Yes Hayı Yes
/SourcePassword: /sp Yes Yes Yes Hayı Yes Hayı Yes
/SourceServerName: /ssn Yes Yes Yes Hayı Yes Hayı Yes
/SourceTimeout: /st Yes Yes Yes Hayı Yes Hayı Yes
/SourceTrustServerCertificate: /stsc Yes Yes Yes Hayı Yes Hayı Yes
/SourceUser: /su Yes Yes Yes Hayı Yes Hayı Yes
/TargetConnectionString: /tcs Hayı Hayı Hayı Yes Yes Yes Yes
/TargetDatabaseName: /tdn Hayı Yes Hayı Yes Yes Yes Yes
/TargetEncryptConnection: /tec Hayı Yes Hayı Yes Yes Yes Yes
/TargetFile: /tf Yes Hayı Yes Hayı Yes Hayı Yes
/TargetPassword: /tp Hayı Yes Hayı Yes Yes Yes Yes
/TargetServerName: /tsn Hayı Yes Hayı Yes Yes Yes Yes
/TargetTimeout: /tt Hayı Yes Hayı Yes Yes Yes Yes
/TargetTrustServerCertificate: /ttsc Hayı Yes Hayı Yes Yes Yes Yes
/TargetUser: /tu Hayı Yes Hayı Yes Yes Yes Yes
/TenantId: /tid Yes Yes Yes Yes Yes Yes Yes
/UniversalAuthentication: /ua Yes Yes Yes Yes Yes Yes Yes
/Variables: /v Hayı Hayı Hayı Hayı Yes Hayı Yes

Özellikler

SqlPackage eylemleri, bir eylemin varsayılan davranışını değiştirmek için birçok özelliği destekler. İsteğe bağlı olarak özellikleri kullanmak için komut satırına ekleyin /p:PropertyName=Value . Birden çok özellik belirtebilir ve bazı özellikleri birden çok kez belirtebilirsiniz. Örneğin, kullanabilirsiniz /p:TableData=Product /p:TableData=ProductCategory. Özellikler hakkında daha fazla bilgi için belirli eylem sayfalarına bakın.

SQLCMD değişkenleri

SQLCMD değişkenlerini bir SQL projesinden bir .dacpac dosyaya oluşturabilirsiniz. SqlPackage Yayımlama veya Betik kullanarak dağıtım sırasında bu değişkenleri ayarlayın. SQL projesine SQLCMD değişkenleri ekleme hakkında daha fazla bilgi için bkz. SQL Veritabanı Projeleri uzantısı.

Yardımcı program komutları

Sürüm

sqlpackage sürümünü derleme numarası olarak görüntüler. Etkileşimli istemlerde ve otomatik işlem hatlarında kullanın.

SqlPackage /Version

Yardım

SqlPackage kullanım bilgilerini görüntülemek için veya /help:True kullanın/?.

SqlPackage /?

Belirli bir eyleme özgü parametre ve özellik bilgileri için, bu eylemin parametresine ek olarak yardım parametresini kullanın.

SqlPackage /Action:Publish /?

Çıkış kodları

SqlPackage komutları aşağıdaki çıkış kodlarını döndürür:

  • 0 = başarı
  • sıfır olmayan = hata

İlgili içerik

  • Last updated on