ALTERAR CATÁLOGO

Aplica-se a: SQL do Databricks Databricks Runtime 10.4 LTS e versões posteriores Somente Catálogo do Unity

Transfere a propriedade de um catálogo para uma nova entidade de segurança, aplica marcas a um catálogo ou ativa ou desativa a otimização preditiva para um catálogo.

Sintaxe

ALTER CATALOG [ catalog_name ]
 { [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) } |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }

Parâmetros

• catalog_name

  O nome do catálogo a ser alterado. Se nenhum nome for fornecido, o padrão será hive_metastore.

• [ SET ] OWNER TO principal

  Transfere a propriedade do catálogo para principal.

  Aplica-se a: SQL do Databricks Databricks Runtime 11.3 LTS e versões posteriores

  SET é permitido como uma palavra-chave opcional.

• MARCAÇÕES DEFINIDAS ( { tag_name = tag_value } [, ...] )

  Aplicar marcas ao catálogo. Você precisa ter permissão use_catalog para aplicar uma marca a um catálogo. Consulte USAR O CATÁLOGO.

  Aplica-se a: SQL do Databricks Databricks Runtime 13.3 LTS e versões posteriores

• MARCAÇÕES NÃO DEFINIDAS ( nome_da_marca [, ...] )

  Remova as marcas do catálogo. Você precisa ter permissão use_catalog para aplicar uma marca a um catálogo.

  Aplica-se a: SQL do Databricks Databricks Runtime 13.3 LTS e versões posteriores

• nome_da_tag

  Um literal STRING. O tag_name deve ser exclusivo no catálogo.

• tag_value

  Um literal STRING.

• { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION

  Aplica-se a: SQL do Databricks Databricks Runtime 12.2 LTS e versões posteriores

  Altera o catálogo para a configuração de otimização preditiva desejada. Por padrão, quando os catálogos são criados, o comportamento é INHERIT da conta. Por padrão, novos objetos criados no catálogo herdarão a configuração do catálogo.

  Se o catálogo for alterado, o comportamento se propagará para todos os esquemas e seus objetos, que herdam a otimização preditiva. Objetos em esquemas que não herdam a otimização preditiva ou objetos que explicitamente ENABLE ou DISABLE a otimização preditiva não são afetados pela configuração do catálogo.

  Para definir a otimização preditiva para um catálogo, o usuário deve ter a permissão CREATE no catálogo.

  Apenas catálogos gerenciados que não pertencem ao Delta Sharing e elegíveis para otimização preditiva no Unity Catalog.

Exemplos

-- Creates a catalog named `some_cat`.
> CREATE CATALOG some_cat;

-- Transfer ownership of the catalog to another user
> ALTER CATALOG some_cat OWNER TO `alf@melmak.et`;

-- Applies three tags to the catalog named `test`.
> ALTER CATALOG test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the catalog named `test`.
> ALTER CATALOG test UNSET TAGS ('tag1', 'tag2', 'tag3');

–– Enables predictive optimization for catalog main
> ALTER CATALOG main ENABLE PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                        value
  ------------------------    ---------
  < other rows of describe extended >
  Predictive Optimization    ENABLE

-- Sets catalog main to inherit setting from parent object (metastore)
> ALTER CATALOG main INHERIT PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                         value
  ------------------------    ----------------------------------------
  < other rows of describe extended >
  Predictive Optimization     ENABLE (inherited from METASTORE metastore_name)

Artigos relacionados

• CRIAR CATÁLOGO
• DESCRIÇÃO DO CATÁLOGO
• CATÁLOGO DE DESTINO
• MOSTRAR CATÁLOGOS