使用持有者令牌为非 Databricks 用户创建收件人对象(Databricks-to-Open 共享)

本页介绍如何创建无法访问 Unity 目录支持的 Databricks 工作区的 OpenSharing 接收者,并通过持有人令牌授予这些接收者安全共享数据的访问权限。 这种认证流程,连同开放身份连接(OIDC)令牌联合认证流程,称为 开放共享。

以下是其工作原理:

  1. 数据提供者可以在 Unity Catalog 元存储中创建收件人对象。

  2. 创建接收对象时,选择持有令牌方法,Azure Databricks 会生成包含令牌的令牌和凭证文件。 然后,选择是Azure Databricks给收件人发送邮件,还是通过激活链接手动分享凭证文件。

    收件人对象具有身份验证 TOKEN类型 。 可以根据需要刷新和撤销令牌。

  3. 收件人通过激活链接或电子邮件下载凭证文件。 他们用凭证文件来认证并获得共享数据的读入权限。

OIDC联合流程是本页描述的持有人代币流的替代方案。 但你不能通过电子邮件授予收件人访问权限。 有关详细信息,请参阅 为 OpenSharing 收件人启用 Open ID Connect(OIDC)联合身份验证。

Important

所有在 2025 年 12 月 8 日之前签发的 Databricks 到 Open Sharing 的接收方令牌,如果其到期日晚于 2026 年 12 月 8 日,或者没有到期日,都将于 2026 年 12 月 8 日自动过期。 如果您当前使用具有较长或无限生存期的接收者令牌,请检查您的集成并根据需要续订令牌,以避免此日期之后出现重大变更。

创建收件人

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

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

目录浏览器

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

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

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

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

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

    • 使用电子邮件分享 (测试版):这会向收件人发送电子邮件,让他们下载凭证文件并阅读共享数据。 详情和限制请参见 邮件共享 。

      1. 输入 收件人姓名 和 电子邮件地址。
      2. 要 配置该共享的消费方式,请选择 “任何支持的OpenSharing客户端 ”或 “限制令牌接收者”。 任何支持的OpenSharing客户端都允许你的收件人下载凭据文件,并在Azure Databricks上访问该共享。
      3. 令牌的有效期默认采用元存储中的设置。 请参阅 “修改收件人令牌生存期”。

      注释

      使用电子邮件分享时, 通过授予共享访问权限 才会发送邀请。 OpenSharing 会向收件人发送一个安全的激活链接,以便下载凭证文件。 该凭证文件只能由接收方下载一次。

    • 使用共享标识符分享:这会生成一个凭证文件,你需要手动与收件人共享。

      1. 输入 收件人姓名。

      2. 选择 “打开”。

      3. (可选)设置 令牌的有效 期时间(从接收者创建时间起计,以秒、分钟、小时或天计)。 选择 “设置过期时间” 以设置过期时间。 令牌在创建后最多一年有效。

        如果选择 “设置过期” 并将字段留空,则令牌生存期默认为元存储配置中设置的收件人令牌生存期值。 请参阅 “修改收件人令牌生存期”。 有关更改令牌生存期和轮换令牌的信息,请参阅 “管理收件人令牌”。

      4. (可选)请输入收件人的描述。

  5. 单击 “创建” 。

  6. 如果你没有使用邮件共享,复制激活链接。

    或者,稍后可以获取激活链接。 请参阅向接收者发送其连接信息。

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

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

SQL

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

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
[COMMENT "<comment>"];

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

CLI

使用 Databricks CLI 运行以下命令。

databricks recipients create <recipient-name>

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

输出包括与收件人共享的 activation_url。

使用authentication_type和TOKEN创建接收者。

注释

创建收件人时,可以选择限制收件人对一组受限 IP 地址的访问。 还可以将 IP 访问列表添加到现有收件人。 请参阅使用 IP 访问列表限制 OpenSharing 接收者的访问权限(Databricks-to-Open 共享)。

指示接收方下载凭证文件并访问共享数据。

