SHOW RELEASE DIRECTIVES

Répertorie les directives de version définies pour un paquet d’application.

La sortie renvoie les métadonnées et les propriétés des directives de version d’un paquet d’application, classées par ordre lexicographique par nom. Ceci est important à noter si vous souhaitez filtrer les résultats à l’aide des filtres fournis.

Voir aussi :

ALTER APPLICATION PACKAGE, CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES

Syntaxe

SHOW RELEASE DIRECTIVES [ LIKE '<pattern>' ]
  IN APPLICATION PACKAGE <name>
  [ FOR RELEASE CHANNEL <release_channel> ]
Copy

Paramètres

name

Spécifie l’identificateur du paquet d’application.

LIKE 'pattern'

Filtre optionnellement la sortie de la commande par le nom de la version spécifiée dans le paquet d’application. Le filtre utilise une concordance de motif insensible à la casse avec prise en charge des caractères génériques SQL (% et _).

Par exemple, les motifs suivants donnent les mêmes résultats :

... LIKE '%v1%' ...
... LIKE '%V1%' ...

. Par défaut : aucune valeur (aucun filtrage n’est appliqué à la sortie).

FOR RELEASE CHANNEL release_channel

Renvoie uniquement les directives de version définies pour les canaux de version spécifiés.

Sortie

La sortie de commande fournit les propriétés des directives de version et les métadonnées dans les colonnes suivantes :

Colonne

Description

name

Spécifie le nom de la directive de version. Pour la directive de version par défaut, le nom est DEFAULT.

target_type

Spécifie le type de cible pour la directive. Les valeurs suivantes sont possibles :

  • DEFAULT

  • ACCOUNT

target_name

Indique le nom de l’organisation ou du compte. La valeur de la directive de version par défaut est toujours NULL.

created_on

Indique l’heure à laquelle la directive de version a été créée.

version

Spécifie le littéral de version de l’application, le cas échéant ; si ce n’est pas le cas, la valeur est NULL.

patch

Spécifie le numéro de correctif de la version de l’application, le cas échéant ; si ce n’est pas le cas, la valeur est NULL.

modified_on

Indique l’horodatage de la dernière modification de la directive de version ou NULL si elle n’a pas été modifiée.

active_regions

Spécifie la liste des régions Snowflake où la directive de publication est autorisée à affecter les mises à niveau. Cette valeur est ignorée lorsque RELEASE_STATUS est HOLDING.

pending_regions

Spécifie la liste des régions Snowflake où la directive de publication sera appliquée à l’avenir. La progression de la mise à niveau dans les régions actives est surveillée pendant une période avant que de nouvelles régions ne soient activées.

release_status

Spécifie le statut actuel de la version. Les valeurs suivantes sont possibles :

  • IN_PROGRESS : les mises à niveau sont en cours dans la liste ACTIVE_REGIONS.

  • HOLDING : les mises à niveau sont temporairement suspendues.

  • DEPLOYED : les mises à niveau sont autorisées dans toutes les régions où l’application est installée.

deployed_on

Spécifie l’heure et la date à laquelle la directive de publication a été déployée. Lorsque trop de régions cibles sont identifiées comme non saines lors du déploiement, la directive de publication se déplace temporairement vers HOLDING.

release_channel

Spécifie le canal de version auquel appartient la directive de version.

Notes sur l’utilisation

  • Cette commande nécessite le privilège OWNERSHIP, le privilège MANAGE RELEASES ou le privilège MANAGE VERSIONS sur le paquet d’application.

  • La commande renvoie les résultats des directives de version qui correspondent aux privilèges accordés au rôle qui exécute cette commande.

  • La commande ne nécessite pas l’exécution d’un entrepôt en cours d’exécution.

  • La commande ne renvoie que les objets pour lesquels le rôle actuel de l’utilisateur s’est vu accorder au moins un privilège d’accès.

  • Le privilège d’accès MANAGE GRANTS permet implicitement à son titulaire de voir tous les objets du compte. Par défaut, seuls l’administrateur du compte (utilisateurs avec le rôle ACCOUNTADMIN) et l’administrateur de sécurité (utilisateurs avec le rôle SECURITYADMIN) ont le privilège MANAGE GRANTS.

  • Pour post-traiter la sortie de cette commande, vous pouvez utiliser la syntaxe opérateur de canal (->>) ou la fonction RESULT_SCAN. Les deux constructions traitent la sortie comme un jeu de résultats que vous pouvez interroger.

    Par exemple, vous pouvez utiliser l’opérateur de canal ou la fonction RESULT_SCAN pour sélectionner des colonnes spécifiques à partir de la sortie de commande SHOW ou pour filtrer les lignes.

    Lorsque vous faites référence aux colonnes de sortie, utilisez des identificateurs entre guillemets doubles pour les noms des colonnes. Par exemple, pour sélectionner la colonne de sortie type, spécifiez SELECT "type".

    Vous devez utiliser des identificateurs entre guillemets doubles, car les noms des colonnes de sortie pour les commandes SHOW sont en minuscules. Les guillemets doubles garantissent que les noms des colonnes dans la liste SELECT ou dans la clause WHERE correspondent aux noms des colonnes dans la sortie de commande SHOW qui a été analysée.

Exemples

SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;
Copy
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
| name    | target_type | target_name                     | created_on                    | version | patch | modified_on                   | active_regions         | pending_regions          | release_status | deployed_on                   |
|---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
| DEFAULT | DEFAULT     | NULL                            | 2023-04-02 14:55:17.304 -0700 | V2      |     0 | 2023-04-02 15:47:08.673 -0700 | PUBLIC.AWS_AP_SOUTH_1  | PUBLIC.AWS_AP_SOUTH_1    | IN PROGRESS    |                               |
| NEW_RD  | ACCOUNT     | [PROVIDER_DEV.PROVIDER_AWS]     | 2023-04-02 16:30:44.443 -0700 | V1      |     1 | 2023-04-03 07:10:42.428 -0700 | ALL                    |                          | DEPLOYED       | 2023-04-03 07:10:42.428 -0700 |         |
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+