Compartilhar via

CREATE CATALOG

Aplica-se a:marque sim SQL do Databricks marque sim LTS do Databricks Runtime 10.4 e superior com marque sim somente Catálogo do Unity

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

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

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

  • ESTRANGEIRO

    Aplica-se a:marque sim SQL do Databricks marque sim LTS do Databricks Runtime 13.3 e superior

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

  • SE NÃO EXISTIR

    Cria um catálogo com o nome fornecido se ele não existir. Se um catálogo com o mesmo nome já existir, 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 Delta Sharing.

  • LOCALIZAÇÃO GERENCIADA location_path

    Opcionalmente, especifica o caminho para um local de armazenamento gerenciado para o catálogo diferente do local de armazenamento raiz do metastore. Esse caminho deve ser definido em uma configuração de localização externa e você deve ter o privilégio CREATE MANAGED STORAGE nessa configuração. É possível usar o caminho definido na configuração de localização externa ou um subcaminho (ou seja, 'abfss://container@storageaccount.dfs.core.windows.net/finance' ou 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Com suporte no Databricks SQL ou em clusters que executam o Databricks Runtime 11.3 LTS e posteriores.

    Consulte também Tabelas gerenciadas do Catálogo do Unity no Azure Databricks para Delta Lake e Apache Iceberg e Criar um metastore do Catálogo do Unity.

  • USANDO CONNECTION_NAME DE CONEXÃO

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

  • comentário

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

  • COLOCAÇÃO PADRÃO default_collation_name

    Aplica-se a:verificação marcada sim Databricks SQL check marked yes Databricks Runtime 17.1 and above

    Opcionalmente, define a ordenação padrão para objetos definidos dentro do catálogo. Se não for especificado, a ordenação padrão será UTF8_BINARY.

  • OPTIONS

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

    • option_name

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

      As chaves de opção devem ser exclusivas e diferenciar maiúsculas de minúsculas.

    • option_value

      O valor da opção. O valor deve ser uma BOOLEANSTRING , INTEGERou DECIMALconstante. O valor também pode ser uma chamada para a função SQL SECRET. Por exemplo, o value para a password pode ser composto de secret('secrets.r.us', 'postgresPassword') em vez de inserir 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