Share via

ALTER RECIPIENT

  • Artikel

Van toepassing op:vinkje als ja aan Alleen Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger vinkje als ja aan 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

  • recipient_name

    De naam van de geadresseerde die moet worden gewijzigd.

  • RENAME TO to_recipient_name

    Hiermee 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 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:vinkje als ja aan Databricks SQL Warehouse versie 2022.35 of hoger vinkje als ja aan 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 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: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' );