Catégories :

Information Schema , Fonctions de table

DATA_METRIC_FUNCTION_EXPECTATIONS

Renvoie des informations sur les conditions présentent dans le compte.

Syntaxe

DATA_METRIC_FUNCTION_EXPECTATIONS(
  [ METRIC_NAME => '<string>' ]
  [, REF_ENTITY_NAME => '<string>' ]
  [, REF_ENTITY_DOMAIN => '<string>' ]
)
Copy

Arguments

METRIC_NAME => 'string'

Spécifie le nom d’une fonction métrique de données système ou personnalisée (DMF). Cette fonction renvoie les conditions qui ont été ajoutées aux associations entre les objets et la DMF spécifiée.

REF_ENTITY_NAME => 'string'

Spécifie le nom d’un objet avec lequel les DMFs sont associées. Renvoie les conditions qui ont été ajoutées aux associations DMF avec l’objet. Si spécifié, vous devez également spécifier REF_ENTITY_DOMAIN.

Le nom entier de l’objet doit être entre guillemets simples.

Si le nom de l’objet est sensible à la casse ou inclut des caractères spéciaux ou des espaces, des guillemets doubles sont nécessaires pour traiter la casse / les caractères. Les guillemets doubles doivent être placés entre guillemets simples, par exemple '"table_name"'.

REF_ENTITY_DOMAIN => 'string'

Le type d’objet de REF_ENTITY_NAME.

  • Si l’objet est un type de table, utilisez table comme valeur d’argument.

  • Si l’objet est une vue ou une vue matérialisée, utilisez view comme valeur d’argument.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

metric_database_name

VARCHAR

Base de données où se trouve la DMF.

metric_schema_name

VARCHAR

Schéma où se trouve la DMF.

metric_name

VARCHAR

Nom de l’DMF.

metric_signature

VARCHAR

Signature de la DMF.

metric_data_type

VARCHAR

Le type de données renvoyé par la DMF.

ref_entity_database_name

VARCHAR

Base de données de l’objet associé à la DMF.

ref_entity_schema_name

VARCHAR

Schéma de l’objet associé à la DMF.

ref_entity_name

VARCHAR

Nom de l’objet associé à la DMF.

ref_entity_domain

VARCHAR

Type d’objet associé à la DMF.

ref_arguments

ARRAY

Arguments transmis à la DMF.

ref_id

VARCHAR

Identificateur généré par le système.

expectation_id

VARCHAR

Identificateur généré par le système de la condition.

expectation_name

VARCHAR

Nom donné à la condition par l’utilisateur lors de son ajout à l’association DMF.

expectation_expression

VARCHAR

Expression booléenne de la condition. Voir Définir ce qui répond à l’attente.

Exemples

Renvoyer les conditions qui existent pour un objet spécifique.

SELECT *
  FROM TABLE(
    INFORMATION_SCHEMA.DATA_METRIC_FUNCTION_EXPECTATIONS(
      REF_ENTITY_NAME => 'my_table',
      REF_ENTITY_DOMAIN => 'table'));
Copy

Renvoyer les conditions qui existent pour une DMF spécifique.

SELECT *
  FROM TABLE(
    INFORMATION_SCHEMA.DATA_METRIC_FUNCTION_EXPECTATIONS(
      METRIC_NAME => 'SNOWFLAKE.CORE.NULL_COUNT'));
Copy

Renvoyer les conditions qui existent pour une association spécifique entre un objet et une DMF.

SELECT *
  FROM TABLE(
    INFORMATION_SCHEMA.DATA_METRIC_FUNCTION_EXPECTATIONS(
      METRIC_NAME => 'SNOWFLAKE.CORE.NULL_COUNT',
      REF_ENTITY_NAME => 'my_table',
      REF_ENTITY_DOMAIN => 'table'));
Copy