Partilhar via

ALTER CATALOG

  • Artigo

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

Transfere a propriedade de um catalog para um novo principal , aplica etiquetas a um catalog, ou ativa ou desativa a otimização preditiva para um catalog.

Sintaxe

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

Parameters

  • catalog_name

    O nome do catalog a ser alterado. Se você não fornecer nenhum nome, o padrão será hive_metastore.

  • [ SET ] PROPRIETÁRIO A principal

    Transfere a propriedade do catalog para principal.

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

    SET é permitido como palavra-chave opcional.

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

    Aplique tags ao catalog. Você precisa ter permissão use_catalog para aplicar uma etiqueta a um catalog. Ver USE CATALOG.

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

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

    Remove tags do catalog. Você precisa ter permissão use_catalog para aplicar uma etiqueta a um catalog.

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

  • tag_name

    Um literal STRING. O tag_name deve ser único dentro do catalog.

  • tag_value

    Um literal STRING.

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

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

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

    Se o catalog for alterado, o comportamento será propagado 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 catalog.

    Para set a otimização preditiva para um catalog, o usuário deve ter CREATE permissão no catalog.

    Somente catalogs gerenciados que não sejam do Compartilhamento Delta 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)