Freigeben über

ALTER RECIPIENT

  • Artikel

Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 11.3 LTS und höher Häkchen nur für Unity Catalog

Benennt einen Empfänger um. Überträgt den Besitz eines Empfängers an einen neuen Prinzipal.

Syntax

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

Parameter

  • recipient_name

    Der Name des zu ändernden Empfängers.

  • RENAME TO to_recipient_name

    Benennt den Empfänger um. Der Name unter allen Empfängern im Metastore eindeutig sein. Um diese Anweisung auszuführen, müssen Sie der Besitzer des Empfängers sein und über die CREATE RECIPIENT-Berechtigung für den Metastore verfügen.

  • [ SET ] OWNER TO principal

    Überträgt den Besitz des Empfängers an principal. Um diese Anweisung auszuführen, müssen Sie der Eigentümer des Empfängers sein.

    Gilt für:Häkchen ja Databricks SQL SQL-Warehouse Version 2022.35 oder höher Häkchen Databricks Runtime 11.3 LTS und höher

    SET ist als optionales Schlüsselwort zulässig.

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

    Gilt für:Häkchen ja Databricks SQL Häkchen Databricks Runtime 12.2 LTS und höher

    Legt eine benutzerdefinierte Eigenschaft für einen Empfänger fest. Um diese Anweisung auszuführen, müssen Sie der Besitzer des Empfängers sein und über die CREATE RECIPIENT-Berechtigung für den Metastore verfügen.

    Empfängereigenschaften können verwendet werden, um verschiedene Tabellenpartitionen für verschiedene Empfänger mit demselben Freigabeobjekt freizugeben. Weitere Informationen finden Sie unter Verwalten von Empfängereigenschaften und Verwenden von Empfängereigenschaften zum Durchführen der Partitionsfilterung.

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

property_value
{ string_literal }

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

    Gilt für:Häkchen ja Databricks SQL Häkchen Databricks Runtime 12.2 LTS und höher

    Entfernt eine benutzerdefinierte Eigenschaft aus einem Empfänger. Um diese Anweisung auszuführen, müssen Sie der Besitzer des Empfängers sein und über die CREATE RECIPIENT-Berechtigung für den Metastore verfügen.

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

Beispiele

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