DESTINATÁRIO ALTER

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 11.3 LTS e superior Marque Sim Somente catálogo Unity

Renomeia um destinatário. Transfere a propriedade de um destinatário para um novo comitente.

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 deve ser exclusivo entre todos os destinatários no metastore. Para executar essa instrução, você deve ser o proprietário do destinatário e ter CREATE RECIPIENT privilégio no metastore.

  • [ SET ] OWNER TO Principal

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

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

    SET é permitido como palavra-chave opcional.

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

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

    Define uma propriedade personalizada em um destinatário. Para executar essa instrução, você deve ser o proprietário do destinatário e ter o CREATE RECIPIENT privilégio 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. Consulte Gerenciar propriedades de destinatário e Usar propriedades de destinatário para fazer filtragem de partição.

    property_key
    { identifier [. ...] | string_literal }
    
    property_value
    { string_literal }
    
  • UNSET PROPERTIES ( '<property-key>' )

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

    Remove uma propriedade personalizada de um destinatário. Para executar essa instrução, você deve ser o proprietário do destinatário e ter o CREATE RECIPIENT privilégio 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' );