收件人只能下载一次凭证文件。 下载的凭证应被视为秘密,不得在组织外部共享。 如果您担心凭据可能处理得不安全,您可以随时更换收件人的凭据。 有关管理凭据以确保安全收件人访问的详细信息,请参阅 令牌的安全注意事项。

用电子邮件发送

Important

此功能在 Beta 版中。 要使用该服务,服务提供商账户的管理员必须通过账户控制台预览页面通过电子邮件启用OpenSharing。 请参阅 “管理帐户级预览”。

您的收件人可以访问并下载邮件中的凭证文件。 请参见 电子邮件共享限制。

使用共享标识符发送

使用安全渠道分享激活链接和使用 说明链接。

如果你需要访问激活链接,可以使用目录资源管理器、Databricks Unity 目录 CLI,或者在 Azure Databricks 笔记本中调用 DESCRIBE RECIPIENT SQL 命令,或者 Databricks SQL 查询编辑器。

如果收件人已下载凭据文件,则不会返回或显示激活链接。

需要的权限:元存储管理员、具有 USE RECIPIENT 特权的用户或收件人对象所有者。

目录浏览器

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

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

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

  3. 在“ 我共享 ”选项卡上,单击“ 收件人”,然后选择收件人。

  4. 在收件人详细信息页上,复制 “激活”链接。

SQL

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

DESCRIBE RECIPIENT <recipient-name>;

输出包括 activation_link:

CLI

使用 Databricks CLI 运行以下命令。

databricks recipients get <recipient-name>

输出包括 activation_url:

授予收件人对共享项的访问权限

创建收件人和 创建共享后,可以授予收件人对这些共享的访问权限。

若要向接收者授予共享访问权限,可以使用目录资源管理器、Databricks Unity Catalog CLI,或者 Azure Databricks 笔记本或 Databricks SQL 查询编辑器中的 GRANT ON SHARE SQL 命令。

所需的权限:下列其中一项:

  • Metastore 管理员。
  • 对共享和接收者对象((USE SHARE + SET SHARE PERMISSION) 或共享所有者)和(USE RECIPIENT 或接收者所有者)拥有委托权限或所有权。

有关说明,请参阅 管理对 OpenSharing 数据共享(对于提供程序)的访问权限。

管理收件人令牌

如果您正在使用 Databricks-to-Databricks 共享的持有者令牌流程与接收者共享数据,可能需要轮换该接收者的令牌。 轮换令牌包括将现有令牌设置为过期,并用新的令牌和激活 URL 替换它。

在以下情况下,应轮换收件人的令牌并生成新的激活 URL:

  • 现有收件人令牌即将过期时。
  • 如果收件人丢失其激活 URL 或遭到入侵。
  • 如果凭据在收件人下载后损坏、丢失或泄露。
  • 当你修改元存储的接收令牌有效期时。 请参阅 “修改收件人令牌生存期”。

令牌的安全注意事项

在任何给定时间,收件人最多可以有两个令牌:活动令牌和轮换令牌。 被轮换的令牌已被设置为过期,并将由当前有效的令牌替换。 在轮换令牌过期之前,尝试再次轮换令牌将导致错误。

当你轮换收件人的令牌时,可以选择将 --existing-token-expire-in-seconds 设为现有收件人令牌(即正在轮换的令牌)过期前的秒数。 如果将值 0设置为,则现有收件人令牌将立即过期。

Databricks 建议你将 --existing-token-expire-in-seconds 设置为相对较短的时间段,以便收件人组织有时间访问新的激活 URL,同时尽量减少收件人有两个活跃令牌的时间。 如果怀疑现有收件人令牌遭到入侵,Databricks 建议强制其立即过期。

如果收件人的现有激活URL尚未被访问,轮换现有令牌会使该激活URL失效并用新的URL替换。

如果所有收件人令牌都已过期,轮换令牌会将现有激活 URL 替换为新的 URL。 Databricks 建议你立即轮换或删除令牌已过期的收件人。

