Catégories :

Fonctions de table (Tables)

APPLICATION_CONFIGURATION_VALUE_HISTORY

Fournit un historique des modifications de valeurs pour les:doc:configurations d’application </developer-guide/native-apps/app-configuration> dans l’Snowflake Native App spécifiée.

Vous pouvez appeler cette fonction pour vérifier l’historique des modifications de valeurs pour une configuration d’application. Pour plus d’informations, voir Configuration d’application.

Syntaxe

APPLICATION_CONFIGURATION_VALUE_HISTORY(
  [ APPLICATION_NAME => '<application_name>' ]
  [ , CONFIGURATION_NAME => '<config_name>' ]
)
Copy

Arguments

Obligatoire :

application_name

Nom de l’application dans laquelle se trouve la configuration.

Facultatif :

config_name

Nom de la configuration. Si elle n’est pas fournie, la fonction renvoie l’historique de toutes les configurations de l’application.

Renvoie

La fonction renvoie les colonnes suivantes :

Colonne

Type de données

Description

NAME

STRING

Nom de la configuration, définie par le fournisseur.

APPLICATION_NAME

STRING

Nom de l’application dans laquelle se trouve la configuration.

CREATED_ON

TIMESTAMP

Horodatage de la création de l’objet de configuration.

UPDATED_ON

TIMESTAMP

Horodatage de la dernière mise à jour de l’objet de configuration.

TYPE

STRING

Type de la configuration. Les valeurs possibles sont APPLICATION_NAME et STRING.

STATUS

STRING

État de la configuration. Les valeurs possibles sont PENDING et DONE.

SENSITIVE

BOOLEAN

Indique si la valeur est sensible ou non.

VALUE

STRING

Valeur définie par le consommateur.

Pour les configurations d’application de type APPLICATION_NAME, il s’agit du nom le plus récent de l’application spécifiée par le consommateur. Il se peut que cette valeur soit différente de celle fournie initialement si l’application a été renommée. Si l’application a été supprimée, aucune valeur ne sera affichée ici, comme si la valeur n’était pas définie.

Lorsque SENSITIVE=TRUE, la valeur est masquée, à moins que le rôle d’exécution ne soit l’application propriétaire de la configuration.

VALUE_UPDATED_ON

TIMESTAMP

Dernier horodatage de mise à jour lorsque la valeur a été définie ou supprimée.

LABEL

STRING

Nom convivial à afficher dans l’UI , fourni par le fournisseur.

DESCRIPTION

STRING

Description de la configuration.

APPLICATION_ROLES

STRING

Noms de rôles d’application séparés par des virgules ayant accès à la configuration.

Ceci affiche les noms les plus récents, même si les rôles ont été renommés. Si un rôle d’application a été supprimé, il ne sera pas inclus dans la liste de sortie.

Notes sur l’utilisation

  • La vue n’affiche que les configurations pour lesquelles le rôle actuel de la session s’est vu accorder des privilèges d’accès.

  • La vue n’inclut pas les configurations qui ont été supprimées.

  • Lors de l’appel d’une fonction de la table de schémas d’informations, la session doit avoir un schéma INFORMATION_SCHEMA en cours d’utilisation ou le nom de la fonction doit être complètement qualifié. Pour plus de détails, voir Schéma d’information de Snowflake.

Exemples

Récupérer l’historique des changements de valeurs pour la configuration d’application config_name dans l’application application_name :

SELECT * FROM TABLE(information_schema.application_configuration_value_history(application_name => 'my_app', configuration_name => 'my_configuration'));
Copy