Condividi tramite

ALTER RECIPIENT

Si applica a:contrassegnato come sì Databricks SQL contrassegnato come sì Databricks Runtime 11.3 LTS e versioni successive contrassegnato come sì Unity Catalog

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

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 il privilegio CREATE RECIPIENT sul metastore.

  • [ SET ] OWNER TO dirigente scolastico

    Trasferisce la proprietà del destinatario a principal. Per eseguire questa istruzione, è necessario essere il proprietario dell'utente 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 sul 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 sul 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' );
  • Last updated on