如果收件人激活链接无意中发送给错误的人或通过不安全通道发送,Databricks 建议您:

  1. 撤销收件人对共享的访问权限。
  2. 轮换收件人并将 --existing-token-expire-in-seconds 设置为 0。
  3. 通过安全通道与预期收件人共享新的激活 URL。
  4. 访问激活 URL 后,再次向收件人授予对共享的访问权限。

在极端情况下,可以删除并重新创建收件人,而不是轮换收件人的令牌。

轮换收件人的令牌

若要轮换收件人的令牌,可以使用目录资源管理器或 Databricks Unity 目录 CLI。

所需的权限:收件人对象所有者。

注释

共享新的激活链接后,接收者必须在其端应用新的凭据。 如果收件人在 Unity 目录中将凭据导入为提供程序对象,则必须使用 Databricks REST API 更新提供程序对象。 请参阅为开放接收方轮换凭据。

目录浏览器

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

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

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

  3. 在左窗格中,展开 OpenSharing 菜单,然后选择 “由我共享”。

  4. 在“ 我共享 ”选项卡上,单击“ 收件人”,然后选择收件人。

  5. 在最右侧的“ 令牌管理”下,单击“ 令牌过期”旁边的“ 轮换”。

  6. 在“轮换令牌”对话框中,可以将令牌的有效期设置为立即过期或在一段时间后过期。 有关何时过期现有令牌的建议,请参阅 令牌的安全注意事项。

  7. 单击“ 旋转”。

  8. 在“ 详细信息 ”选项卡上,复制新的 “激活”链接 ,并通过安全通道与收件人共享。 请参阅向接收者发送其连接信息。

CLI

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

    • <recipient-name>:收件人的姓名。
    • <expiration-seconds>:现有收件人令牌到期前的秒数。 在此期间,现有代币继续有效。 0值表示现有令牌会立即过期。 有关何时过期现有令牌的建议,请参阅 令牌的安全注意事项。
    databricks recipients rotate-token \
    <recipient-name> \
    <expiration-seconds>
    
  2. 获取收件人的新激活链接,并通过安全通道与收件人共享它。 请参阅向接收者发送其连接信息。

更新收件人令牌生存期

若要更新现有收件人令牌的生存期,请使用目录资源管理器。

所需的权限:收件人对象所有者。

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

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

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

  3. 在左窗格中,展开 OpenSharing 菜单,然后选择 “由我共享”。

  4. 在“ 我共享 ”选项卡上,单击“ 收件人”,然后选择收件人。

  5. 在最右侧的“ 令牌管理”下,单击 “令牌过期”旁边的“ 更新”。

  6. 在 “编辑收件人令牌生存期 ”对话框中,设置新的令牌生存期。 有关何时过期现有令牌的建议,请参阅 令牌的安全注意事项。

  7. 单击“ 保存”。

修改收件人令牌生存期

如果需要修改 Unity Catalog 元存储的默认收件人令牌生存期,可以使用 Catalog Explorer 或 Databricks Unity Catalog CLI。

注释

更改元存储的默认收件人令牌生存期时,现有收件人的收件人令牌生存期不会自动更新。 若要将新的令牌生存期应用于给定收件人,必须轮换其令牌。 请参阅 “管理收件人令牌”。

所需的权限:帐户管理员。

目录浏览器

  1. 登录到 帐户控制台。
  2. 在边栏中,单击 “数据”图标。目录。
  3. 单击Metastore名称。
  4. 在 OpenSharing 收件人令牌生存期下,单击“ 编辑”。
  5. 启用 “设置过期”。
  6. 输入秒数、分钟数、小时数或天数,然后选择度量单位。 令牌在创建后最多一年有效。
  7. 单击“ 保存”。

CLI

使用 Databricks CLI 运行以下命令。 将 12a345b6-7890-1cd2-3456-e789f0a12b34 替换为元数据存储 UUID,并将 86400 替换为收件人令牌过期前的秒数。 令牌在创建后最多一年有效。

databricks metastores update \
12a345b6-7890-1cd2-3456-e789f0a12b34 \
--delta-sharing-recipient-token-lifetime-in-seconds 86400

其他资源