Compartilhar via

ALTER 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

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 em um catálogo.

Sintaxe

ALTER CATALOG [ catalog_name ]
 { DEFAULT COLLATION default_collation_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 nenhum nome for fornecido, o padrão será hive_metastore.

  • COLOCAÇÃO PADRÃO default_collation_name

    Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

    Altera a ordenação padrão para novos esquemas definidos no catálogo. A ordenação padrão de esquemas e objetos existentes no catálogo não é alterada.

  • [ SET ] OWNER TO entidade de segurança

    Transfere a propriedade do catálogo para principal.

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

    SET é permitido como uma palavra-chave opcional.

  • SET SET TAGS ( { 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 USE CATALOG.

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

  • 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:marque sim SQL do Databricks marque sim LTS do Databricks Runtime 13.3 e superior

  • tag_name

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

  • tag_value

    Um literal STRING.

  • { ENABLE | DISABLE | HERDAR } OTIMIZAÇÃO PREDITIVA

    Aplica-se a:marque sim SQL do Databricks marque sim LTS do Databricks Runtime 12.2 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, 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 nos esquemas que não herdam a otimização preditiva ou objetos que ENABLE explicitamente 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.

  • OPTIONS

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

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

    • opção

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

      As chaves de propriedade devem ser exclusivas e diferenciar maiúsculas de minúsculas.

    • valor

      O valor da propriedade. O valor deve ser uma BOOLEANSTRING , INTEGERou DECIMALconstante.

      Por exemplo, um value for password pode estar usando a expressãosecret('secrets.r.us', 'postgresPassword') constante em vez de inserir 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');

-- Change the default collation of a catalog to case sensitive unicode
> ALTER CATALOG test DEFAULT COLLATION UNICODE_CS;

-- 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)
  • Last updated on