Delen via

ALTER RECIPIENT

Van toepassing op:aangevinkt: ja Databricks SQL aangevinkt: ja Databricks Runtime 11.3 LTS en hoger aangevinkt: ja Unity Catalog alleen

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

Parameterwaarden

  • recipient_name

    De naam van de geadresseerde die aangepast moet worden.

  • RENAME TO to_recipient_name

    Hiermee wijzigt u de naam van de ontvanger. De naam moet uniek zijn voor alle ontvangers in de metastore. Om deze instructie uit te voeren, moet u de eigenaar van de ontvanger zijn en over CREATE RECIPIENT-privileges op de metastore beschikken.

  • [ SET ] OWNER TO principal

    Hiermee 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:aangevinkt als ja Databricks SQL SQL warehouse versie 2022.35 of hoger aangevinkt als ja Databricks Runtime 11.3 LTS en hoger

    SET is toegestaan als een optioneel trefwoord.

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

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 12.2 LTS en hoger.

    Hiermee stelt u een aangepaste eigenschap in voor een geadresseerde. Om deze verklaring uit te voeren, moet u de eigenaar van het account 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 deelobject. 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:vinkje als ja aan Databricks SQL vinkje als ja aan 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' );