SHOW RELEASE DIRECTIVES

Lists the release directives defined for an application package.

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

Specifies the type of target for the directive. The following values are possible:

  • 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

Specifies the application version literal if applicable; if not, the value is NULL.

patch

Specifies the patch number of the application version if applicable; if not, the value is 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

Specifies the list of Snowflake regions where the release directive will be applied in the future. Upgrade progress in active regions is monitored for a period before new regions are activated.

release_status

Specifies the current release status. The following values are possible:

  • 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

Specifies the release channel the release directive belongs to.

Notes sur l’utilisation

  • This command requires the OWNERSHIP privilege, the MANAGE RELEASES privilege, or the MANAGE VERSIONS privilege on the application package.

  • 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.

    Les noms des colonnes de sortie de cette commande sont générés en minuscules. Si vous consommez un jeu de résultats de cette commande avec l’opérateur de canal ou la fonction RESULT_SCAN, utilisez des identificateurs entre guillemets doubles pour les noms de colonnes de la requête, afin de vous assurer qu’ils correspondent aux noms de colonnes dans la sortie analysée. Par exemple, si le nom d’une colonne de sortie est type, spécifiez "type" pour l’identificateur.

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 |         |
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
Langage: Français