ALTER RECIPIENT
Van toepassing op: Alleen Databricks SQL Databricks Runtime 11.3 LTS en hoger dan Unity Catalog
Hiermee wijzigt u de naam van een geadresseerde. Hiermee wordt het eigendom van een ontvanger overgedragen aan een nieuwe principal.
Syntaxis
ALTER RECIPIENT recipient_name
{ RENAME TO to_recipient_name |
[ SET ] OWNER TO principal |
SET PROPERTIES ( property_key [ = ] property_value [, ...] ) |
UNSET PROPERTIES ( property_key [, ...] ) }
Parameters
-
De naam van de geadresseerde die moet worden gewijzigd.
RENAME TO
to_recipient_nameHiermee wijzigt u de naam van de ontvanger. De naam moet uniek zijn voor alle geadresseerden in de metastore. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de ontvanger zijn en bevoegd zijn
CREATE RECIPIENT
voor de metastore.[ SET ] OWNER TO
principalHiermee wordt het eigendom van de ontvanger overgedragen aan
principal
. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de ontvanger zijn.Van toepassing op: Databricks SQL Warehouse versie 2022.35 of hoger Databricks Runtime 11.3 LTS en hoger
SET
is toegestaan als een optioneel trefwoord.SET PROPERTIES ( property_key [ = ] property_value [, ...] )
Van toepassing op: Databricks SQL Databricks Runtime 12.2 LTS en hoger.
Hiermee stelt u een aangepaste eigenschap in op een geadresseerde. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de ontvanger zijn en de
CREATE RECIPIENT
bevoegdheid hebben voor de metastore.Eigenschappen van geadresseerden kunnen worden gebruikt om verschillende tabelpartities met verschillende geadresseerden te delen met hetzelfde shareobject. Zie Eigenschappen van geadresseerden beheren en Eigenschappen van geadresseerden gebruiken om partitiefiltering uit te voeren.
property_key { identifier [. ...] | string_literal } property_value { string_literal }
UNSET PROPERTIES ( '<property-key>' )
Van toepassing op: Databricks SQL Databricks Runtime 12.2 LTS en hoger.
Hiermee verwijdert u een aangepaste eigenschap van een geadresseerde. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de ontvanger zijn en de
CREATE RECIPIENT
bevoegdheid hebben voor de metastore.property_key { identifier [. ...] | string_literal }
Voorbeelden
-- 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' );