Categorias:: Funções de métricas de dados

NULL_PERCENT (função de métricas de dados do sistema)¶

Retorna a porcentagem de valores de colunas NULL para a coluna especificada em uma tabela.

Este tópico fornece a sintaxe para chamar a função diretamente. Para saber como associar a função a uma tabela ou visualização para que seja executada em intervalos regulares, consulte Associe uma DMF para automatizar as verificações de qualidade dos dados.

Sintaxe¶

SNOWFLAKE.CORE.NULL_PERCENT(<query>)

Copy

Argumentos¶

query: Especifica uma consulta SQL que projeta uma única coluna.

Tipos de dados permitidos¶

A coluna projetada pela query deve ter um dos seguintes tipos de dados:

DATE
FLOAT
NUMBER
TIMESTAMP_LTZ
TIMESTAMP_NTZ
TIMESTAMP_TZ
VARCHAR

Retornos¶

A função retorna um valor NUMBER.

Requisitos de controle de acesso¶

Associar e executar um DMF do sistema requer o privilégio USAGE no DMF do sistema. Você pode conceder a função de banco de dados SNOWFLAKE.DATA_METRIC_USER para fornecer aos usuários o privilégio USAGE em todos os DMFs do sistema. Para obter mais informações, consulte Concessão do privilégio USAGE em DMFs do sistema.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Exemplo¶

Meça a porcentagem de valores NULL para a coluna SSN (por exemplo, número do segurança social nos US):

SELECT SNOWFLAKE.CORE.NULL_PERCENT(
  SELECT
    ssn
  FROM hr.tables.empl_info
);

Copy

+----------------------------------------------------------------+
| SNOWFLAKE.CORE.NULL_COUNT(SELECT ssn FROM hr.tables.empl_info) |
+----------------------------------------------------------------+
| 1                                                              |
+----------------------------------------------------------------+