CATÁLOGO ALTER

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

Transfere a propriedade de um catálogo para uma nova entidade de segurança, aplica tags a um catálogo ou habilita ou desabilita 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 você não fornecer nenhum nome, o padrão será hive_metastore.

• [ CONJUNTO ] DO PROPRIETÁRIO AO Principal

  Transfere a propriedade do catálogo para principal.

  Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e superior

  SET é permitido como palavra-chave opcional.

• DEFINIR TAGS ( { tag_name = tag_value } [, ...] )

  Aplique tags ao catálogo. Você precisa ter use_catalog permissão para aplicar uma tag a um catálogo. Consulte USE CATALOG.

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

• TAGS NÃO DEFINIDAS ( tag_name [, ...] )

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

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

• tag_name

  Um literal STRING. O tag_name deve ser único dentro do catálogo.

• tag_value

  Um literal STRING.

• { ATIVAR | DESATIVAR | HERDAR } OTIMIZAÇÃO PREDITIVA

  Aplica-se a: Databricks SQL Databricks Runtime 12.2 LTS e superior

  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 é para INHERIT a partir da conta. Por padrão, os novos objetos criados no catálogo herdarão a configuração do catálogo.

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

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

  Somente catálogos gerenciados que não sejam do Delta Sharing no Unity Catalog são elegíveis para otimização preditiva.

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
• DESCREVER CATÁLOGO
• CATÁLOGO DE GOTAS
• MOSTRAR CATÁLOGOS