catalog.validate_package (SSISDB 資料庫)
適用於:SQL Server Azure Data Factory 中的 SSIS Integration Runtime
適用於:SQL Server
以非同步方式驗證 Integration Services 目錄中的套件。
語法
catalog.validate_package [ @folder_name = ] folder_name
, [ @project_name = ] project_name
, [ @package_name = ] package_name
, [ @validation_id = ] validation_id OUTPUT
[ , [ @use32bitruntime = ] use32bitruntime ]
[ , [ @environment_scope = ] environment_scope ]
[ , [ @reference_id = ] reference_id ]
引數
[ @folder_name = ] folder_name
包含封裝之資料夾的名稱。 folder_name 是 nvarchar(128) 。
[ @project_name = ] project_name
包含封裝之專案的名稱。 project_name 是 nvarchar(128) 。
[ @package_name = ] package_name
封裝名稱。 package_name 是 nvarchar(260)。
[ @validation_id = ] validation_id
傳回驗證的唯一識別碼 (ID)。 validation_id 是 bigint。
[ @use32bitruntime = ] use32bitruntime
指出是否要使用 32 位元執行階段,在 64 位元作業系統上執行封裝。 使用 1
值,即可在執行 64 位元作業系統時,使用 32 位元執行階段執行套件。 使用 0
值,即可在執行 64 位元作業系統時執行 64 位元執行階段。 這是選擇性參數。 use32bitruntime 是 bit。
[ @environment_scope = ] environment_scope
指出由驗證考量的環境參考。 當值為 A
時,驗證中會包含與專案相關的所有環境參考。 當值為 S
時,只會包含單一環境參考。 當值為 D
時,不會包含任何環境參考,而且每個參數必須為常值預設值,才能通過驗證。 這是選擇性參數。 預設會使用字元 D
。 environment_scope 是 char(1) 。
[ @reference_id = ] reference_id
環境參考的唯一識別碼。 只有在驗證中包含單一環境參考,也就是在 environment_scope 為 S
時,才需要這個參數。 reference_id 是 bigint。
傳回碼值
0 (成功)
結果集
None
權限
這個預存程序需要下列其中一個權限:
專案的 READ 權限,以及 (如果適用的話) 參考環境的 READ 權限
ssis_admin 資料庫角色的成員資格
系統管理員伺服器角色的成員資格
錯誤和警告
下列清單將描述可能會引發錯誤或警告的某些條件:
專案名稱或封裝名稱無效
使用者未具備適當的權限
驗證中包含的一個或多個參考環境不包含參考變數
封裝驗證失敗
受參考的環境不存在。
驗證中包含的參考環境內找不到參考變數
封裝參數中已參考變數,但驗證中沒有包含參考環境
備註
驗證有助於識別讓套件無法成功執行的問題。 若要監視驗證狀態,請使用 catalog.validations 或 catalog.operations 檢視。