Dela via

ALTER RECIPIENT

  • Artikel

gäller för:markerad som ja Databricks SQL markerad som ja Databricks Runtime 11.3 LTS och senare markerad som ja Unity Catalog endast

Byter namn på en mottagare. Överför ägarskapet för en mottagare till ett nytt huvudnamn.

Syntax

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

Parametrar

  • recipient_name

    Namnet på mottagaren som ska ändras.

  • RENAME TO to_recipient_name

    Byter namn på mottagaren. Namnet måste vara unikt bland alla mottagare i metaarkivet. Om du vill köra den här instruktionen måste du vara mottagarens ägare och ha CREATE RECIPIENT behörighet för metaarkivet.

  • [ SET ] OWNER TO principal

    Överför ägarskapet för mottagaren till principal. Om du vill köra den här instruktionen måste du vara mottagarens ägare.

    Gäller för:markerad ja Databricks SQL SQL Warehouse version 2022.35 eller senare markerad ja Databricks Runtime 11.3 LTS och senare

    SET tillåts som ett valfritt nyckelord.

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

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 12.2 LTS och senare.

    Anger en anpassad egenskap för en mottagare. Om du vill köra den här instruktionen måste du vara ägare till mottagaren och ha behörigheten CREATE RECIPIENT för metaarkivet.

    Mottagaregenskaper kan användas för att dela olika tabellpartitioner med olika mottagare med samma delningsobjekt. Se Hantera mottagaregenskaper och Använd mottagaregenskaper för att utföra partitionsfiltrering.

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

property_value
{ string_literal }

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

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 12.2 LTS och senare.

    Tar bort en anpassad egenskap från en mottagare. Om du vill köra den här instruktionen måste du vara ägare till mottagaren och ha behörigheten CREATE RECIPIENT för metaarkivet.

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

Exempel

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