CREATE RECIPIENT

  • Artículo

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

Crea un destinatario de Delta Sharing con el nombre especificado y genera un vínculo de activación. Si ya existe un destinatario con el mismo nombre, se produce una excepción.

Para crear y administrar un destinatario, es necesario ser administrador de metastore o tener el privilegio CREATE RECIPIENT en el metastore.

Use DESCRIBE RECIPIENT para recuperar el vínculo de activación.

Sintaxis

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

Parámetros

  • IF NOT EXISTS

    Crea un destinatario con el nombre especificado si no existe. Si ya existe un destinatario con el mismo nombre, no ocurrirá nada.

  • recipient_name

    Nombre del destinatario que se va a crear.

  • sharing_identifier

    Un identificador único global opcional de un metastore de Unity Catalog que pertenece al destinatario de Delta Sharing con el que desea compartir datos. Esta es la salida de la función current_metastore ejecutada por el destinatario de Delta Sharing.

    Con esta opción se establece el tipo de autenticación en DATABRICKS; de lo contrario, el tipo de autenticación se establece en TOKEN, lo que requiere que envíe un vínculo de activación al destinatario para que tengan acceso a la fecha compartida.

  • comentario

    Literal STRING opcional. Descripción del destinatario.

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

    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 }

Ejemplos

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