CRIAR DESTINATÁRIO

  • Artigo

Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 10.4 LTS e versões posteriores caixa de seleção marcada sim Somente Catálogo do Unity

Cria um destinatário com o nome especificado e gera um link de ativação. Se um banco de dados com o mesmo nome já existir, uma exceção será gerada.

Para criar e gerenciar um destinatário, você precisa ser um administrador de metastore ou ter o CREATE RECIPIENTprivilégio na metastore.

Use DESCRIBE RECIPIENT para recuperar o link de ativação.

Sintaxe

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

Parâmetros

  • IF NOT EXISTS

    Cria um destinatário com o nome fornecido se ele não existir. Se um destinatário com o mesmo nome já existir, nada acontecerá.

  • recipient_name

    O nome do destinatário a ser criado.

  • sharing_identifier

    Um identificador exclusivo global opcional de um metastore do Catálogo do Unity de propriedade do destinatário de Compartilhamento Delta com quem você gostaria de compartilhar dados. Essa é a saída da função current_metastore executada pelo destinatário do Compartilhamento Delta.

    Usar essa opção define o tipo de autenticação como DATABRICKS, caso contrário, o tipo de autenticação será definido como TOKEN, exigindo que você envie um link de ativação para o destinatário para que eles acessem a data compartilhada.

  • comment

    Um literal STRING opcional. A descrição do destinatário.

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

    Aplica-se a:verificação marcada como sim SQL do Databricks caixa de seleção marcada Databricks Runtime 12.2 LTS e versões posteriores.

    Define uma propriedade personalizada em um destinatário.

    As propriedades do destinatário podem ser usadas para compartilhar diferentes partições de tabela com destinatários diferentes usando o mesmo objeto de compartilhamento. Confira Gerenciar propriedades do destinatário e Usar propriedades de destinatário para fazer a filtragem da partição.

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

property_value
{ string_literal }

Exemplos

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