CREATE RECIPIENT

  • Articolo

Si applica a:segno di spunta sì Solo databricks SQL segno di spunta sì Databricks Runtime 10.4 LTS e versioni successive segno di spunta sì al catalogo Unity

Crea un destinatario di condivisione delta con il nome specificato e genera un collegamento di attivazione. Se esiste già un destinatario con lo stesso nome, viene generata un'eccezione.

Per creare e gestire un destinatario, è necessario essere un amministratore del metastore o avere il CREATE RECIPIENT privilegio per il metastore.

Usare DESCRIBE RECIPIENT per recuperare il collegamento di attivazione.

Sintassi

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

Parametri

  • SE NON ESISTE

    Crea un destinatario con il nome specificato, se non esiste. Se esiste già un destinatario con lo stesso nome, non succederà nulla.

  • recipient_name

    Nome del destinatario da creare.

  • sharing_identifier

    Identificatore univoco globale facoltativo di un metastore del catalogo Unity di proprietà del destinatario di Condivisione delta con cui si desidera condividere i dati. Questo è l'output della funzione current_metastore eseguita dal destinatario di Condivisione Delta.

    L'uso di questa opzione imposta il tipo di autenticazione su DATABRICKS. In caso contrario, il tipo di autenticazione è impostato su TOKEN, che richiede l'invio di un collegamento di attivazione al destinatario per l'accesso alla data condivisa.

  • comment

    Valore letterale facoltativo STRING . Descrizione del destinatario.

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

    Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 12.2 LTS e versioni successive.

    Imposta una proprietà personalizzata su un destinatario.

    Le proprietà del destinatario possono essere utilizzate per condividere partizioni di tabella diverse con destinatari diversi usando lo stesso oggetto di condivisione. Vedere Gestire le proprietà dei destinatari e Usare le proprietà del destinatario per filtrare le partizioni.

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

property_value
{ string_literal }

Esempi

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