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 檢視。