ALTER RECIPIENT

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

Renomeia um destinatário. Transfere a propriedade de um destinatário para uma nova entidade de segurança.

Sintaxe

ALTER RECIPIENT recipient_name
  { RENAME TO to_recipient_name |
    [ SET ] OWNER TO principal |
    SET PROPERTIES ( property_key [ = ] property_value [, ...] ) |
    UNSET PROPERTIES ( property_key [, ...] ) }

Parâmetros

• recipient_name

  O nome do destinatário a ser alterado.

• RENAME TO to_recipient_name

  Renomeia o destinatário. O nome precisa ser exclusivo em todos os destinatários no metastore. Para executar essa instrução, você precisa ser o proprietário do destinatário e ter o privilégio CREATE RECIPIENT no metastore.

• [ SET ] OWNER TO entidade

  Transfere a propriedade do destinatário para principal. Para executar essa instrução, você precisa ser o proprietário do destinatário.

  Aplica-se a: SQL do Databricks SQL warehouse versão 2022.35 ou superior Databricks Runtime 11.3 LTS e superior

  SET é permitido como uma palavra-chave opcional.

• SET PROPERTIES ( property_key [ = ] property_value [, ...] )

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

  Define uma propriedade personalizada em um destinatário. Para executar essa instrução, você precisa ser o proprietário do destinatário e ter o privilégio CREATE RECIPIENT no metastore.

  As propriedades do destinatário podem ser usadas para compartilhar partições de tabela diferentes com destinatários diferentes usando o mesmo objeto de compartilhamento. Confira Gerenciar propriedades do destinatário e Usar propriedades de destinatário para fazer a filtragem da partição.

  property_key
  { identifier [. ...] | string_literal }
  
  property_value
  { string_literal }
  

• UNSET PROPERTIES ( '<property-key>' )

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

  Remove uma propriedade personalizada de um destinatário. Para executar essa instrução, você precisa ser o proprietário do destinatário e ter o privilégio CREATE RECIPIENT no metastore.

  property_key
  { identifier [. ...] | string_literal }
  

Exemplos

-- Rename a recipient
> ALTER RECIPIENT `Center for Disease Control` RENAME TO cdc;

-- Change ownership of the recipient
> ALTER RECIPIENT cdc OWNER TO `alf@melmak.et`;

-- Change recipient properties
> ALTER RECIPIENT cdc SET PROPERTIES ( 'country' = 'US' );

Artigos relacionados

• CREATE RECIPIENT
• DESCRIBE RECIPIENT
• DROP RECIPIENT
• SHOW RECIPIENTS
• COMMENT ON DESTINATÁRIO