EXT_AUTHORIZER_EXPLAIN ストアドプロシージャ Data Virtualization
IBM Knowledge Catalog データ保護規則の詳細については、 Data Virtualization の EXT_AUTHORIZER_EXPLAIN ストアドプロシージャを使用して、ユーザーの Data Virtualization オブジェクトに適用されるものについて確認してください。 スキーマは DVSYS です。
ユーザーの Data Virtualization オブジェクトに適用されるデータ保護規則に関する詳細情報を把握することで、機密情報が確実に保護されるよう支援することができます。
許可
の手順を実行するには、 Data Virtualization マネージャー である必要があります。 詳細については、 ユーザーの役割を管理する Data Virtualization をご覧ください。EXT_AUTHORIZER_EXPLAIN
入力パラメーター
- SCHEMA_NAME
- この必須パラメーターのタイプは VARCHAR (128) です。 評価対象のオブジェクトのスキーマを指定します。
- OBJECT_NAME
- この必須パラメーターのタイプは VARCHAR (128) です。 評価対象のオブジェクト名を指定します。
- USERNAME
- この必須パラメーターのタイプは VARCHAR (128) です。 オブジェクトを評価する対象となるユーザーの Data Virtualization ユーザーIDを指定します。
出力パラメーター
- AUTHORIZER_EXPLAIN
- このパラメーターのタイプは VARCHAR (32672) です。 JSON形式での評価結果の説明。
プロパティ名を出力する
出力で表示される可能性のある各プロパティ名の説明については、以下の表を参照してください。
プロパティー名 | 定義 |
---|---|
asset_id | container 内のカタログ資産のIDで、データ保護規則に対する評価に使用されたメタデータ。 |
container | 対象の評価に使用された資産、管理対象カタログのIDと名称。 |
evaluation_outcome | オブジェクトに適用される全体的な結果。次のいずれかが含まれる場合があります
|
is_cached | このパラメータは、結果がローカルコピーから取得されるかどうかを決定します。
|
parameters | 適用可能な変換操作(列マスクまたは行フィルタ)の定義。 |
rules | 要求された評価コンテキストに適用されるデータ保護規則の名称とID。 |
transform_spec | 適用可能なルールの結果として、適用可能なカラムマスク、行フィルタ、またはその両方のリスト。 operation_type には、以下のいずれかの銅像を含めることができます
|
user_id | 評価対象のユーザーのプラットフォームまたはIAMユーザーID。 |
構文
CALL DVSYS.EXT_AUTHORIZER_EXPLAIN('<SCHEMA_NAME>', '<OBJECT_NAME>', '<USERNAME>', ?);
例
次の2つの例は、行フィルタリングとカラムマスク(難読化)ルールが適用された Data Virtualization オブジェクトでこのストアドプロシージャを使用した場合に何が起こるかを示しています。
- 行のフィルタリングルールはオブジェクトに適用されます
- ユーザ USER1 用のスキーマMY_SCHEMA内の仮想テーブルMY_TABLEを評価するには、以下のSQLステートメントを実行してください
CALL DVSYS.EXT_AUTHORIZER_EXPLAIN('MY_SCHEMA', 'MY_TABLE', 'USER1', ?);
行フィルタリングルールが適用可能なオブジェクトの場合、出力は次の例のようなものになる可能性がありますValue of output parameters -------------------------- Parameter name : AUTHORIZER_EXPLAIN Parameter value : {"IKC":{"resource_key":"1ed88d5b-148e-49c5-85a3-000000000000:/MY_SCHEMA/MY_TABLE","evaluation_outcome":"Transform","governance_convention":"AEAD",asset_id":"9cb85f03-100a-4bd5-8275-000000000000","container":{"id":"753b9703-4f82-4552-9906-000000000000","name":"Default"},"is_cached":false,"user_id":"0000000000","rules":[{"id":"297d03ad-be3f-43c3-b534-000000000000","name":"Table RoLE normal"},{"id":"b140d918-9ca8-4356-86c2-000000000000","name":"Table RoLE fail"}],"transform_spec":[{"operation_type":"research/include_rows_ref","parameters":[{"predicate":[["$$source.MY_TABLE_ID","=","$$references[0].MY_TABLE_ID"]],"references":[{"catalog_id":"753b9703-4f82-4552-9906-000000000000","asset_id":"b1d5fdd1-5ae4-45c5-b1b3-000000000000","resource_key":"1ed88d5b-148e-49c5-85a3-000000000000:/MY_SCHEMA/MY_TABLE"}]}]}]}}s_ref","parameters":[{"predicate":[["$$source.MY_TABLE_ID","=","$$references[0].TABLE_ID"]],"references":[{"catalog_id":"753b9703-4f82-4552-9906-000000000000","asset_id":"b1d5fdd1-5ae4-45c5-b1b3-000000000000","resource_key":"1ed88d5b-148e-49c5-85a3-000000000000:/MY_SCHEMA/MY_TABLE"}]}]}]}}
- カラムマスクのルールはオブジェクトに適用されます
ユーザ USER1 用のスキーマMY_SCHEMA内の仮想テーブルMY_TABLE_MASKを評価するには、以下のSQLコマンドを実行してください
CALL DVSYS.EXT_AUTHORIZER_EXPLAIN('MY_SCHEMA', 'MY_TABLE_MASK', 'USER1', ?);
2つのカラムマスクルールが適用されているオブジェクトの場合、出力は次の例のように表示される場合があります
Value of output parameters -------------------------- Parameter name : AUTHORIZER_EXPLAIN Parameter value : {"IKC":{"resource_key":"1ed88d5b-148e-49c5-85a3-000000000000:/MY_SCHEMA/MY_TABLE_MASK","evaluation_outcome":"Transform","governance_convention":"AEAD","asset_id":"f11f6916-dc49-4838-869a-000000000000","container":{"id":"753b9703-4f82-4552-9906-000000000000","name":"Default"},"is_cached":false,"user_id":"000000000000","rules":[{"id":"e4de009b-ea72-4bc2-b70c-000000000000","name":"Name mask"},{"id":"275e2e1b-4d13-4d91-939d-000000000000","name":"Redact first name"}],"transform_spec":[{"operation_type":"research/pseudo","parameters":[{"salt":"034f0be01d66800028a7fb5069e1b5f59b3c876ba3c2d00436db09b3e0e50072","dataclass":"LastName","maskingType":"Full","name":"LAST_NAME","preserveFormat":"true","maskingProcessor":"FormatPreservingTokenization"}],"profiled_dataclass":"LastName"},{"operation_type":"research/pseudo-pretty","parameters":[{"maskingChar":"X","maskingType":"Full","name":"FIRST_NAME","preserveFormat":"false","maskingLen":"10"}],"profiled_dataclass":"FirstName"}]}}
この例では、
は評価の結果、2つの列がマスクされたことを示していますtransform_spec
カラムは、フォーマットを維持する難読化でマスクされます。LAST_NAME
列は全面的に墨塗り、または の10文字で隠されています。FIRST_NAME
X
"transform_spec": [{ "operation_type": "research/pseudo", "parameters": [{ "salt": "000f0be01d6680b62007fb5069e1b0009b3c876ba000d65006db09b3e0e50072", "dataclass": "LastName", "maskingType": "Full", "name": "LAST_NAME", "preserveFormat": "true", "maskingProcessor": "FormatPreservingTokenization" }], "profiled_dataclass": "LastName" }, { "operation_type": "research/pseudo-pretty", "parameters": [{ "maskingChar": "X", "maskingType": "Full", "name": "FIRST_NAME", "preserveFormat": "false", "maskingLen": "10" }], "profiled_dataclass": "FirstName" }]