Condividi tramite


ALTER RECIPIENT

Si applica a:segno di spunta sì Solo Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS e versioni successive segno di spunta sì al catalogo Unity

Rinomina un destinatario. Trasferisce la proprietà di un destinatario a un nuovo entità.

Sintassi

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

Parametri

  • recipient_name

    Nome del destinatario da modificare.

  • RENAME TO to_recipient_name

    Rinomina il destinatario. Il nome deve essere univoco tra tutti i destinatari nel metastore. Per eseguire questa istruzione, è necessario essere il proprietario del destinatario e avere CREATE RECIPIENT il privilegio per il metastore.

  • [ SET ] OWNER TO principal

    Trasferisce la proprietà del destinatario a principal. Per eseguire questa istruzione, è necessario essere il proprietario del destinatario.

    Si applica a: segno di spunta sì Databricks SQL Warehouse versione 2022.35 o successiva segno di spunta sì di Databricks Runtime 11.3 LTS e versioni successive

    SET è consentito come parola chiave facoltativa.

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

    Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 12.2 LTS e versioni successive.

    Imposta una proprietà personalizzata su un destinatario. Per eseguire questa istruzione, è necessario essere il proprietario del destinatario e avere il CREATE RECIPIENT privilegio per il metastore.

    Le proprietà del destinatario possono essere utilizzate per condividere partizioni di tabella diverse con destinatari diversi usando lo stesso oggetto di condivisione. Vedere Gestire le proprietà dei destinatari e Usare le proprietà del destinatario per filtrare le partizioni.

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

    Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 12.2 LTS e versioni successive.

    Rimuove una proprietà personalizzata da un destinatario. Per eseguire questa istruzione, è necessario essere il proprietario del destinatario e avere il CREATE RECIPIENT privilegio per il metastore.

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

Esempi

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