Partilhar via

ALTER 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

Transfere a propriedade de um catálogo para um novo responsável, aplica etiquetas 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 |
   OPTIONS (option value [, ...] )}

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.

  • [ SET ] PROPRIETÁRIO A principal

    Transfere a propriedade do catálogo para principal.

    Aplica-se a:assinalado como sim Databricks SQL assinalado como sim Databricks Runtime 11.3 LTS e versões posteriores

    SET é permitido como palavra-chave opcional.

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

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

    Aplica-se a:verificado sim Databricks SQL verificado sim Databricks Runtime 13.3 LTS e posteriores

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

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

    Aplica-se a:verificado sim Databricks SQL verificado sim Databricks Runtime 13.3 LTS e posteriores

  • tag_name

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

  • tag_value

    Um literal STRING.

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

    Aplica-se a:assinalado com Sim Databricks SQL assinalado com Sim 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 é INHERIT 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 irá repercutir em cascata 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 que explicitamente têm otimização preditiva ENABLE ou DISABLE não são afetados pelas definições do catálogo.

    Para definir a otimização preditiva para um catálogo, o utilizador deve ter a permissão CREATE 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.

  • OPÇÕES

    Define parâmetros específicos do catálogo. Substitui a lista existente de opções por uma nova lista de opções.

    Use OPTIONS para definir authorized paths para catálogos estrangeiros criados usando a federação de metastore do Hive.

    • opção

      A chave da propriedade. A chave pode consistir em um ou mais identificadores separados por um ponto ou um STRING literal.

      As chaves de propriedade devem ser exclusivas e são sensíveis a maiúsculas e minúsculas.

    • valor

      O valor da propriedade. O valor deve ser uma BOOLEANexpressão , STRING, INTEGER, ou DECIMAL constante.

      Por exemplo, a for valuepassword pode estar usando a expressão secret('secrets.r.us', 'postgresPassword') constante em vez de digitar a senha literal.

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');

-- Adds an authorized path to a foreign catalog created using :re[HMS] federation.
> ALTER CATALOG my_federated_catalog OPTIONS (authorized_paths 'path/to/dir1, path/to/dir2');

–– 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)