Partilhar via

CREATE CATALOG

Aplica-se a:assinalado como sim Databricks SQL assinalado como sim Databricks Runtime 10.4 LTS e superior assinalado como sim apenas 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 catálogo de FOREIGN, 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 |
      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 } [ , ... ] )

Parâmetros

  • ESTRANGEIROS

    Aplica-se a:assinalado como Sim Databricks SQL assinalado como Sim Databricks Runtime 13.3 LTS e posterior

    Especifica que o catálogo é importado de uma CONEXÃO.

  • SE NÃO EXISTIR

    Cria um catálogo com o nome dado, 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.

  • USAR O PARTILHA provider_name.share_name

    Opcionalmente, especifica que o catálogo é baseado num partilhamento Delta Sharing .

  • LOCAL GERENCIADO 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 numa configuração de localização externa, e você deve ter os privilégios na configuração de localização externa. 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 Tabelas gerenciadas do Catálogo Unity no Azure Databricks para Delta Lake e Apache Iceberg e Criar um metastore do Catálogo Unity.

  • USANDO A CONEXÃO connection_name

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

  • comentar

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

  • COTEJAMENTO PADRÃO default_collation_name

    Aplica-se a:selecionado sim Databricks SQL selecionado sim Databricks Runtime 17.1 e superior

    Opcionalmente, define o agrupamento padrão para objetos definidos no catálogo. Se não for especificado, o agrupamento padrão será UTF8_BINARY.

  • OPÇÕES

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

    • option_name

      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 sensíveis a maiúsculas e minúsculas.

    • valor_opção

      O valor da opção. O valor deve ser uma BOOLEANSTRING , INTEGER, DECIMAL, ou 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 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