カテゴリ：

システム関数 （システム情報）

SYSTEM$GET_CLASSIFICATION_RESULT

指定されたオブジェクトの分類結果を返します。

構文

SELECT SYSTEM$GET_CLASSIFICATION_RESULT( '<object_name>' )
Copy

引数

object_name

分類される列を含むテーブル、外部テーブル、ビュー、またはマテリアライズドビューの名前。データベースとスキーマが現在のセッションで使用されていない場合は、名前を完全修飾する必要があります。

名前は、データベースに保存されているとおりに正確に指定する必要があります。名前に特殊文字、大文字小文字の区別、または空白スペースが含まれている場合は、名前を最初に二重引用符で囲み、次に一重引用符で囲む必要があります。

戻り値

以下の形式で JSON オブジェクトを返します。例:

{
  "classification_result": {
    "col1_name": {
      "alternates": [],
      "recommendation": {
        "confidence": "HIGH",
        "coverage": 1,
        "details": [
          {
            "coverage": 1,
            "semantic_category": "US_PASSPORT"
          }
        ],
        "privacy_category": "IDENTIFIER",
        "semantic_category": "PASSPORT"
      },
      "valid_value_ratio": 1
    },  
    "col2_name": { ... },
    ...
  }
}
Copy

条件:

alternates

推奨タグ以外の考慮すべき各タグと値に関する情報を指定します。

recommendation

各タグと値に関する情報を、分類プロセスに基づく主要な選択肢として指定します。

これらの値は、代替と推薦の両方に表示することができます。

classifier_name

分類された列にタグを付けるために使用されたカスタム分類インスタンスの完全修飾名。

このフィールドは、列に設定するタグのソースとしてカスタム分類インスタンスを使用する場合にのみ表示されます。

confidence

この列は、 HIGH、 MEDIUM、または LOW のいずれかの値を指定します。この値は、列のサンプリングプロセスと、列のデータとSnowflakeがデータを分類する方法の整合性に基づいて、Snowflakeが持つ相対的な信頼性を示します。

coverage

特定のカテゴリのルールに一致する、サンプリングされたセル値のパーセントを指定します。

details

SEMANTIC_CATEGORY タグに 地理タグ値 を参照するフィールドと値を指定します。

privacy_category

プライバシーカテゴリタグの値を指定します。

可能な値は、 IDENTIFIER、 QUASI-IDENTIFIER、および SENSITIVE です。

semantic_category

セマンティックカテゴリタグの値を指定します。

可能なタグの値については、 システムタグおよびカテゴリ および システムタグおよびカテゴリ をご参照ください。

valid_value_ratio

サンプルサイズにおける有効な値の比率を指定します。無効な値には、 NULL、空の文字列、256文字を超える文字列などがあります。

使用上の注意

  • タグ値を更新するには、 ALTER TABLE ... MODIFY COLUMN ... SET TAG ステートメントを使用します。

  • 列から分類システムタグを設定解除するには、 ALTER TABLE ... MODIFY COLUMN ... UNSET TAG ステートメントを使用します。

例

テーブルのデータ分類結果を返します。

SELECT SYSTEM$GET_CLASSIFICATION_RESULT('hr.tables.empl_info');
Copy
言語: 日本語