Condividi tramite

ALTER RECIPIENT

  • Articolo

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

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 [, ...] ) }

Parameters

  • recipient_name

    Nome del destinatario da modificare.

  • RENAME TO to_recipient_name

    Rinomina il destinatario. Il nome deve essere univoco fra tutti i recipients 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 usate per condividere partizioni table diverse con recipients diversi usando lo stesso oggetto di condivisione. Vedere Gestire le proprietà dei destinatari e Usare le proprietà del destinatario per partition filtrare.

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