catalog.validate_project (SSISDB 資料庫)

適用於：SQL Server Azure Data Factory 中的 SSIS Integration Runtime

適用於：SQL Server

以非同步方式驗證 Integration Services 目錄中的專案。

語法

catalog.validate_project [ @folder_name = ] folder_name  
    , [ @project_name = ] project_name  
    , [ @validate_type = ] validate_type  
    , [ @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) 。

[ @validate_type = ] validate_type
指出執行的類型驗證。 使用字元 F 即可執行完整驗證。 這是選擇性參數，根據預設，將會使用字元 F。 validate_type 是 char(1)。

[ @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 (成功)

結果集

驗證步驟的輸出會當做結果集中的不同區段傳回。

權限

這個預存程序需要下列其中一個權限：

• 專案的 READ 權限，以及 (如果適用的話) 參考環境的 READ 權限

• ssis_admin 資料庫角色的成員資格

• 系統管理員伺服器角色的成員資格

錯誤和警告

下列清單將提供可能會引發錯誤或警告的某些條件：

• 專案中的一個或多個封裝未通過驗證

• 如果驗證中包含的一個或多個參考環境與參考變數不相符，驗證就會失敗

• 指定驗證類型無效

• 專案名稱或環境參考識別碼無效

• 使用者未具備適當的權限

備註

驗證有助於識別讓專案中之封裝無法成功執行的問題。 若要監視驗證狀態，請使用 catalog.validations 或 catalog.operations 檢視。

驗證中只能夠使用使用者可存取的環境。 驗證輸出會當做結果集傳送至用戶端。

在這個版本中，專案驗證不支援相依性驗證。

完整驗證會確認所有參考的環境變數皆可在驗證所包含的參考環境中找到。 完整驗證結果會列出無效的環境參考，以及在驗證所包含的任何參考環境中皆無法找到的參考環境變數。