Partager via

CREATE CATALOG

S’applique à :coché Databricks SQL coché Databricks Runtime 10.4 LTS et versions ultérieures 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 tables visibles par l’utilisateur qui s’authentifie.

Syntaxe

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name |
      MANAGED LOCATION location_path |
      COMMENT comment |
      DEFAULT COLLATION default_collation_name |
      OPTIONS ( { option_name = option_value } [ , ... ] ) ] [...]

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

Parameters

  • ÉTRANGER

    S’applique à :coché Databricks SQL coché Databricks Runtime 13.3 LTS et version ultérieure

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

  • SI N'EXISTE PAS

    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.

  • UTILISATION D'UN PARTAGE provider_name.share_name

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

  • Lieu géré location_path

    Spécifie éventuellement le chemin d’accès à un emplacement de stockage managé pour le catalogue 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 des clusters exécutant Databricks Runtime 11.3 LTS et versions ultérieures.

    Consultez également les tables managées du Unity Catalog dans Azure Databricks pour Delta Lake et Apache Iceberg et Créer un metastore Unity Catalog.

  • UTILISATION D'UNE CONNEXION connection_name

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

  • commentaire

    Littéral STRING facultatif. Description du catalogue.

  • COLLATION PAR DÉFAUT default_collation_name

    S’applique à :vérifiez oui Databricks SQL cochez oui Databricks Runtime 17.1 et versions ultérieures

    Définit éventuellement le classement par défaut pour les objets définis dans le catalogue. S’il n’est pas spécifié, le classement par défaut est UTF8_BINARY.

  • OPTIONS

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

    • option_name

      La clé d’option. La clé peut comporter un ou plusieurs identificateurs séparés par un point, ou une STRING littérale.

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

    • option_value

      Valeur de l’option. La valeur doit être une BOOLEANSTRING , INTEGERDECIMALou 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 catalog with a case insesnitive and accent insensitive default collation.
> CREATE CATALOG customer_cat DEFAULT COLLATION UNICODE_CI_AI;

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