Schéma :: DATA_SHARING_USAGE

Vue APPLICATION_STATE¶

Cette vue du schéma DATA_SHARING_USAGE peut être utilisée pour afficher des informations sur les applications installées à partir d’une annonce pour tous les paquets d’applications du compte actuel.

Si une annonce a été publiée à l’aide de Exécution automatique inter-Cloud, cette vue affiche des informations sur les applications installées dans toutes les régions.

Colonnes¶

Nom de la colonne	Type de données	Description
CONSUMER_SNOWFLAKE_REGION	VARCHAR	La région Snowflake du compte consommateur où l’application est installée.
CONSUMER_ORGANIZATION_NAME	VARCHAR	Nom de l’organisation du compte consommateur.
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	Localisateur du compte consommateur.
CONSUMER_ACCOUNT_NAME	VARCHAR	Nom du compte consommateur.
PROVIDER_SNOWFLAKE_REGION	VARCHAR	Région Snowflake du compte du fournisseur qui a créé le paquet d’application.
PROVIDER_ACCOUNT_LOCATOR	VARCHAR	Localisateur de compte du fournisseur.
PROVIDER_ACCOUNT_NAME	VARCHAR	Nom du compte du fournisseur.
PACKAGE_NAME	VARCHAR	Nom actuel du paquet d’application dans le compte du fournisseur à partir duquel l’application a été installée.
APPLICATION_NAME_HASH	VARCHAR	Chaîne de hachage du nom de l’instance d’application installée dans le compte consommateur. Le consommateur utilise la fonction SYSTEM$GET_HASH_FOR_APPLICATION pour calculer la valeur de hachage de l’application installée. Le consommateur peut ensuite utiliser cette valeur lorsqu’il contacte le fournisseur.
CREATED_ON	DATETIME	Horodatage de la première installation de l’instance d’application.
CURRENT_VERSION	VARCHAR	Version actuelle de l’application.
CURRENT_PATCH	INT	Niveau de correctif actuel de l’application.
CURRENT_INSTALLED_ON	DATETIME	Horodatage de l’installation de la version actuelle de l’application.
PREVIOUS_VERSION_STATE	VARCHAR	L’état de la version précédente. Les valeurs possibles sont COMPLETE et FINALIZING. `COMPLETE` indique que la mise à niveau est terminée et qu’il n’y a pas de requêtes actives en cours d’exécution à partir de la version précédente, si elle existe. `FINALIZING` indique que l’instance a été mise à niveau à partir de la version précédente, mais qu’une ou plusieurs requêtes utilisant la version précédente peuvent encore être en cours d’exécution.
PREVIOUS_VERSION	VARCHAR	Version précédente de l’application.
PREVIOUS_PATCH	INT	Niveau de correctif précédent de l’application.
UPGRADE_STATE	VARCHAR	Statut de la mise à niveau de la version de l’application. Pour plus d’informations, voir États de mise à niveau de la version d’application.
TARGET_UPGRADE_VERSION	VARCHAR	Version cible de l’application en cours d’exécution ou en attente de mise à niveau.
TARGET_UPGRADE_PATCH	INT	Niveau de correctif de la version de l’application en cours d’exécution ou en attente de mise à niveau.
UPGRADE_STARTED_ON	DATETIME	Date à laquelle la mise à niveau de l’application a commencé.
UPGRADE_ATTEMPT	INT	Nombre de tentatives de mise à niveau vers la version ou le correctif cible.
UPGRADE_ATTEMPTED_ON	DATETIME	Horodatage de la dernière tentative de mise à niveau.
UPGRADE_FAILURE_REASON	VARCHAR	Description de l’échec si la mise à niveau précédente de l’application a échoué.
LISTING_NAME	VARCHAR	Nom de l’annonce de l’échange de données à partir de laquelle l’application a été installée.
LISTING_DISPLAY_NAME	VARCHAR	Nom d’affichage de l’annonce.
EXCHANGE_NAME	VARCHAR	Nom d’échange de données de l’annonce à partir de laquelle l’application a été installée.
LAST_HEALTH_STATUS	VARCHAR	Le dernier état de santé signalé de l’application. Les valeurs possibles sont les suivantes : OK FAILED PAUSED
LAST_HEALTH_STATUS_UPDATED_ON	VARCHAR	L’horodatage du dernier signalement de l’état de santé.
ENABLED_TELEMETRY_EVENT_DEFINITIONS	VARCHAR	Une liste de définitions d’événements que le consommateur a activées. Voir À propos des définitions d’événements pour plus d’informations.
UPGRADE_STATE_UPDATED_ON	TIMESTAMP_LTZ	L’horodatage indiquant le moment où l’application est entrée dans son état de mise à jour actuel. Cette valeur est définie automatiquement par Snowflake.
DISABLEMENT_REASONS	VARCHAR	Un tableau contenant les raisons pour lesquelles l”Snowflake Native App a été désactivée. Voir Raisons pour lesquelles une application peut être désactivée.

Raisons pour lesquelles une application peut être désactivée¶

Le tableau suivant répertorie les valeurs possibles pour la colonne DISABLEMENT_REASONS :

