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 , ALTER CONNECTION , DROP CONNECTION

Syntaxe¶

SHOW CONNECTIONS [ LIKE '<pattern>' ]

Copy

Paramètres¶

LIKE 'pattern'

(Facultatif) 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%' ...

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

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. La sortie de la commande pour les organisations qui couvrent plusieurs groupes régionaux comprend une colonne region_group supplémentaire.

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`	Snowflake Region où se trouve le compte. Une Snowflake Region est un emplacement distinct dans une région de plate-forme Cloud qui est isolée des autres Snowflake Region. Une Snowflake Region 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%';

Copy