类别:

系统函数 (系统信息)

SYSTEM$GET_CLASSIFICATION_RESULT

返回指定对象的分类结果。

语法

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

实参

object_name

包含待分类列的表、外部表、视图或物化视图的名称。如果当前会话中未使用数据库和架构,则名称必须完全限定。

名称必须与数据库中存储的名称完全相同。如果名称包含特殊字符、大写字母或空格,则名称必须先用双引号括起来,然后再放在单引号内。

返回

返回以下格式的 JSON 对象。例如:

{
  "classification_profile_config": {
    "classification_profile_name": "db1.sch.sensitive_data_detection_profile"
  },
  "classification_result": {
    "col1_name": {
      "alternates": [],
      "recommendation": {
        "confidence": "HIGH",
        "coverage": 1,
        "details": [],
        "privacy_category": "QUASI_IDENTIFIER",
        "semantic_category": "DATE_OF_BIRTH",
        "tags": [
          {
            "tag_applied": true,
            "tag_name": "snowflake.core.semantic_category",
            "tag_value": "DATE_OF_BIRTH"
          },
          {
            "tag_applied": true,
            "tag_name": "snowflake.core.privacy_category",
            "tag_value": "QUASI_IDENTIFIER"
          }
        ]
      },
      "valid_value_ratio": 1
    }
  }
}
Copy

其中:

classification_profile_config

如果配置了自动分类,则该配置文件将包含用于生成分类结果的配置文件的完整限定名称。

classification_result

提供有关已分类的每个列的详细信息。

alternates

指定除推荐标签之外要考虑的每个标签和值的信息。

recommendation

提供分类过程中作为主要选择的每个标签和值的信息。

这些值可以同时显示在备用值和建议值中:

classifier_name

用于为分类列添加标签的自定义分类实例的完全限定名称。

仅在使用自定义分类实例作为要在列上设置的标签的来源时,才会显示此字段。

confidence

提供以下值之一:HIGHMEDIUMLOW。该值表示 Snowflake 根据列采样过程以及列数据与 Snowflake 数据分类方式的一致性而得出的相对置信度。

coverage

提供与特定类别的规则匹配的采样单元格值的百分比。

details

提供表示 SEMANTIC_CATEGORY 标签的 地理标签值 的字段和值。

privacy_category

提供隐私类别标签值。

可能的值为 IDENTIFIERQUASI-IDENTIFIERSENSITIVE

semantic_category

提供语义类别标签值。

有关可能的标签值,请参阅 系统标签和类别系统标签和类别

tags

提供分类过程中应用于列的标签信息。

valid_value_ratio

提供样本数量中有效值的比率。无效值包括 NULL、空字符串和字符数超过 256 个的字符串。

示例

返回表的敏感数据分类结果:

SELECT SYSTEM$GET_CLASSIFICATION_RESULT('hr.tables.empl_info');
Copy
语言: 中文