Valeur	Description du statut	Est-ce récupérable ?
MANUALLY_DISABLED	L’application est désactivée par Snowflake	Oui. Pour réactiver l’application, contactez le support Snowflake.
ACCOUNT_INACTIVE	Le compte devient inactif en étant verrouillé ou suspendu, ce qui rend l’application indisponible. Dans cet état, un consommateur ne peut exécuter aucune requête SQL dans leur compte et l’application ne peut pas être mise à niveau.	Oui. L’application est automatiquement réactivée si le verrouillage ou la suspension du compte est supprimé
PACKAGE_VERSION_IS_MISSING	La version du paquet d’application pour l’application a été supprimée par le fournisseur.	Non. L’application ne peut plus être utilisée et doit être supprimée et réinstallée à partir d’une annonce ou d’un paquet d’application valide.
CMK_ACCESS_DENIED	Le consommateur gère lui-même la clé de chiffrement (ENCRYPT_USE_CMK_KMS est activé) et Snowflake n’a pas accès à cette clé.	Oui. Pour réactiver l’application, assurez-vous que la configuration du fournisseur Cloud permet de récupérer le CMK est correcte et que Snowflake a accès à la clé.
LISTING_ACCESS_REVOKED	L’annonce utilisée pour créer l’application n’est plus disponible. Les raisons possibles de ce statut incluent : Le fournisseur a supprimé l’annonce Le fournisseur a supprimé manuellement l’accès à l’annonce privée du compte du consommateur	Peut-être. La récupérabilité dépend de la raison pour laquelle l’accès a été révoqué. Par exemple, si l’annonce a été supprimée, elle ne peut pas être récupérée. Si un compte consommateur a été supprimé manuellement de l’annonce privée, l’accès à l’annonce et à l’application peut être restauré.
LISTING_TRIAL_USAGE_EXCEEDED	L’application a dépassé la limite d’utilisation pour une annonce d’essai basée sur l’utilisation.	Non
LISTING_PAYMENT_REQUIRED	L’annonce utilisée pour installer l’application est une annonce payante et nécessite un paiement pour une utilisation ultérieure.	Oui. Le consommateur doit configurer correctement le paiement de l’application.
LISTING_TRIAL_TIME_EXCEEDED	L’application a dépassé la durée de l’essai.	Non
APPLICATION_PACKAGE_NOT_AVAILABLE	Le paquet d’application utilisé pour créer l’application n’existe plus. Il est possible que le fournisseur ait supprimé le paquet d’application correspondant.	Non
APPLICATION_PACKAGE_DISABLED	Le paquet d’application utilisé pour créer l’application est désactivé par Snowflake.	Oui. L’application est réactivée si Snowflake réactive le paquet d’application.
APPLICATION_SUSPENDED	Les ressources de l’application, par exemple les tâches, les services et les pools de calcul, sont suspendues en raison de la désactivation de l’application. Les objets suspendus restent suspendus jusqu’à ce que l’application soit réactivée et qu’il n’y ait aucune autre raison pour laquelle l’application a été désactivée.	Oui
APPLICATION_SUSPEND_RESUME_IN_PROGRESS	Les ressources de l’application, par exemple les tâches, les services et les pools de calcul, reprennent actuellement.	Oui

États de mise à niveau de la version d’application¶

Les valeurs possibles pour la colonne UPGRADE_STATE sont les suivantes :

INSTALLING : l’objet de l’application est en cours de création.
INSTALL_FAILED : la création de l’objet d’application a échoué. L’objet de l’application reste dans l’état INSTALL_FAILED jusqu’à ce qu’il soit supprimé. Voir la colonne UPGRADE_FAILURE_REASON de la commande DESCRIBE APPLICATION pour des informations sur les raisons de l’échec de l’installation ou de la mise à niveau.
COMPLETE : le script d’installation a été exécuté avec succès et l’objet de l’application a été créé ou mis à niveau.
QUEUED : l’objet de l’application est dans la file d’attente de mise à niveau.
UPGRADING : l’objet de l’application est en cours de mise à niveau.
FAILED : toutes les tentatives de mise à niveau ont échoué. La raison de l’échec est indiquée dans la colonne UPGRADE_FAILURE_REASON le cas échéant. L’instance reste à l’état FAILED jusqu’à ce qu’une directive de version soit mise à jour de sorte à pointer vers une version différente de celle visée par la mise à niveau, comme défini dans la colonne TARGET_UPGRADE_VERSION.
QUEUED_DELAYED : l’objet de l’application est en file d’attente pour une mise à niveau planifiée pour une date ultérieure.
QUEUED_RETRY : l’instance a échoué à une ou plusieurs tentatives de mise à niveau. La raison de l’échec est indiquée dans UPGRADE_FAILURE_REASON : l’instance est en file d’attente pour effectuer une autre tentative de mise à niveau.
DISABLED : l’objet d’application et ses mises à niveau ont été désactivés. Dans cet état, l’instance sera inaccessible aux consommateurs, elle ne sera pas prise en compte pour les mises à niveau et ne bloquera pas la suppression de version des paquets d’application. La raison de l’échec est indiquée dans la colonne UPGRADE_FAILURE_REASON le cas échéant.

Notes sur l’utilisation¶

Il n’y a pas de conservation des données pour cette vue. Si une application est désinstallée, les informations contenues dans cette vue ne sont plus disponibles.