Compartir vía

ALTER RECIPIENT

  • Artículo

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 11.3 LTS y versiones posteriores casilla marcada como Sí solo a Unity Catalog

Cambia el nombre de un destinatario. Transfiere la propiedad de un destinatario a una nueva entidad de seguridad.

Sintaxis

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

Parámetros

  • recipient_name

    Nombre del destinatario que se va a modificar.

  • RENAME TO to_recipient_name

    Cambia el nombre del destinatario. El nombre debe ser único entre todos los destinatarios del metastore. Para ejecutar esta instrucción, debe ser el propietario del destinatario y tener privilegios CREATE RECIPIENT en el metastore.

  • [ SET ] OWNER TO principal

    Transfiere la propiedad del destinatario a principal. Para ejecutar esta instrucción, debe ser el propietario del destinatario.

    Se aplica a:casilla marcada como sí Databricks SQL Almacén SQL versión 2022.35 o superior casilla marcada como Sí Databricks Runtime 11.3 LTS y versiones posteriores

    SET se permite como una palabra clave opcional.

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

    Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 12.2 LTS y versiones posteriores.

    Establece una propiedad personalizada en un destinatario. Para ejecutar esta instrucción, debe ser el propietario del destinatario y tener el privilegio CREATE RECIPIENT en metastore.

    Las propiedades del destinatario se pueden usar para compartir diferentes particiones de tabla con distintos destinatarios mediante el mismo objeto de recurso compartido. Consulte Administrar propiedades de destinatario y Usar propiedades de destinatario para realizar el filtrado de particiones.

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

property_value
{ string_literal }

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

    Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 12.2 LTS y versiones posteriores.

    Quite una propiedad personalizada de un destinatario. Para ejecutar esta instrucción, debe ser el propietario del destinatario y tener el privilegio CREATE RECIPIENT en metastore.

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

Ejemplos

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