DESCRIBE APPLICATION¶

Affiche des informations sur un objet d’application créé à l’aide de la commande Snowflake Native App Framework.

DESCRIBE peut être abrégé en DESC.

Voir aussi :: ALTER APPLICATION PACKAGE, CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES,

Syntaxe¶

DESC[RIBE] APPLICATION <name>

Copy

Paramètres¶

name: Spécifie l’identificateur de l’application à décrire.

Sortie¶

La commande fournit les propriétés d’un objet d’application dans les colonnes suivantes :

Colonne	Description
`property`	Nom de la propriété de l’objet d’application. Cette colonne peut inclure les propriétés répertoriées dans le tableau suivant.
`value`	Valeur attribuée à la propriété de l’objet d’application.

La colonne property peut contenir les propriétés suivantes d’un objet d’application :

Propriété	Description
`name`	Nom de l’objet d’application.
`source_organization`	Le nom de l’organisation du compte contenant le paquet d’application utilisé pour créer l’objet d’application.
`source_account`	Compte du paquet d’application utilisé pour créer l’objet d’application.
`source_type`	Source utilisée pour créer l’application. Les valeurs valides sont `APP_PACKAGE` et `LISTING`.
`source`	Nom du paquet d’application ou de l’annonce utilisée pour créer l’objet d’application.
`version`	Identificateur de version de l’objet d’application.
`version_label`	Étiquette de la version de l’objet d’application. Cette étiquette est visible par le consommateur lorsqu’il installe une Snowflake Native App.
`patch`	Numéro de correctif de l’objet d’application.
`created_on`	Horodatage de création de l’objet d’application.
`last_upgraded_on`	Horodatage de la dernière mise à niveau de l’objet d’application.
`share_events_with_provider`	Indique si la journalisation et le partage d’événements sont activés pour l’objet d’application.
`log_level`	Niveau de journalisation défini pour l’objet d’application.
`trace_level`	Niveau de traçage défini pour l’objet d’application.
`debug_mode`	Indique si l’application a été créée en mode débogage.
`upgrade_state`	État actuel de l’installation ou de la mise à niveau en arrière-plan de l’objet d’application. Les valeurs valides sont : `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é. La raison de l’échec est indiquée dans la colonne `UPGRADE_FAILURE_REASON` le cas échéant. `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 dans l’état `FAILED` jusqu’à ce qu’une directive de version soit mise à jour pour pointer vers une version différente de celle visée par la mise à niveau, telle que définie dans la TARGET_UPGRADE_VERSION. `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.
`upgrade_target_version`	Identificateur de la version vers laquelle l’objet d’application est mis à niveau.
`upgrade_target_patch`	Correctif vers lequel l’objet d’application est mis à niveau.
`upgrade_attempt`	Indique si une mise à niveau a été tentée pour l’objet d’application.
`upgrade_task_id`	Identificateur de tâche interne pour la tentative de mise à niveau.
`upgrade_started_on`	Horodatage du moment où la mise à niveau a été initiée.
`upgrade_attempted_on`	Horodatage de la dernière mise à niveau de l’objet d’application.
`upgrade_failure_reason`	Raison de l’échec de la mise à niveau, le cas échéant.
`previous_version`	Identificateur de la version précédente de l’objet d’application.
`previous_patch`	Numéro du correctif précédent de l’objet d’application installé.
`previous_version_state`	Statut de la version précédente de l’objet d’application.

Notes sur l’utilisation¶

Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.

Exemples¶

Décrit les propriétés d’un objet d’application :

DESC APPLICATION hello_snowflake_app;

Copy

+----------------------------+-------------------------------+
| property                   | value                         |
|----------------------------+-------------------------------|
| name                       | hello_snowflake_app           |
| source_organization        | my_organization               |
| source_account             | provider_account              |
| source_type                | APPLICATION PACKAGE           |
| source                     | hello_snowflake_package       |
| version                    | v1_0                          |
| version_label              | NULL                          |
| patch                      | 0                             |
| created_on                 | 2023-05-25 08:30:41.520 -0700 |
| last_upgraded_on           |                               |
| share_events_with_provider | FALSE                         |
| log_level                  | OFF                           |
| trace_level                | OFF                           |
| debug_mode                 | FALSE                         |
| upgrade_state              | COMPLETE                      |
| upgrade_target_version     | NULL                          |
| upgrade_target_patch       | 0                             |
| upgrade_attempt            | NULL                          |
| upgrade_task_id            | NULL                          |
| upgrade_started_on         |                               |
| upgrade_attempted_on       |                               |
| upgrade_failure_reason     | NULL                          |
| previous_version           | NULL                          |
| previous_patch             | 0                             |
| previous_version_state     | COMPLETE                      |
+----------------------------+-------------------------------+