<分類プロファイル名>!SET_TAG_MAP¶

構文¶

<classification_profile_name>!SET_TAG_MAP( <object> )

引数¶

object

SEMANTIC_CATEGORY システムタグに1つ以上のユーザー定義タグをマッピングする OBJECT。

'column_tag_map': [ ... ]

以下のキーと値のペアを持つオブジェクトの配列。

'tag_name': 'string'

タグの完全修飾名。

詳細については、 識別子の要件 をご参照ください。

'tag_value':'string'

タグの文字列値。

オプション: 指定しない場合は、 semantic_categories キーも省略する必要があります。省略された場合、SEMANTIC_CATEGORY システムタグが適用されているすべての列に tag_name タグが適用され、ユーザー定義タグの値は SEMANTIC_CATEGORY タグの値と一致します。

'semantic_categories': [ 'category' [ , 'category' ... ] ]

SEMANTIC_CATEGORY システムタグの カテゴリ のコンマ区切りリスト。

tag_name ユーザー定義タグは、SEMANTIC_CATEGORY タグの値が指定されたカテゴリのいずれかであるインスタンスにマッピングされます。

オプション: 指定しない場合は、 tag_value キーも省略する必要があります。省略された場合、システム SEMANTIC_CATEGORY タグが適用されているすべての列に tag_name タグが適用され、ユーザー定義タグの値は SEMANTIC_CATEGORY タグの値と一致します。

戻り値¶

成功ステータスメッセージまたはエラーメッセージを返します。詳細については、 タグマッピングについて をご参照ください。

アクセス制御の要件¶

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

スキーマ内のオブジェクトに対して操作を実行するには、親データベースとスキーマに対する USAGE 権限が必要です。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意¶

このメソッドを呼び出しても、オブジェクトは返されません。このため、メソッドの連結を使って、このメソッドの戻り値で別のメソッドを呼び出すことはできません。換わりに、各メソッドを別々の SQL ステートメントで呼び出します。

• 同じタグとセマンティックカテゴリが2つの異なる値にマッピングされている場合、 column_tag_map のオブジェクトの順序によって、列に設定するタグと文字列の値が決まります。 column_tag_map 配列を、優先順位の高いものから低いものへと並べ替えます。

例¶

単一のタグとその値を my_classification_profile インスタンスにマッピングします。

CALL my_classification_profile!SET_TAG_MAP(
  {
    'column_tag_map':[
      {
        'tag_name':'tag_db.sch.pii',
        'tag_value':'important',
        'semantic_categories':['NAME']
      }
    ]
  }
);