CRIAR CATÁLOGO

  • Artigo

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 10.4 LTS e superior Marque Sim somente Unity Catalog

Cria um catálogo com o nome especificado. Se já existir um catálogo com o mesmo nome, será lançada uma exceção.

Quando você cria um FOREIGN catálogo, ele será preenchido com todos os esquemas e suas tabelas visíveis para o usuário autenticador.

Sintaxe

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

  • ESTRANGEIROS

    Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime 13.3 LTS e superior

    Especifica que o catálogo é importado de um CONNECTION.

  • SE NÃO EXISTIR

    Cria um catálogo com o nome próprio, se ele não existir. Se já existir um catálogo com o mesmo nome, nada acontecerá.

  • catalog_name

    O nome do catálogo a ser criado.

  • USANDO O SHARE provider_name.share_name

    Opcionalmente, especifica que o catálogo é baseado em um compartilhamento de compartilhamento Delta.

  • LOCALIZAÇÃO GERIDA 'location_path'

    Opcionalmente, especifica o caminho para um local de armazenamento gerenciado para o catálogo que é diferente do local de armazenamento raiz do metastore. Esse caminho deve ser definido em uma configuração de local externo e você deve ter o CREATE MANAGED STORAGE privilégio na configuração de local externo. Você pode usar o caminho definido na configuração do local externo ou um subcaminho (em outras palavras, 'abfss://container@storageaccount.dfs.core.windows.net/finance' ou 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Suportado em Databricks SQL ou em clusters que executam o Databricks Runtime 11.3 LTS e superior.

    Consulte também Trabalhar com tabelas gerenciadas e Criar um metastore do Catálogo Unity.

  • USANDO O connection_name CONEXÃO

    Especifica a conexão onde reside o catálogo de origem.

  • comentar

    Um literal opcional STRING . A descrição do catálogo.

  • OPÇÕES

    Define os parâmetros específicos do tipo de conexão necessários para identificar o catálogo na conexão.

    • opção

      A tecla de opção. A chave pode consistir em um ou mais identificadores separados por um ponto ou um STRING literal.

      As teclas de opção devem ser exclusivas e diferenciam maiúsculas de minúsculas.

    • valor

      O valor da opção. O valor deve ser uma BOOLEANexpressão , STRING, INTEGER, ou DECIMAL constante. O valor também pode ser uma chamada para a SECRET função SQL. Por exemplo, o value for password pode incluir secret('secrets.r.us', 'postgresPassword') em vez de digitar a senha literal.

Exemplos

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