SqlPackage Script 動作建立的 Transact-SQL 累加式更新指令碼會更新目標資料庫的結構描述，使其符合來源資料庫的結構描述。
注意
雖然 Microsoft Entra ID 是 Azure Active Directory（Azure AD）的新名稱，但為了防止破壞現有的環境，Azure AD 仍會保留在某些硬式編碼元素中，例如 UI 字段、連線提供者、錯誤碼和 Cmdlet。 在本文中，這兩個名稱是可互換的。
命令列語法
SqlPackage 會使用命令列上指定的參數、屬性和 SQLCMD 變數來起始指定的動作。
SqlPackage {parameters}{properties}{SQLCMD Variables}
Script 動作的參數
| 參數 | 簡短形式 | 價值 | 描述 |
|---|---|---|---|
| /AccessToken: | /at | {string} | 指定要在連接到目標資料庫時使用的以權杖為基礎的驗證存取權杖。 |
| /動作: | /a: | 劇本 | 指定要執行的動作。 |
| /AzureCloudConfig： | /acc: | {string} | 指定用於連線至 Microsoft Entra ID 的自訂端點，格式為：AzureActiveDirectoryAuthority={value};DatabaseServicePrincipalName={value}"。 |
| /DeployReportPath: | /drp: | {string} | 指定選擇性檔案路徑來輸出部署報表 XML 檔案。 |
| /DeployScriptPath: | /dsp: | {string} | 指定選擇性檔案路徑來輸出部署指令碼。 對於 Azure 部署，若有 Transact-SQL 命令要建立或修改 master 資料庫，將會對指令碼寫入相同的路徑，但會使用 "Filename_Master.sql" 做為輸出檔案名稱。 |
| /診斷： | /d: | {真|假} | 指定診斷記錄是否輸出到主控台。 預設為 False。 |
| /DiagnosticsFile: | /df: | {string} | 指定要儲存診斷記錄的檔案。 |
| /DiagnosticsLevel： | /dl | {無|停用|重大|錯誤|警告|資訊|詳細} | 指定篩選後的診斷檔案中的追蹤訊息層級 |
| /MaxParallelism: | /mp: | {int} | 指定針對資料庫執行之並行作業的平行處理原則的程度。 預設值為 8。 |
| /ModelFilePath： | /mfp: | {string} | 指定要覆寫來源檔案中 model.xml 的檔案路徑。 使用此設定可能會導致部署失敗和/或非預期的資料遺失。 此設定僅用於針對發佈、匯入或指令碼產生問題進行疑難排解時。 |
| /OutputPath: | /op: | {string} | 指定輸出檔案產生位置的檔案路徑。 |
| /OverwriteFiles: | /of: | {真|假} | 指定 SqlPackage 是否應該覆寫現有的檔案。 指定 False 會導致 SqlPackage 在遇到現有的檔案時中止動作。 預設值是 True。 |
| /Profile: | /pr: | {string} | 指定 DAC 發行設定檔的檔案路徑。 設定檔會定義產生輸出時要使用之屬性及變數的集合。 |
| /屬性: | /p: | {PropertyName}={Value} | 指定動件專用屬性的名稱/值對：{PropertyName}={Value}。 |
| /安靜: | /q: | {真|假} | 指定是否隱藏詳細的意見反應。 預設為 False。 |
| /ReferencePaths： | /rp: | {PropertyName}={Value} | 指定要用於搜尋 .dacpac 參考的其他目錄。 |
| /SourceFile： | /sf: | {string} | 指定要當作動作來源使用的來源檔案。 如果使用了此參數，其他來源參數都應該無效。 |
| /SourceConnectionString: | /scs: | {string} | 指定對來源資料庫有效的 SQL Server/Azure 連接字串。 如果指定了此參數，就應該以獨佔方式將其用於所有其他來源參數。 |
| /SourceDatabaseName: | /sdn: | {string} | 定義來源資料庫的名稱。 |
| /SourceEncryptConnection: | /sec: | {Optional|Mandatory|Strict|True|False} | 指定 SQL 加密是否應該用於來源資料庫連接。 預設值是 True。 |
| /SourceHostNameInCertificate： | /shnic: | {string} | 指定使用 TLS 加密通訊層時，用來驗證來源 SQL Server TLS/SSL 憑證的值。 |
| /SourcePassword: | /sp: | {string} | 若為 SQL Server 驗證案例，則定義要用來存取來源資料庫的密碼。 |
| /SourceServerName： | /ssn: | {string} | 定義裝載來源資料庫的伺服器名稱。 |
| /SourceTimeout: | /st: | {int} | 指定連接至來源資料庫的逾時時間（以秒為單位）。 |
| /SourceTrustServerCertificate: | /stsc: | {真|假} | 指定是否要使用 TLS 來加密來源資料庫連線並且略過驗證信任的憑證鏈結。 預設值為 False。 |
| /SourceUser: | /su: | {string} | 若為 SQL Server 驗證案例，則定義要用來存取來源資料庫的 SQL Server 使用者。 |
| /TargetFile: | /tf: | {string} | 指定作為動作目標使用的目標檔案 (即 .dacpac 檔案)，而非資料庫。 如果使用此參數，其他目標參數都應該無效。 這個參數對僅支援資料庫目標的動作而言應無效。 |
| /TargetConnectionString: | /tcs: | {string} | 指定對目標資料庫有效的 SQL Server/Azure 連接字串。 如果指定此參數，就應該以獨佔方式將它用於所有其他目標參數。 |
| /TargetDatabaseName: | /tdn: | {string} | 指定覆寫作為 SqlPackage 動作目標的資料庫名稱。 |
| /TargetEncryptConnection: | /tec: | {選擇性|強制性|嚴格|真|假} | 指定 SQL 加密是否應該用於目標資料庫連線。 預設值是 True。 |
| /TargetHostNameInCertificate： | /民族: | {string} | 指定使用 TLS 加密通訊層時，用來驗證目標 SQL Server TLS/SSL 憑證的值。 |
| /TargetPassword: | /tp: | {string} | 若為 SQL Server 驗證案例，則定義要用來存取目標資料庫的密碼。 |
| /TargetServerName： | /tsn: | {string} | 定義裝載目標資料庫的伺服器名稱。 |
| /TargetTimeout: | /tt: | {int} | 指定建立目標資料庫連線的逾時 (以秒為單位)。 針對 Microsoft Entra ID，此值建議大於或等於 30 秒。 |
| /TargetTrustServerCertificate: | /ttsc: | {真|假} | 指定是否要使用 TLS 來加密目標資料庫連線並略過驗證信任的憑證鏈結。 預設值為 False。 |
| /TargetUser: | /tu: | {string} | 若為 SQL Server 驗證案例，則定義要用以存取目標資料庫的 SQL Server 使用者。 |
| /TenantId: | /tid: | {string} | 代表 Microsoft Entra 租用戶 ID 或網域名稱。 支援 Microsoft Entra 來賓使用者以及 outlook.com、hotmail.com 或 live.com 等 Microsoft 帳戶時，這是必要選項。 假設已驗證使用者是此租用戶的原生使用者，則若省略此參數，即會使用 Microsoft Entra ID 的預設租用戶 ID。 不過，在此情況下，不支援任何來賓使用者或在此 Microsoft Entra ID 中託管的 Microsoft 帳戶，且作業會失敗。 |
| /ThreadMaxStackSize： | /tmss: | {int} | 指定執行 SqlPackage 動作之執行緒的大小上限 (以 MB 為單位)。 只有在剖析非常大的 Transact-SQL 陳述式時發生堆疊溢位例外狀況，才應該使用此選項。 |
| /UniversalAuthentication: | /ua: | {真|假} | 指定是否應該使用通用驗證。 設定為 True 時，即會啟用支援 MFA 的互動式驗證通訊協定。 此選項也可以用於不使用 MFA 的 Microsoft Entra 驗證，使用需要使用者輸入其使用者名稱和密碼或整合式驗證 (使用同盟 Windows 認證) 的互動式通訊協定。 當 /UniversalAuthentication 設定為 True 時，SourceConnectionString (/scs) 中不能指定任何 Microsoft Entra 驗證。 當 /UniversalAuthentication 設定為 False 時， SourceConnectionString (/scs) 中必須指定 Microsoft Entra 驗證。 如需詳細資訊，請參閱使用 Microsoft Entra 多重要素驗證。 |
| /變數： | /v: | {PropertyName}={Value} | 指定動件特定變數的名稱/值對：{VariableName}={Value}。 DACPAC 檔案包含有效 SQLCMD 變數的清單。 如果未針對每一個變數提供值，則會產生錯誤。 |
Script 動作的特定屬性
| 屬性 | 值 | 描述 |
|---|---|---|
| /p: | 附加部署貢獻者參數=(STRING) | 為部署參與者指定其他部署參與者引數。 這應該是以分號區隔的值清單。 |
| /p: | AdditionalDeploymentContributors=(STRING) | 指定在部署 dacpac 時應執行的其他部署協作者。 這應該是以分號區隔的完整組建參與者名稱或識別碼清單。 |
| /p: | 附加部署貢獻者路徑=(字串) | 指定載入其他部署參與者的路徑。 這應該是以分號區隔的值清單。 |
| /p: | AllowDropBlockingAssemblies=(BOOLEAN) | 這個屬性是供 SqlClr 部署用來使任何封鎖的組件會在部署計畫中卸除。 根據預設，如果必須卸除任何參考組件，則該封鎖/參考組件會封鎖組件更新。 |
| /p: | AllowExternalLanguagePaths=(布林 'False') | 允許使用檔案路徑 (如有提供) 產生外部語言陳述式。 |
| /p: | AllowExternalLibraryPaths=(BOOLEAN 'False') | 允許使用檔案路徑 (如有提供) 產生外部程式庫陳述式。 |
| /p: | AllowIncompatiblePlatform=(BOOLEAN) | 指定儘管 SQL Server 平台不相容，是否仍要嘗試動作。 |
| /p: | 允許不安全的行級安全數據移動=(BOOLEAN) | 若此屬性設定為 true，請勿封鎖具有資料列層級安全性之資料表的資料動作。 預設值為 false。 |
| /p: | BackupDatabaseBeforeChanges=(BOOLEAN) | 在部署任何變更之前，先備份資料庫。 |
| /p: | BlockOnPossibleDataLoss=(BOOLEAN 'True') | 指定若產生的結構描述變更可能導致資料遺失 (包括因為資料精確度降低或需要轉換作業的資料類型變更)，作業將在結構描述驗證步驟期間終止。 不論目標資料庫是否包含資料，預設 (True) 值都會導致作業終止。 如果目標上有無法轉換為新資料行類型的目標資料，則在部署計劃期間使用 BlockOnPossibleDataLoss 的 False 值執行仍會失敗。 |
| /p: | BlockWhenDriftDetected=(BOOLEAN 'True') | 指定是否要封鎖那些結構描述已不符合其註冊或已解除註冊的資料庫的更新。 |
| /p: | CommandTimeout=(INT32 '60') | 以秒為單位指定對 SQL Server 執行查詢時的命令逾時。 |
| /p: | CommentOutSetVarDeclarations=(BOOLEAN) | 指定在產生的發行指令碼中是否應該將 SETVAR 變數的宣告標記為註解。 如果您計畫在使用 SQLCMD.EXE 等工具進行發行時在命令列指定值，就可以選擇這種作法。 |
| /p: | 使用目標排序法進行比較=(BOOLEAN) | 這個設定表示資料庫的定序於部署期間的處理方式。如果目標資料庫的定序不符合來源所指定的定序，預設會更新目標資料庫的定序。 當設定這個選項時，則應該使用目標資料庫 (或伺服器) 的定序。 |
| /p: | CreateNewDatabase=(BOOLEAN) | 指定當您發行至資料庫時，應該更新目標資料庫或應該卸除並重新建立目標資料庫。 |
| /p: | DatabaseEdition=（{ 基本版 | 標準版 | 高級版 | 資料倉儲版 | 一般用途版 | 業務關鍵版 | 超大規模版 | 預設 } '預設') | 定義 Azure SQL Database 的版本。 請參閱 Azure SQL Database 服務層級。 |
| /p: | DatabaseLockTimeout=(INT32 '60') | 指定在對 SQLServer 執行查詢時的資料庫鎖定逾時期限（以秒為單位）。 使用 -1 表示永遠等候。 |
| /p: | DatabaseMaximumSize=(INT32) | 定義 Azure SQL Database 的大小上限 (以 GB 表示)。 |
| /p: | DatabaseServiceObjective=(STRING) | 定義 Azure SQL Database 的效能等級，例如 "P0" 或 "S1"。 |
| /p: | 部署資料庫於單用戶模式=(BOOLEAN) | 若為 true，則資料庫會在設定為單一使用者模式後部署。 |
| /p: | DisableAndReenableDdlTriggers=(BOOLEAN 'True') | 指定是否在發行程序開始時停用資料定義語言 (DDL) 觸發程序，並在發行動作結束時重新啟用。 |
| /p: | DoNotAlter更改數據捕捉對象=(BOOLEAN 'True') | 如果為 true，則不會改變異動資料擷取物件。 |
| /p: | 請勿更改複製物件=(布林值 '真') | 指定是否在驗證期間識別被複製的物件。 |
| /p: | DoNotDropObjectType=(STRING) | 當 DropObjectsNotInSource 為 true 時不應捨棄的物件類型。 有效的物件類型名稱為 Aggregates、應用程式角色 (ApplicationRoles)、程序集 (Assemblies)、程序集檔案 (AssemblyFiles)、非對稱金鑰 (AsymmetricKeys)、代理優先順序 (BrokerPriorities)、憑證 (Certificates)、欄加密金鑰 (ColumnEncryptionKeys)、欄主金鑰 (ColumnMasterKeys)、契約 (Contracts)、資料庫選項 (DatabaseOptions)、資料庫角色 (DatabaseRoles)、資料庫觸發器 (DatabaseTriggers)、預設值 (Defaults)、延伸屬性 (ExtendedProperties)、外部資料來源 (ExternalDataSources)、外部檔案格式 (ExternalFileFormats)、外部資料表 (ExternalTables)、檔案群組 (Filegroups)、檔案 (Files)、檔案資料表 (FileTables)、全文目錄 (FullTextCatalogs)、全文停止列表 (FullTextStoplists)、訊息類型 (MessageTypes)、分割函數 (PartitionFunctions)、分割結構 (PartitionSchemes)、權限 (Permissions)、佇列 (Queues)、遠端服務綁定 (RemoteServiceBindings)、角色成員資格 (RoleMembership)、規則 (Rules)、標量值函數 (ScalarValuedFunctions)、搜尋屬性列表 (SearchPropertyLists)、安全性政策 (SecurityPolicies)、序列 (Sequences)、服務 (Services)、簽章 (Signatures)、預存程序 (StoredProcedures)、對稱金鑰 (SymmetricKeys)、同義詞 (Synonyms)、資料表 (Tables)、表格值函數 (TableValuedFunctions)、使用者定義資料類型 (UserDefinedDataTypes)、使用者定義表格類型 (UserDefinedTableTypes)、CLR 使用者定義類型 (ClrUserDefinedTypes)、使用者 (Users)、檢視 (Views)、XML 架構集合 (XmlSchemaCollections)、稽核 (Audits)、憑據 (Credentials)、加密提供者 (CryptographicProviders)、資料庫稽核規範 (DatabaseAuditSpecifications)、資料庫加密金鑰 (DatabaseEncryptionKeys)、資料庫範圍認證資訊 (DatabaseScopedCredentials)、端點 (Endpoints)、錯誤訊息 (ErrorMessages)、事件通知 (EventNotifications)、事件會話 (EventSessions)、連結伺服器登入 (LinkedServerLogins)、連結伺服器 (LinkedServers)、登入 (Logins)、主金鑰 (MasterKeys)、路由 (Routes)、伺服器稽核規範 (ServerAuditSpecifications)、伺服器角色成員資格 (ServerRoleMembership)、伺服器角色 (ServerRoles)、伺服器觸發器 (ServerTriggers)、外部資料流 (ExternalStreams)、外部串流作業 (ExternalStreamingJobs)、資料庫工作負載群組 (DatabaseWorkloadGroups)、工作負載分類器 (WorkloadClassifiers)、外部程式庫 (ExternalLibraries)、外部語言 (ExternalLanguages)。 可多次指定此屬性來表示多個選項。 |
| /p: | DoNotDropObjectTypes=(STRING) | 當 DropObjectsNotInSource 為 true 時不應捨棄的分號分隔物件類型清單。 有效的物件類型名稱為 Aggregates、ApplicationRoles、Assemblies、AssemblyFiles、AsymmetricKeys、BrokerPriorities、Certificates、ColumnEncryptionKeys、ColumnMasterKeys、Contracts、DatabaseOptions、DatabaseRoles、DatabaseTriggers、Defaults、ExtendedProperties、ExternalDataSources、ExternalFileFormats、ExternalTables、Filegroups、Files、FileTables、FullTextCatalogs、FullTextStoplists、MessageTypes、PartitionFunctions、PartitionSchemes、Permissions、Queues、RemoteServiceBindings、RoleMembership、Rules、ScalarValuedFunctions、SearchPropertyLists、SecurityPolicies、Sequences、Services、Signatures、StoredProcedures、SymmetricKeys、Synonyms、Tables、TableValuedFunctions、UserDefinedDataTypes、UserDefinedTableTypes、ClrUserDefinedTypes、Users、Views、XmlSchemaCollections、Audits、Credentials、CryptographicProviders、DatabaseAuditSpecifications、DatabaseEncryptionKeys、DatabaseScopedCredentials、Endpoints、ErrorMessages、EventNotifications、EventSessions、LinkedServerLogins、LinkedServers、Logins、MasterKeys、Routes、ServerAuditSpecifications、ServerRoleMembership、ServerRoles、ServerTriggers、ExternalStreams、ExternalStreamingJobs、DatabaseWorkloadGroups、WorkloadClassifiers、ExternalLibraries、ExternalLanguages。 |
| /p: | DoNotDropWorkloadClassifiers=(BOOLEAN 'False') | 若值為 false，未在來源中定義之目標資料庫內的 WorkloadClassifiers，將在佈署過程中被刪除。 |
| /p: | DoNotEvaluateSqlCmdVariables=(BOOLEAN 'True') | 指定是否不以值取代 SQLCMD 變數 |
| /p: | 刪除源中不存在的約束=(BOOLEAN 'True') | 指定當您發行至資料庫時，是否要從目標資料庫中卸除不存在資料庫快照集 (.dacpac) 檔案中的條件約束。 |
| /p: | DropDmlTriggersNotInSource=(BOOLEAN 'True') | 指定當您發行至資料庫時，是否要從目標資料庫中卸除不存在資料庫快照集 (.dacpac) 檔案中的 DML 觸發程序。 |
| /p: | 移除來源中不存在的擴展屬性=(BOOLEAN 'True') | 當您將專案發行至資料庫時，指定若目標資料庫中不存在於資料庫快照 (.dacpac) 檔案的擴充屬性，是否應將其卸除。 |
| /p: | DropIndexesNotInSource=(BOOLEAN 'True') | 指定當您發行至資料庫時，是否要從目標資料庫中卸除不存在資料庫快照集 (.dacpac) 檔案中的索引。 |
| /p: | DropObjectsNotInSource=(BOOLEAN) | 當您發佈至資料庫時，指定是否要從目標資料庫中移除那些在資料庫快照 (.dacpac) 檔案中不存在的物件。 這個值的優先順序高於 DropExtendedProperties。 |
| /p: | 刪除來源中不存在的權限=(BOOLEAN) | 指定當您將更新發行至資料庫時，是否要從目標資料庫中卸除.dacpac 檔案中不存在的權限。 |
| /p: | DropRoleMembersNotInSource=(BOOLEAN) | 指定當您發佈更新到資料庫時，是否要從目標資料庫中移除資料庫快照 (.dacpac) 檔案中未定義的角色成員。 |
| /p: | DropStatisticsNotInSource=(布林值 'True') | 指定當您發佈至資料庫時，是否要從目標資料庫刪除在資料庫快照 (.dacpac) 檔案中不存在的統計資料。 |
| /p: | EnclaveAttestationProtocol=(STRING) | 指定要用於配合安全區型 Always Encrypted 的驗證通訊協定。 |
| /p: | EnclaveAttestationUrl=(STRING) | 指定要搭配安全區域型 Always Encrypted（全程加密）使用的安全區域認證 URL（認證服務端點）。 |
| /p: | 排除物件類型=(STRING) | 部署期間應該忽略的物件類型。 有效的物件類型名稱為 Aggregates (彙總)、ApplicationRoles (應用程式角色)、Assemblies (組件)、AssemblyFiles (組件檔案)、AsymmetricKeys (非對稱金鑰)、BrokerPriorities (代理優先順序)、Certificates (憑證)、ColumnEncryptionKeys (欄加密金鑰)、ColumnMasterKeys (欄主金鑰)、Contracts (合約)、DatabaseOptions (資料庫選項)、DatabaseRoles (資料庫角色)、DatabaseTriggers (資料庫觸發程序)、Defaults (預設值)、ExtendedProperties (擴充屬性)、ExternalDataSources (外部資料來源)、ExternalFileFormats (外部檔案格式)、ExternalTables (外部表格)、Filegroups (檔案群組)、Files (檔案)、FileTables (檔案表)、FullTextCatalogs (全文目錄)、FullTextStoplists (全文停止名單)、MessageTypes (訊息類型)、PartitionFunctions (分隔函數)、PartitionSchemes (分割方案)、Permissions (權限)、Queues (佇列)、RemoteServiceBindings (遠端服務綁定)、RoleMembership (角色成員資格)、Rules (規則)、ScalarValuedFunctions (純量值函數)、SearchPropertyLists (搜尋屬性清單)、SecurityPolicies (安全性原則)、Sequences (序列)、Services (服務)、Signatures (簽章)、StoredProcedures (儲存程序)、SymmetricKeys (對稱金鑰)、Synonyms (同義詞)、Tables (表格)、TableValuedFunctions (表格值函數)、UserDefinedDataTypes (使用者定義資料類型)、UserDefinedTableTypes (使用者定義表類型)、ClrUserDefinedTypes (CLR 使用者定義類型)、Users (使用者)、Views (檢視)、XmlSchemaCollections (XML 綱目集合)、Audits (稽核)、Credentials (憑證)、CryptographicProviders (加密供應者)、DatabaseAuditSpecifications (資料庫稽核規格)、DatabaseEncryptionKeys (資料庫加密金鑰)、DatabaseScopedCredentials (資料庫範疇認證)、Endpoints (端點)、ErrorMessages (錯誤訊息)、EventNotifications (事件通知)、EventSessions (事件會話)、LinkedServerLogins (連接伺服器登入)、LinkedServers (連接伺服器)、Logins (登入)、MasterKeys (主金鑰)、Routes (路由)、ServerAuditSpecifications (伺服器稽核規范)、ServerRoleMembership (伺服器角色成員資格)、ServerRoles (伺服器角色)、ServerTriggers (伺服器觸發程序)、ExternalStreams (外部串流)、ExternalStreamingJobs (外部串流作業)、DatabaseWorkloadGroups (資料庫負載群組)、WorkloadClassifiers (負載分類器)、ExternalLibraries (外部函式庫)、ExternalLanguages (外部語言)。 |
| /p: | ExcludeObjectTypes=(STRING) | 以分號區隔的物件類型清單，列出部署期間應該忽略的物件類型。 有效的物件類型名稱包括彙總 (Aggregates)、應用程式角色 (ApplicationRoles)、彙編 (Assemblies)、彙編檔案 (AssemblyFiles)、非對稱金鑰 (AsymmetricKeys)、經紀人優先級 (BrokerPriorities)、憑證 (Certificates)、列加密金鑰 (ColumnEncryptionKeys)、列主鍵 (ColumnMasterKeys)、合約 (Contracts)、數據庫選項 (DatabaseOptions)、數據庫角色 (DatabaseRoles)、數據庫觸發器 (DatabaseTriggers)、預設值 (Defaults)、擴展屬性 (ExtendedProperties)、外部數據源 (ExternalDataSources)、外部文件格式 (ExternalFileFormats)、外部表格 (ExternalTables)、檔案組 (Filegroups)、檔案 (Files)、檔案表 (FileTables)、全文檢索目錄 (FullTextCatalogs)、全文檢索停止詞清單 (FullTextStoplists)、訊息類型 (MessageTypes)、分割函數 (PartitionFunctions)、分割方案 (PartitionSchemes)、權限 (Permissions)、佇列 (Queues)、遠程服務綁定 (RemoteServiceBindings)、角色成員資格 (RoleMembership)、規則 (Rules)、標量值函數 (ScalarValuedFunctions)、搜尋屬性清單 (SearchPropertyLists)、安全策略 (SecurityPolicies)、序列 (Sequences)、服務 (Services)、簽名 (Signatures)、存儲過程 (StoredProcedures)、對稱金鑰 (SymmetricKeys)、同義詞 (Synonyms)、表格 (Tables)、表值函數 (TableValuedFunctions)、用戶定義數據類型 (UserDefinedDataTypes)、用戶定義表類型 (UserDefinedTableTypes)、CLR 用戶定義類型 (ClrUserDefinedTypes)、用戶 (Users)、視圖 (Views)、XML 架構集 (XmlSchemaCollections)、審計 (Audits)、憑證 (Credentials)、加密提供者 (CryptographicProviders)、數據庫審核規範 (DatabaseAuditSpecifications)、數據庫加密金鑰 (DatabaseEncryptionKeys)、數據庫範圍憑證 (DatabaseScopedCredentials)、端點 (Endpoints)、錯誤訊息 (ErrorMessages)、事件通知 (EventNotifications)、事件會話 (EventSessions)、鏈接伺服器登入 (LinkedServerLogins)、鏈接伺服器 (LinkedServers)、登入 (Logins)、主鑰匙 (MasterKeys)、路由 (Routes)、伺服器審核規範 (ServerAuditSpecifications)、伺服器角色成員 (ServerRoleMembership)、伺服器角色 (ServerRoles)、伺服器觸發器 (ServerTriggers)、外部數據流 (ExternalStreams)、外部流處理作業 (ExternalStreamingJobs)、數據庫工作負載組 (DatabaseWorkloadGroups)、工作負荷分類器 (WorkloadClassifiers)、外部庫 (ExternalLibraries)、外部語言 (ExternalLanguages)。 |
| /p: | GenerateSmartDefaults=(BOOLEAN) | 在更新含有資料且資料行不允許 null 值的資料表時，自動提供預設值。 |
| /p: | HashObjectNamesInLogs=(BOOLEAN 'False') | 指定是否要以隨機雜湊值取代記錄中的所有物件名稱。 |
| /p: | IgnoreAnsiNulls=(BOOLEAN 'True') | 指定當您發行至資料庫時，應該忽略或更新 ANSI NULLS 設定中的差異。 |
| /p: | IgnoreAuthorizer=(BOOLEAN) | 指定當您發行至資料庫時，應該忽略或更新授權者的差異。 |
| /p: | 忽略欄位排序規則=(BOOLEAN) | 在發佈至資料庫時，指定是否應忽略或更新資料行排序的差異。 |
| /p: | 忽略欄位順序=(布林值) | 指定當您發行至資料庫時，是否應略過或更新資料表資料行順序的差異。 |
| /p: | IgnoreComments=(BOOLEAN) | 指定在您將內容發布至資料庫時，是否應忽略或更新註解中的差異。 |
| /p: | 忽略加密提供者文件路徑=(BOOLEAN 'True') | 指定當您發行至資料庫時，是否應該忽略或更新加密提供者的檔案路徑差異。 |
| /p: | 忽略資料庫工作量群組=(布林值 'False') | 指定部署期間是否要排除存在於目標上的工作負載群組。 系統不會新增、修改或卸除資料庫工作負載群組。 |
| /p: | 忽略Ddl觸發順序=(BOOLEAN) | 指定當您發行至資料庫或伺服器時，應該忽略或更新資料定義語言 (Data Definition Language) (DDL) 觸發程序的順序差異。 |
| /p: | IgnoreDdlTriggerState=(BOOLEAN) | 指定當您發行至資料庫時，應該忽略或更新資料定義語言 (Data Definition Language) (DDL) 觸發程序之啟用或停用狀態的差異。 |
| /p: | IgnoreDefaultSchema=(BOOLEAN) | 指定在您發行至資料庫時，是否應忽略或更新預設模式的差異。 |
| /p: | IgnoreDmlTriggerOrder=(BOOLEAN) | 指定您在發佈至資料庫時，是否應忽略或更新資料操作語言 (DML) 觸發程序的順序上的差異。 |
| /p: | IgnoreDmlTriggerState=(BOOLEAN) | 指定您在發佈至資料庫時，是否應該忽略或更新 DML 觸發程序的啟用或停用狀態差異。 |
| /p: | IgnoreExtendedProperties=(BOOLEAN) | 指定當您發行至資料庫時，應決定是否忽略或更新擴充屬性的差異。 |
| /p: | IgnoreFileAndLogFilePath=(BOOLEAN 'True') | 指定當您發行至資料庫時，應該忽略或更新檔案和記錄檔之路徑的差異。 |
| /p: | IgnoreFilegroupPlacement=(BOOLEAN 'True') | 指定當您發行至資料庫時，應該忽略或更新 FILEGROUP 中物件位置的差異。 |
| /p: | 忽略文件大小=(BOOLEAN 'True') | 指定當您發行至資料庫時，應該忽略檔案大小的差異或應該發出警告。 |
| /p: | IgnoreFillFactor=(BOOLEAN 'True') | 指定是否在發布時應該忽略索引儲存的填充因數差異，或發出警告。 |
| /p: | IgnoreFullTextCatalogFilePath=(BOOLEAN 'True') | 指定當您發佈至資料庫時，是否忽略全文檢索檔案路徑的差異，或是對此發出警告。 |
| /p: | IgnoreIdentitySeed=(BOOLEAN) | 指定發行更新至資料庫時，是否應忽略或更新識別欄種子的差異。 |
| /p: | 忽略增量=(BOOLEAN) | 指定在將資料發佈到資料庫時，是否應忽略或更新識別欄位增量的差異。 |
| /p: | IgnoreIndexOptions=(BOOLEAN) | 指定當您發佈至資料庫時，是否應該忽略或更新在索引選項中的差異。 |
| /p: | 忽略索引填充=(布爾值 'True') | 控制當您發行至資料庫時，是否應忽略或更新索引填充的差異。 |
| /p: | 忽略關鍵字大小寫=(布林值 'True') | 指定您發行至資料庫時，是否應忽略或更新關鍵字大小寫的差異。 |
| /p: | 索引上的忽略鎖定提示=(BOOLEAN) | 指定當您發行至資料庫時，是否要忽略或更新索引的鎖定提示差異。 |
| /p: | 忽略登入SID=(布林值 'True') | 當您發行至資料庫時，指定是否應忽略或更新安全性識別碼 (SID) 的不同。 |
| /p: | 忽略非複製用=(BOOLEAN) | 指定當您發布至資料庫時，應該忽略或更新「非複製用」設定。 |
| /p: | 忽略物件佈置於分區方案=(BOOLEAN '真') | 指定當您發行至資料庫時，應該忽略或更新物件在資料分割配置上的位置。 |
| /p: | IgnorePartitionSchemes=(BOOLEAN) | 指定當您將資料發佈至資料庫時，是否應該忽略或更新分割方案和功能的差異。 |
| /p: | IgnorePermissions=(BOOLEAN) | 指定當您發布至資料庫時，應該忽略或更新權限的差異。 |
| /p: | IgnoreQuotedIdentifiers=(BOOLEAN 'True') | 指定當您發行至資料庫時，應該忽略或更新引號識別項設定的差異。 |
| /p: | IgnoreRoleMembership=(BOOLEAN) | 指定當您發行至資料庫時，應該忽略或更新登入之角色成員資格的差異。 |
| /p: | 忽略路由存活期=(BOOLEAN 'True') | 指定當您發行至資料庫時，是否應忽略或更新 SQL Server 路由表中保留路由時間長短的差異。 |
| /p: | IgnoreSemicolonBetweenStatements=(BOOLEAN 'True') | 指定當您發布至資料庫時，應該忽略或更新 T-SQL 語句中分號的差異。 |
| /p: | 忽略敏感性分類=(布林值 'False') | 指定比較結構描述模型時，是否應該忽略資料行上的資料敏感度分類。 這只適用於使用 SQL 2019 中推出的 ADD SENSITIVITY CLASSIFICATION 語法所新增的分類。 |
| /p: | 忽略表格選項=(布林) | 指定當您發佈至資料庫時，是忽略還是更新資料表選項中的差異。 |
| /p: | 忽略表分區選項=(BOOLEAN) | 指定當您發佈至資料庫時，要忽略還是更新資料表分割區選項的差異。 此選項只適用於 Azure Synapse Analytics 資料倉儲資料庫。 |
| /p: | 使用者設定忽略物件=(布林值) | 指定是否在發行至資料庫時忽略或更新使用者設定物件的差異。 |
| /p: | IgnoreWhitespace=(BOOLEAN 'True') | 指定發佈至資料庫時，是否忽略或更新空白字元的差異。 |
| /p: | IgnoreWithNocheckOnCheckConstraints=(BOOLEAN) | 指定您發行時，是否忽略或更新檢查約束中 WITH NOCHECK 子句值的差異。 |
| /p: | IgnoreWithNocheckOnForeignKeys=(BOOLEAN) | 指定當你發佈至資料庫時，是要忽略或更新外部索引鍵中 WITH NOCHECK 子句值的差異。 |
| /p: | IgnoreWorkloadClassifiers=(布林值 '假') | 指定部署期間是否要排除存在於目標上的工作負載分類器。 |
| /p: | 包含複合物件=(布林值) | 將具有相同資料庫的所有複合元素包含在單一發佈作業中。 |
| /p: | 包含交易脚本=(布尔值) | 指定當您發行至資料庫時，是否應該盡可能使用交易陳述式。 |
| /p: | IsAlwaysEncryptedParameterizationEnabled=(BOOLEAN '假') | 在部署前/後指令碼的 Always Encrypted 資料行上啟用變數參數化。 |
| /p: | LongRunningCommandTimeout=(INT32 '0') | 以秒為單位指定對 SQL Server 執行查詢時的長時間執行命令逾時。 使用 0 表示永遠等候。 |
| /p: | NoAlterStatementsToChangeClrTypes=(BOOLEAN) | 指定若有差異，發布時應總是卸除並重新建立組件，而不是發出 ALTER ASSEMBLY 陳述式。 |
| /p: | PerformIndexOperationsOnline=(BOOLEAN 'False') | 指定在部署期間是否線上執行索引作業。 |
| /p: | 將檔案填入檔案群組=(BOOLEAN 'True') | 指定在目標資料庫中建立新 FileGroup 時，是否一併建立新檔案。 |
| /p: | PreserveIdentityLastValues=(BOOLEAN 'False') | 指定是否應在部署期間保留識別資料行的最後一個值。 |
| /p: | RegisterDataTierApplication=(BOOLEAN) | 指定資料庫架構是否註冊至資料庫伺服器。 |
| /p: | RestoreSequenceCurrentValue=(BOOLEAN 'True') | 指定是否應使用 dacpac 檔案部署順序物件目前的值，預設值為 True。 |
| /p: | RunDeploymentPlanExecutors=(BOOLEAN) | 指定是否在執行其他作業時運行 DeploymentPlanExecutor 的貢獻者。 |
| /p: | ScriptDatabaseCollation=(BOOLEAN) | 設定當您發佈至資料庫時，是否應該忽略或更新資料庫排序規則的差異。 |
| /p: | 腳本資料庫相容性=(BOOLEAN) | 指明當您發佈到資料庫時，是否應該忽略或更新資料庫相容性的差異。 |
| /p: | ScriptDatabaseOptions=(BOOLEAN 'True') | 指定是否應該在發行動作中設定或更新目標資料庫屬性。 |
| /p: | ScriptDeployStateChecks=(BOOLEAN) | 指定是否在發行指令碼中產生陳述式，來驗證資料庫名稱和伺服器名稱是否符合資料庫專案中指定的名稱。 |
| /p: | ScriptFileSize=(BOOLEAN) | 控制將檔案加入至檔案群組時是否指定大小。 |
| /p: | ScriptNewConstraintValidation=(BOOLEAN 'True') | 在發佈結束時，所有的條件約束會當作一個集合進行驗證，避免在發佈中途因檢查或外部索引鍵條件約束造成資料錯誤。 如果設為 False，會發布您的條件約束，但不檢查對應的資料。 |
| /p: | ScriptRefreshModule=(BOOLEAN 'True') | 在發布指令碼的結尾包含更新陳述式。 |
| /p: | Storage=({File|Memory}) | 指定在建置資料庫模型時，如何儲存項目。 基於效能考量，預設值為 InMemory。 對於大型資料庫，可能需要檔案備援儲存裝置，而此功能僅在 SqlPackage 的 .NET Framework 版本中提供。 |
| /p: | 將驗證錯誤視為警告=(BOOLEAN) | 指定在發佈驗證期間發生的錯誤是否應視為警告。 系統會先針對產生的部署計畫執行檢查，再針對您的目標資料庫執行計畫。 計畫驗證會偵測出問題，例如必須卸除以便進行變更的目標專有物件（如索引）遺失。 驗證也會偵測因為參考複合專案而存在相依性 (如資料表或檢視)，但卻不存在於目標資料庫中的情況。 您可以選擇執行此動作，以取得所有問題的完整清單，而不是在第一個錯誤就停止 Publish 動作。 |
| /p: | 不可修改物件警告=(BOOLEAN 'True') | 指定在無法修改的物件中發現差異時 (例如檔案的檔案大小或檔案路徑不同) 是否應該產生警告。 |
| /p: | VerifyCollationCompatibility=(布林值 'True') | 指定是否驗證定序相容性。 |
| /p: | VerifyDeployment=(BOOLEAN 'True') | 指定是否應該在發行前執行檢查，以便在出現阻止發行成功的問題時停止發行動作。 例如，如果目標資料庫中的外部鍵不存在於資料庫專案中，並因此在您發行時造成錯誤，則發行動作可能會停止。 |
後續步驟
- 深入了解 SqlPackage