custom_classifier
!ADD_REGEX¶
- こちらもご参照ください。
カスタム分類子にカテゴリと正規表現を追加し、オプションで列名とコメントに正規表現を指定します。
構文¶
<custom_classifier>!ADD_REGEX(
'<semantic_category>' ,
'<privacy_category>' ,
'<value_regex>' ,
[ <column_name_regex> ] ,
[ <description> ] ,
[ <threshold> ]
)
引数¶
必須:
semantic_category
セマンティックカテゴリの識別子(名前)を指定します。
セマンティックカテゴリの詳細については、 システムタグおよびカテゴリ をご参照ください。
privacy_category
'IDENTIFIER'
、'QUASI_IDENTIFIER'
、'SENSITIVE'
の値のいずれかを指定します。プライバシーカテゴリの詳細については、 システムタグおよびカテゴリ をご参照ください。
value_regex
列の値に一致する正規表現を指定します。
REGEXP_LIKE 関数を呼び出すと、正規表現の構文をテストできます。
オプション:
column_name_regex
分類する列名に一致する正規表現を指定します。
description
インスタンスに追加する値のコメントを指定します。
threshold
スコアリングルールのしきい値を指定します。
許容範囲は
0.0
より大きく、1.0
以下になります。デフォルト:
0.8
。
出力¶
classifier_name:category_name
の形式で、カスタム分類子とカテゴリの関連付けを示すステータスメッセージを返します。
アクセス制御の要件¶
この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。
インスタンスロール |
オブジェクト |
メモ |
---|---|---|
|
カスタム分類インスタンス。 |
このメソッドを呼び出すアカウントロールには、カスタム分類子でこのインスタンスロールが付与されている必要があります。 デフォルトでは、インスタンスの作成に使用されたアカウントロールにより、このメソッドを呼び出すことができます。 |
スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
使用上の注意¶
このメソッドを複数回呼び出すと、インスタンスに関連付けられた正規表現の数が加算されます。
各メソッドを別々の SQL ステートメントで呼び出します(メソッドは連結しません)。
分類目的の正規表現検索はいずれも、大文字と小文字を区別しません。
カスタム分類インスタンスに正規表現を追加する前に、正規表現をテストします。たとえば、正規表現に一致する値だけが結果に返されるようにするには、 [ NOT ] REGEXP 関数を使用します。
SELECT <col_to_classify> FROM <table_with_col_to_classify> WHERE <col_to_classify> REGEXP('<regex>');
詳細については、 文字列関数(正規表現) をご参照ください。
例¶
medical_codes
インスタンスにカテゴリと正規表現を追加します。
CALL medical_codes!ADD_REGEX(
'ICD_10_CODES',
'IDENTIFIER',
'[A-TV-Z][0-9][0-9AB]\.?[0-9A-TV-Z]{0,4}',
'ICD.*',
'Add a regex to identify ICD-10 medical codes in a column',
0.8,
);
戻り値:
+---------------+
| ADD_REGEX |
+---------------+
| ICD_10_CODES |
+---------------+