Catégories :

Compte et session DDL

SHOW CONNECTIONS

Liste les connexions pour lesquelles vous avez des privilèges d’accès.

La sortie renvoie les métadonnées et les propriétés des connexions, classées par nom de connexion (voir Sortie dans ce chapitre pour lire les descriptions des colonnes de sortie). Ceci est important à noter si vous souhaitez filtrer les résultats à l’aide des filtres fournis.

Voir aussi :

CREATE CONNECTION , DROP CONNECTION

Syntaxe

SHOW CONNECTIONS [ LIKE '<pattern>' ]

Paramètres

LIKE 'motif'

Filtre la sortie de commande par nom d’objet. 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 '%testing%' ...
... LIKE '%TESTING%' ...

Notes sur l’utilisation

  • L’exécution de la commande ne nécessite pas l’exécution d’un entrepôt virtuel en cours d’exécution.

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

  • Seuls les administrateurs de compte (utilisateurs dotés du rôle ACCOUNTADMIN) peuvent exécuter cette commande SQL.

Sortie

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

| snowflake_region | created_on | account_name | name | comment | is_primary | primary | failover_allowed_to_acounts | connection_url | organization_name | account_locator

Le résultat de la commande pour les organisations qui couvrent plusieurs groupes régionaux comprend une colonne region_group supplémentaire :

| region_group | snowflake_region | created_on | account_name | name | comment | is_primary | primary | failover_allowed_to_acounts | connection_url | organization_name | account_locator

Colonne

Description

region_group

Groupe de régions où se trouve le compte. Remarque : cette colonne n’est affichée que pour les organisations qui couvrent plusieurs groupes régionaux.

snowflake_region

Région Snowflake où se trouve le compte. Une région Snowflake est un emplacement distinct dans une région de plate-forme Cloud qui est isolée des autres régions Snowflake. Une région Snowflake peut être à plusieurs locataires ou à locataire unique (pour un compte Virtual Private Snowflake).

created_on

Date et heure de création de la connexion.

account_name

Nom du compte. Un administrateur de l’organisation (c’est-à-dire un utilisateur ayant le rôle ORGADMIN) peut modifier le nom du compte.

name

Nom de la connexion.

comment

Commentaire pour la connexion.

is_primary

Indique si la connexion est une connexion primaire.

primary

Nom de l’organisation, nom du compte et nom de la connexion primaire. Cette valeur peut être copiée dans la clause AS REPLICA OF de la commande CREATE CONNECTION lors de la création de connexions secondaires.

failover_allowed_to_accounts

Une liste de tous les comptes vers lesquels la connexion primaire peut être redirigée.

connection_url

URL de connexion que les utilisateurs transmettent à un client pour établir une connexion à Snowflake.

organization_name

Nom de votre organisation Snowflake.

account_locator

Localisateur de compte dans une région.

Pour plus d’informations sur les propriétés pouvant être spécifiées pour une connexion, voir CREATE CONNECTION.

Exemples

Afficher toutes les connexions dont le nom commence par test :

SHOW CONNECTIONS LIKE 'test%';