SHOW CATALOG INTEGRATIONS

Répertorie les intégrations de catalogue de votre compte. La sortie renvoie les métadonnées et les propriétés de l’intégration.

Voir aussi :

CREATE CATALOG INTEGRATION , ALTER CATALOG INTEGRATION , DROP CATALOG INTEGRATION , DESCRIBE CATALOG INTEGRATION

Syntaxe

SHOW CATALOG INTEGRATIONS [ 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).

Exigences en matière de contrôle d’accès

Un rôle utilisé pour exécuter cette commande SQL doit avoir au moins l’un des privilèges suivants définis au minimum ainsi :

Privilège

Objet

Remarques

USAGE

Intégration

OWNERSHIP

Intégration

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Sortie

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

Colonne

Description

name

Nom de l’intégration de catalogue.

enabled

Indique si l’intégration de catalogue peut être utilisée pour des tables Apache Iceberg.

type

Type de l’intégration. La valeur est toujours CATALOG.

category

Catégorie de l’intégration. La valeur est toujours CATALOG.

comment

Chaîne (littéral) qui spécifie un commentaire pour l’intégration.

created_on

Date et heure de création de l’intégration de catalogue.

Pour plus d’informations sur les propriétés qui peuvent être spécifiées pour une intégration de catalogue, voir CREATE CATALOG INTEGRATION.

Notes sur l’utilisation

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

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

Exemples

Afficher toutes les intégrations de catalogue :

SHOW CATALOG INTEGRATIONS;
Copy

Afficher toutes les intégrations de catalogue dont le nom commence par demo pour lesquelles vous disposez de privilèges d’affichage :

SHOW CATALOG INTEGRATIONS LIKE 'demo%';
Copy
Langage: Français