Compartir vía

CREATE CATÁLOGO

  • Artículo

Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores casilla marcada como Sí solo Unity Catalog

Crea un catálogo con el nombre especificado. Si ya existe un catálogo con el mismo nombre, se produce una excepción.

Cuando cree un catálogo FOREIGN, se rellenará con todos los esquemas y sus tablas visibles para el usuario que se autentica.

Sintaxis

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 } [ , ... ] )

Parámetros

  • FOREIGN

    Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 13.3 LTS y versiones posteriores

    Especifica que el catálogo se importa desde CONNECTION.

  • IF NOT EXISTS

    Crea un catálogo con el nombre especificado si no existe. Si ya existe un catálogo con el mismo nombre, no ocurrirá nada.

  • catalog_name

    Nombre del catálogo que se va a crear.

  • USING SHARE provider_name.share_name

    Opcionalmente, especifica que el catálogo se basa en un recurso compartido de Delta Sharing.

  • UBICACIÓN ADMINISTRADA 'location_path'

    Opcionalmente, especifica la ruta de acceso a una ubicación de almacenamiento administrada para el catálogo que es diferente de la ubicación de almacenamiento raíz del metastore. Esta ruta de acceso debe definirse en una configuración de ubicación externa, y hay que debe establecer el privilegio CREATE MANAGED STORAGE en la configuración de ubicación externa. Puede usar la ruta de acceso definida en la configuración de ubicación externa o un subtrazado (es decir, 'abfss://container@storageaccount.dfs.core.windows.net/finance' o 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Se admite en Databricks SQL o en clústeres que ejecuten Databricks Runtime 11.3 LTS y versiones posteriores.

    Consulte también Uso de tablas administradas y Creación de un metastore de Unity Catalog.

  • USING CONNECTION connection_name

    Especifica la conexión donde reside el catálogo de origen.

  • comentario

    Literal STRING opcional. Descripción del catálogo.

  • OPTIONS

    Establece parámetros específicos del tipo de conexión necesarios para identificar el catálogo en la conexión.

    • option_name

      Tecla de opción. La clave puede constar de uno o más identificadores separados por un punto o un literal de STRING.

      Las claves de opción deben ser únicas y distinguen mayúsculas de minúsculas.

    • option_value

      El valor para la opción. El valor debe ser una expresión constante BOOLEAN, STRING, INTEGER o DECIMAL. El valor también puede ser una llamada a la función SQL SECRET. Por ejemplo, el value de password puede incluir secret('secrets.r.us', 'postgresPassword') en lugar de escribir la contraseña literal.

Ejemplos

-- 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');