次の方法で共有

catalog.validate_package (SSISDB データベース)

  • [アーティクル]

Integration Services カタログのパッケージを非同期的に検証します。

構文

validate_package [ @folder_name = ] folder_name
    , [ @project_name = ] project_name
    , [ @package_name = ] package_name
    , [ @validation_id = ] validation_id OUTPUT
 [  , [ @use32bitruntime = ] use32bitruntime ]
 [  , [ @target_environment = ] target_environment ]
 [  , [ @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
    64 ビット オペレーティング システムで 32 ビットのランタイムを使用してパッケージを実行するかどうかを示します。 値 1 を使用すると、64 ビット オペレーティング システムで実行しているときに、32 ビット ランタイムでパッケージを実行します。 値 0 を使用すると、64 ビット オペレーティング システムで実行しているときに、64 ビット ランタイムでパッケージが実行されます。 このパラメーターはオプションです。 use32bitruntime は bit 型です。

  • [ @environment\_scope = ] environment_scope
    検証が考慮する環境参照を示します。 値が A の場合は、プロジェクトに関連するすべての環境参照が検証に含まれます。 値が S の場合は、1 つの環境参照のみが含まれます。 値が D の場合、環境参照は含まれず、各パラメーターには、検証に合格するため、既定のリテラル値を指定する必要があります。 このパラメーターは省略可能です。文字 D が既定で使用されます。 environment_scope は Char(1) 型です。

  • [ @reference\_id = ] reference_id
    環境参照の一意の ID。 1 つの環境参照が検証に含まれ、environment_scope が S の場合のみこのパラメーターが必要です。 reference_id は bigint 型です。

リターン コードの値

成功した場合は 0 を返します。

結果セット

なし

権限

このストアド プロシージャには、次の権限のいずれかが必要です。

  • プロジェクトの READ 権限と、該当する場合は、参照先の環境での READ 権限

  • ssis_admin データベース ロールのメンバーシップ

  • sysadmin サーバー ロールのメンバーシップ

エラーおよび警告

エラーまたは警告が発生する可能性がある条件を以下に示します。

  • プロジェクト名またはパッケージ名が無効

  • ユーザーに適切な権限がない

  • 検証に含まれる 1 つまたは複数の参照先の環境が、参照先の変数を含まない

  • パッケージの検証に失敗する

  • 参照先の環境が存在しない

  • 参照先の変数が、検証に含まれる参照先の環境で見つからない

  • 変数がパッケージ パラメーターで参照されるが、参照先の環境が検証に含まれなかった

解説

検証では、パッケージが正常に実行されない問題を特定することができます。 検証の状態を監視するには、catalog.validations または catalog.operations ビューを使用します。