CREATE RECIPIENT

  • Статья

Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 10.4 LTS и более поздней проверка помечены да версии каталога Unity

Создает получателя функции разностного общего доступа с указанным именем и ссылку для активации. Если получатель с этим именем уже существует, создается исключение.

Чтобы создать получателя и управлять им, необходимо быть администратором хранилища метаданных или иметь CREATE RECIPIENT права на хранилище метаданных.

Чтобы получить ссылку активации, используйте команду DESCRIBE RECIPIENT.

Синтаксис

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

Параметры

  • IF NOT EXISTS

    Создает получателя с указанным именем, если он не существует. Если получатель с подобным именем уже существует, ничего не произойдет.

  • recipient_name

    Имя создаваемого получателя.

  • sharing_identifier

    Дополнительный глобальный уникальный идентификатор хранилища метаданных каталога Unity, принадлежащего получателю данных функции разностного общего доступа, которому вы хотите предоставить доступ к данным. Это выходные данные current_metastore, выполняемой получателем функции разностного общего доступа.

    При использовании этого параметра для типа проверки подлинности задается значение DATABRICKS, в противном случае используется тип проверки подлинности TOKEN, требующий отправки ссылки активации получателю, чтобы он мог получить доступ к общим данным.

  • комментарий

    Необязательный литерал STRING. Описание получателя.

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

    Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 12.2 LTS и более поздних версий.

    Задает настраиваемое свойство получателя.

    Свойства получателя можно использовать для совместного использования разных секций таблиц с разными получателями с помощью одного объекта общего ресурса. См. статью "Управление свойствами получателей" и "Использование свойств получателя" для фильтрации секций.

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

property_value
{ string_literal }

Примеры

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