为 OpenSharing(Databricks-to-Databricks 共享)创建数据接收者

本页介绍当接收者位于已启用 Unity Catalog 的 Azure Databricks 工作区中时,如何在 OpenSharing 中创建接收者。 若要查看、更新、删除、授予共享访问权限、管理属性或使用现有收件人的 IP 列表限制访问权限,请参阅 “管理 OpenSharing 的数据收件人”。

接收方是表示使用共享数据的用户或用户组身份的具有名称的实体。 创建收件人的方式会因收件人是否有权访问已启用 Unity Catalog 的 Azure Databricks 工作区而有所不同:

有关这两种共享模式以及应在何时选择哪一种的更多信息,请参阅 Databricks 到 Open 的共享与 Databricks 到 Databricks 的共享。

要求

若要创建接收者:

  • 您必须对注册了要共享数据的 Unity Catalog 元数据存储库拥有 CREATE RECIPIENT 权限。
  • 必须使用集成了 Unity Catalog 元存储的 Azure Databricks 工作区来创建接收者。
  • 如果使用 Databricks 笔记本创建收件人,则计算必须使用 Databricks Runtime 11.3 LTS 或更高版本以及标准或专用访问模式(以前共享和单用户访问模式)。

有关其他收件人操作所需的权限(查看、更新、删除、授予共享访问权限、管理属性),请参阅 “管理 OpenSharing 的数据收件人”。

为 Azure Databricks 用户创建接收方对象

如果你的数据接收方有权限访问已启用 Unity 目录的 Azure Databricks 工作区,你可以创建一个认证类型为 DATABRICKS的接收对象。

身份验证类型为 DATABRICKS 的接收者对象表示特定 Unity Catalog 元存储中的数据接收者,该接收者在接收者对象定义中由包含元存储的云、区域和 UUID 的共享标识符字符串标识。 只能在该元存储中访问与该接收者共享的数据。

要创建用于 Databricks 到 Databricks 共享的接收方,可以使用目录资源管理器、Databricks CLI,或者在 Azure Databricks 笔记本或 Databricks SQL 查询编辑器中使用 CREATE RECIPIENT SQL 命令。 如需使用REST API创建收件人,包括电子邮件收件人,请参见“在REST API引用中 创建收件人 ”。

所需的权限:元存储管理员,或对要共享的数据所注册的 Unity Catalog 元存储拥有 CREATE RECIPIENT 特权的用户。

目录浏览器

  1. 在 Azure Databricks 工作区中,单击 Data icon.Catalog。

  2. 在“目录”窗格顶部,单击齿轮图标,然后选择OpenSharing。

    或者,在右上角,单击“ 共享 > OpenSharing”。

  3. 在“ 我共享 ”选项卡上,单击“ 新建收件人”。

  4. 选择收件人如何访问分享内容:

    • 使用电子邮件分享(测试版):这会向收件人发送邮件,提示他们登录 Azure Databricks 账户并选择所需的元存储。 收件人必须使用使用邀请邮箱地址的 Azure Databricks 账户登录。 更多信息和限制,请参见 电子邮件共享。

      1. 输入 收件人姓名。
      2. 输入收件人的电子邮件地址。
      3. 对于 配置此共享的使用方式,请选择 “任何受支持的 OpenSharing 客户端”或 “仅限 Databricks 接收者”。 任何支持的OpenSharing客户端都允许你的收件人下载凭据文件,并在Azure Databricks上访问该共享。
      4. (可选)在允许的元存储(通过共享ID)中,点击添加元存储并输入共享标识符,以限制哪些Azure Databricks元存储可以接受邀请。

      注释

      当你将收件人添加到共享时,OpenSharing 会发送一个安全的激活链接给收件人,并且每次添加他们到另一个共享时都会发送一封新邮件。 重新授予收件人已有的共享不会触发重复邮件。 请参阅管理 OpenSharing 数据共享的访问权限(面向提供方)。

    • 使用共享标识符分享:你需要请求并输入收件人的共享标识符。

      1. 输入 收件人姓名。

      2. 对于 收件人类型,请选择 Databricks。

      3. 输入收件人的 共享标识符。

        使用格式为 <cloud>:<region>:<uuid> 的完整共享标识符字符串。 例如,aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016。

      4. (可选)输入注释。

  5. 单击 “创建” 。

  6. (可选)创建自定义 收件人属性。

    在“收件人概述”选项卡上,单击Edit iconEdit icon“收件人”属性旁边的。 然后添加属性名称(键)和 值。 有关详细信息,请参阅 “管理收件人属性”。

SQL

在笔记本或 Databricks SQL 查询编辑器中运行以下命令:

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];

使用格式为 <cloud>:<region>:<uuid> 的完整共享标识符字符串。 例如,aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef。

还可为接收者添加自定义属性。 有关详细信息,请参阅 “管理收件人属性”。

CLI

使用 Databricks CLI 运行以下命令。 替换占位符的值:

  • <recipient-name>:收件人的姓名。
  • <sharing-identifier>:格式为 <cloud>:<region>:<uuid> 的完整共享标识符字符串。 例如,aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef。
  • <authentication-type>:当为 DATABRICKS 提供格式为 <cloud>:<region>:<uuid> 的共享标识符字符串时,设置为 <sharing-identifier>。
databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

还可为接收者添加自定义属性。 有关详细信息,请参阅 “管理收件人属性”。

使用authentication_type和DATABRICKS创建接收者。

其他资源