CREATE CATALOG

  • Article

S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 10.4 LTS et versions ultérieures oui coché Unity Catalog uniquement

Crée un catalogue avec le nom spécifié. Si un catalogue portant le même nom existe déjà, une exception est levée.

Lorsque vous créez un catalogue FOREIGN, il est rempli avec tous les schémas et leurs tables visibles par l’utilisateur d’authentification.

Syntaxe

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name ]
    [ MANAGED LOCATION 'location_path' ]
    [ COMMENT comment ]

CREATE FOREIGN CATALOG [ IF NOT EXISTS ] catalog_name
    USING CONNECTION connection_name
    [ COMMENT comment ]
    OPTIONS ( { option_name = option_value } [ , ... ] )

Paramètres

  • FOREIGN

    S’applique à :coche marquée oui Databricks SQL coché oui Databricks Runtime 13.3 LTS et versions ultérieures

    Spécifie que le catalogue est importé à partir d’une CONNEXION.

  • IF NOT EXISTS

    Crée un catalogue avec le nom donné s’il n’existe pas. Si un catalogue portant le même nom existe déjà, rien ne se produit.

  • catalog_name

    Nom du catalogue à créer.

  • USING SHARE provider_name.share_name

    Spécifie éventuellement que le catalogue est basé sur un partage Delta Sharing.

  • EMPLACEMENT MANAGÉ 'location_path'

    Spécifie éventuellement le chemin d’accès à un emplacement de stockage managé pour le catalogue qui est différent de l’emplacement de stockage racine du metastore. Ce chemin doit être défini dans une configuration d’emplacement externe, et vous devez disposer du privilège CREATE MANAGED STORAGE sur la configuration d’emplacement externe. Vous pouvez utiliser le chemin défini dans la configuration de l’emplacement externe ou un sous-chemin (en d’autres termes, 'abfss://container@storageaccount.dfs.core.windows.net/finance' ou 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Pris en charge dans Databricks SQL ou sur les clusters exécutant Databricks Runtime 11.3 LTS et versions ultérieures.

    Consultez aussi Tables managées et Créer un metastore de catalogue Unity.

  • UTILISATION DE LA CONNEXION connection_name

    Spécifie la connexion où réside le catalogue source.

  • commentaire

    Littéral STRING facultatif. Description du catalogue.

  • OPTIONS

    Définit les paramètres spécifiques au type de connexion nécessaires à l'identification du catalogue au niveau de la connexion.

    • option

      La clé d'option. La clé peut comporter un ou plusieurs identificateurs séparés par un point, ou un littéral STRING.

      Les clés d’option doivent être uniques et respectent la casse.

    • value

      Valeur de l'option. La valeur doit être BOOLEAN, STRING, INTEGER, ou uneDECIMALexpression constante. La valeur peut également être un appel à la fonction SQL SECRET. Par exemple, le value pour password peut comprendre secret('secrets.r.us', 'postgresPassword') au lieu d’entrer le mot de passe littéral.

Exemples

-- Create catalog `customer_cat`. This throws exception if catalog with name customer_cat
-- already exists.
> CREATE CATALOG customer_cat;

-- Create catalog `customer_cat` only if catalog with same name doesn't exist.
> CREATE CATALOG IF NOT EXISTS customer_cat;

-- Create catalog `customer_cat` only if catalog with same name doesn't exist, with a comment.
> CREATE CATALOG IF NOT EXISTS customer_cat COMMENT 'This is customer catalog';

-- Create a catalog from a Delta Sharing share.
> CREATE CATALOG customer_cat USING SHARE cdc.vaccinedata;

-- Create a catalog with a different managed storage location than the metastore's.
> CREATE CATALOG customer_cat MANAGED LOCATION 'abfss://container@storageaccount.dfs.core.windows.net/finance';

-- Create a foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');