Delen via

ALTER RECIPIENT

  • Artikel

Van toepassing op:aangevinkt Databricks SQL aangevinkt Databricks Runtime 11.3 LTS en hoger aangevinkt 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 [, ...] ) }

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 recipients 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.

    Ontvangerseigenschappen kunnen worden gebruikt om verschillende table-partities met verschillende recipients te delen met hetzelfde gedeelde object. Zie Eigenschappen van geadresseerden beheren en Eigenschappen van geadresseerden gebruiken om partition filterenuit 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' );