Categorias:: Funções do sistema (Informações do sistema)

SYSTEM$GET_CLASSIFICATION_RESULT¶

Retorna o resultado da classificação do objeto especificado.

Sintaxe¶

SELECT SYSTEM$GET_CLASSIFICATION_RESULT( '<object_name>' )

Argumentos¶

object_name

O nome da tabela, tabela externa, exibição ou exibição materializada contendo as colunas a serem classificadas. Se um banco de dados e esquema não estiverem em uso na sessão atual, o nome deve ser totalmente qualificado.

O nome deve ser especificado exatamente como está armazenado no banco de dados. Se o nome contiver caracteres especiais, letras maiúsculas ou espaços em branco, o nome deve ser incluído primeiro em aspas duplas e depois em aspas simples.

Retornos¶

Retorna um objeto JSON no seguinte formato. Por exemplo:

{
  "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
    }
  }
}

Possíveis campos:

classification_profile_config: Se a classificação automática estiver configurada, contém o nome totalmente qualificado do perfil de configuração que foi usado para gerar os resultados da classificação.
classification_result: Fornece detalhes sobre cada coluna que foi classificada.
object_path_results: Quando uma coluna contém dados semiestruturados com campos confidenciais, a chave object_path_results lista os campos que foram classificados em uma categoria semântica nativa ou personalizada. Para obter mais informações, consulte Visualizar os resultados da classificação para colunas JSON.
alternates: Fornece informações sobre cada tag e valores a serem considerados além da tag recomendada.
recommendation: Fornece informações sobre cada tag e valor como a escolha principal com base no processo de classificação.

Esses valores podem aparecer tanto nas alternativas quanto na recomendação:

classifier_name
O nome completo da instância de classificação personalizada que foi usada para marcar a coluna classificada.

Este campo só aparece ao usar uma instância de classificação personalizada como origem da tag a ser definida em uma coluna.

confidence
Fornece um dos seguintes valores: HIGH, MEDIUM ou LOW. Este valor indica a confiança relativa que o Snowflake tem com base no processo de amostragem da coluna e como os dados da coluna se alinham com a forma como o Snowflake classifica os dados.

coverage
Fornece a porcentagem de valores de células amostradas que correspondem às regras de uma determinada categoria.

details
Apresenta campos e valores relacionados à classificação específica da geografia. O campo semantic_category contém a subcategoria semântica de uma localidade.

privacy_category
Fornece a categoria de privacidade.

Os valores possíveis são IDENTIFIER, QUASI-IDENTIFIER e SENSITIVE.

semantic_category
Fornece a categoria semântica. Para obter uma lista de categorias semânticas nativas, consulte Categorias semânticas nativas da classificação de dados confidenciais.

Se o valor for MULTIPLE, os dados confidenciais foram encontrados nos dados semiestruturados. Inspecione o campo object_path_results do objeto de resultados para ver uma discriminação detalhada de quais categorias semânticas nativas e personalizadas foram encontradas durante a classificação. Para obter mais informações, consulte Visualizar os resultados da classificação para colunas JSON.

tags
Fornece informações sobre as tags que foram aplicadas à coluna como resultado do processo de classificação.

valid_value_ratio
Mostra a proporção de quantos valores no tamanho da amostra são válidos.

Para dados estruturados, os valores inválidos incluem NULL, uma cadeia de caracteres vazia e uma cadeia de caracteres com mais de 256 caracteres.

Para dados semiestruturados, os valores inválidos incluem NULL e uma cadeia de caracteres vazia.

Exemplos¶

Retorna o resultado da classificação de dados confidenciais de uma tabela:

SELECT SYSTEM$GET_CLASSIFICATION_RESULT('hr.tables.empl_info');