CRÉER UN DESTINATAIRE

  • Article

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

Crée un destinataire Delta Sharing avec le nom spécifié et génère un lien d’activation. S’il existe déjà un destinataire du même nom, une exception est levée.

Pour créer et gérer un destinataire, vous devez être administrateur de metastore ou disposer du privilège CREATE RECIPIENT sur le metastore.

Utilisez la syntaxe DÉCRIRE LE DESTINATAIRE pour récupérer le lien d’activation.

Syntaxe

CREATE RECIPIENT [ IF NOT EXISTS ] recipient_name
    [ USING ID sharing_identifier ]
    [ COMMENT comment ]
    [ SET PROPERTIES ( property_key [ = ] property_value [, ...] ) ]

Paramètres

  • IF NOT EXISTS

    Crée un destinataire du nom spécifié s’il n’en existe pas. S’il existe déjà un destinataire du même nom, rien ne se produit.

  • recipient_name

    Nom du destinataire à créer.

  • sharing_identifier

    Identificateur unique global facultatif d’un metastore Unity Catalog détenu par le destinataire Delta Sharing avec lequel vous souhaitez partager des données. Il s’agit de la sortie de la fonction current_metastore exécutée par le destinataire Delta Sharing.

    L’utilisation de cette option définit le type d’authentification sur DATABRICKS, sinon le type d’authentification est défini sur TOKEN, ce qui vous oblige à envoyer un lien d’activation au destinataire pour qu’il accède à la date partagée.

  • commentaire

    Littéral STRING facultatif. Description du destinataire.

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

    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 }

Exemples

-- A recipient created for Databricks to Databricks sharing
> CREATE RECIPIENT other_databricks_org USING ID 'azure:westus:f12dcb34-5678-9d4c-1234-c5ac67f8b90a';
> DESCRIBE RECIPIENT other_databricks_org;
 info_name           info_value
 -------------       ----------
 recipient_name      other_databricks_org
 authentication_type DATABRICKS
 owner               alwaysworks@databricks.com
 created_by          alwaysworks@databricks.com
 create_at           2022-01-01T00:00:00.000+0000
 updated_by          alwayswork@databricks.com
 updated_at          2022-01-05T12:00:00.000+0000
 comment
 cloud               azure
 region              westus
 metastore_id        f12dcb34-5678-9d4c-1234-c5ac67f8b90a

-- A recipient created for sharing outside of Databricks
> CREATE RECIPIENT other_org;
> DESCRIBE RECIPIENT other_org;
 info_name               info_value
 ----------------------- ----------
 recipient_name          other_org
 authentication_type     TOKEN
 owner                   alwaysworks@databricks.com
 created_by              alwaysworks@databricks.com
 create_at               2022-01-01T00:00:00.000+0000
 updated_by              alwayswork@databricks.com
 updated_at              2022-01-05T12:00:00.000+0000
 comment                 This is Other Corp
 active_token_id         0160c81f-5262-40bb-9b03-3ee12e6d98d7
 active_token_expiration 2023-01-05T12:00:00.000+0000
 activation_link         https://send/this