DROP CATALOG INTEGRATION

Supprime une intégration de catalogue du compte.

Voir aussi :

CREATE CATALOG INTEGRATION , ALTER CATALOG INTEGRATION , SHOW CATALOG INTEGRATIONS , DESCRIBE CATALOG INTEGRATION

Syntaxe

DROP CATALOG INTEGRATION [ IF EXISTS ] <name>
Copy

Paramètres

name

Indique l’identificateur de l’intégration de catalogue à supprimer. Si l’identificateur contient des espaces, des caractères spéciaux ou des caractères majuscules et minuscules, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse (par exemple, "My Catalog").

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

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

Privilège

Objet

Remarques

OWNERSHIP

Intégration (catalogue)

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.

Notes sur l’utilisation

  • Les intégrations de catalogue supprimées ne peuvent pas être récupérées ; elles doivent être recréées.

  • Vous ne pouvez pas supprimer ni remplacer une intégration de catalogue si une ou plusieurs tables Apache Iceberg™ sont associées à l’intégration de catalogue.

    Pour voir les tables qui dépendent d’une intégration de catalogue, vous pouvez utiliser la commande SHOW ICEBERG TABLES et une requête utilisant RESULT_SCAN qui applique un filtre sur la colonne catalog_name.

    Note

    L’identificateur de colonne (catalog_name) est sensible à la casse. Spécifiez l’identificateur de colonne exactement tel il apparaît dans la sortie SHOW ICEBERG TABLES.

    Par exemple :

    SHOW ICEBERG TABLES;
    
    SELECT * FROM TABLE(
      RESULT_SCAN(
          LAST_QUERY_ID()
        )
      )
      WHERE "catalog_name" = 'my_catalog_integration_1';
    
    Copy

Exemples

Supprimer une intégration de catalogue :

DROP CATALOG INTEGRATION myInt;
Copy

Supprimer de nouveau l’intégration de catalogue, mais ne pas déclencher d’erreur si l’intégration n’existe pas :

DROP CATALOG INTEGRATION IF EXISTS myInt;
Copy