Partage via

ALTER RECIPIENT

  • Article

S’applique à : coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 11.3 LTS et versions ultérieures oui coché Unity Catalog uniquement

Renomme un destinataire. Transfère la propriété d’un destinataire à un nouveau principal.

Syntaxe

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

Paramètres

  • recipient_name

    Nom du destinataire à modifier.

  • RENAME TO to_recipient_name

    Renomme le destinataire. Le nom doit être unique parmi tous les destinataires dans le metastore. Pour exécuter cette instruction, vous devez être le propriétaire du destinataire et disposer du privilège CREATE RECIPIENT sur le metastore.

  • [ SET ] OWNER TO principal

    Transfère la propriété du destinataire à principal. Pour exécuter cette instruction, vous devez être le propriétaire du destinataire.

    S’applique à :coche marquée oui Databricks SQL Entrepôt SQL version 2022.35 ou ultérieure coche marquée oui Databricks Runtime 11.3 LTS et versions ultérieures

    SET est autorisé en tant que mot clé facultatif.

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

    S’applique à : coche marquée oui Databricks SQL oui coché Databricks Runtime 12.2 LTS et versions ultérieures.

    Permet de définir une propriété personnalisée sur un destinataire. Pour exécuter cette instruction, vous devez être le propriétaire du destinataire et disposer du privilège CREATE RECIPIENT sur le metastore.

    Les propriétés de destinataire peuvent être utilisées pour partager des partitions de table différentes avec divers destinataires à l’aide du même objet de partage. Consultez Gérer les propriétés de destinataire et Utiliser des propriétés de destinataire pour effectuer le filtrage de partition.

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

property_value
{ string_literal }

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

    S’applique à : coche marquée oui Databricks SQL oui coché Databricks Runtime 12.2 LTS et versions ultérieures.

    Supprime une propriété personnalisée d’un destinataire. Pour exécuter cette instruction, vous devez être le propriétaire du destinataire et disposer du privilège CREATE RECIPIENT sur le metastore.

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

Exemples

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