- 类别:
系统函数 (系统信息)
SYSTEM$GET_CLASSIFICATION_RESULT¶
返回指定对象的分类结果。
语法¶
SELECT SYSTEM$GET_CLASSIFICATION_RESULT( '<object_name>' )
实参¶
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
}
}
}
其中:
classification_profile_config
如果配置了自动分类,则该配置文件将包含用于生成分类结果的配置文件的完整限定名称。
classification_result
提供有关已分类的每个列的详细信息。
alternates
指定除推荐标签之外要考虑的每个标签和值的信息。
recommendation
提供分类过程中作为主要选择的每个标签和值的信息。
这些值可以同时显示在备用值和建议值中:
classifier_name
用于为分类列添加标签的自定义分类实例的完全限定名称。
仅在使用自定义分类实例作为要在列上设置的标签的来源时,才会显示此字段。
confidence
提供以下值之一:
HIGH
、MEDIUM
或LOW
。该值表示 Snowflake 根据列采样过程以及列数据与 Snowflake 数据分类方式的一致性而得出的相对置信度。coverage
提供与特定类别的规则匹配的采样单元格值的百分比。
details
提供表示 SEMANTIC_CATEGORY 标签的 地理标签值 的字段和值。
privacy_category
提供隐私类别标签值。
可能的值为
IDENTIFIER
、QUASI-IDENTIFIER
和SENSITIVE
。semantic_category
提供语义类别标签值。
tags
提供分类过程中应用于列的标签信息。
valid_value_ratio
提供样本数量中有效值的比率。无效值包括 NULL、空字符串和字符数超过 256 个的字符串。
示例¶
返回表的敏感数据分类结果:
SELECT SYSTEM$GET_CLASSIFICATION_RESULT('hr.tables.empl_info');