7 分享数据

本章提供有关在 AI 数据平台工作台中管理数据共享、资产和收件人的详细信息。

主题：

数据分享

Oracle AI Data Platform Workbench 中的数据共享可确保组织内和组织间安全、高效的实时数据共享，而不会产生数据重复。

AI Data Platform Workbench 使用 Delta Sharing 协议安全地共享数据。要共享数据，必须完成以下步骤：
  1. 创建共享资源。
  2. 添加要共享的资产。资产可以是方案或表。
  3. 创建收件人并将其添加到共享资源。共享资源和收件人可以使用权限模型进行访问控制。
  4. 激活收件人。

从“数据共享”页面，您可以在 AI 数据平台工作台中查看所有共享资源，AI 数据平台工作台中共享资源的所有收件人、共享资源和其他共享资源都已为您创建了收件人。

从共享资源选项卡中，您可以在 AI 数据平台工作台中查看共享资源的详细信息，包括共享资源中的资产数、收件人数以及共享资源的所有者。您可以通过单击搜索栏旁边的创建共享来创建新共享。

通过单击共享，您可以查看共享资产、收件人、详细信息和 RBAC 权限。在资产选项卡中，可以将资产添加到共享资源。在“收件人”选项卡中，您可以管理此特定共享的收件人、创建新收件人或与现有收件人共享。"Details"（详细信息）选项卡提供共享资源的名称、说明和创建详细信息。在“权限”选项卡中，您可以管理该共享资源的 RBAC 权限。

从数据共享顶层的收件人选项卡中，您可以在 AI 数据平台工作台中查看共享收件人的详细信息。您可以通过单击搜索栏旁边的创建收件人来创建新收件人。

单击收件人名称将显示收件人添加到的共享资源、该收件人的详细信息以及该收件人的 RBAC 权限。

处理令牌到期

Oracle AI Data Platform 可以为活动收件人重新生成用于数据共享的记名标记。如果当前 Bearer 标记尚未过期，则可以使用 curl 命令调用 updateSecretExpiry API 来延长 Bearer 标记的持续时间： 

curl
    --header 'Authorization: Bearer <token>’
    --header 'Content-Type: application/json'
    --data '{"existingTokenExpireInSeconds":"<duration>"}'
    --request POST ‘<delta_share_endpoint>/updateSecretExpiry'
其中：
  • <token> 是共享资源配置文件中的 Bearer 标记值
  • <duration> 是新标记的持续时间（秒）
  • <delta_share_endpoint> 是 Delta 共享端点。您可以通过使用 sql("DESCRIBE recipient <<recipient_name>>") 并检查收件人的 delta_share_enpoint 的值来获取收件人的此值。

限制

  • 您可以使用电子邮件应用程序或通过复制激活链接并使用其现有电子邮件服务编写电子邮件来发送激活令牌电子邮件。
  • 无法使用数据共享共享共享卷或工作区文件（数据、记事本、SQL 或 python 文件）。

创建共享资源

在 AI 数据平台工作台数据共享中，必须创建一个共享作为用于管理共享资产的容器。

  1. 在主页中，单击数据共享。
  2. 单击 “创建共享”图标 创建共享。
  3. 输入共享资源的名称和说明。
  4. 单击创建。

修改共享资源

您可以在创建共享资源后更新共享资源的名称和说明。

  1. 在主页中，单击数据共享。
  2. 在要修改的共享资源旁边，单击 “操作三个点”图标 操作，然后单击编辑。
  3. 为共享资源输入新名称或说明。单击保存。

删除共享资源

您可以删除不再需要的共享资源。

  1. 在主页中，单击数据共享。
  2. 在要删除的共享资源旁边，单击 “操作三个点”图标 操作，然后单击删除。
  3. 单击删除。

查看共享详细信息

  1. 在主页中，单击数据共享。
  2. 单击 Shares（共享资源）选项卡。
  3. 单击共享资源名称，然后单击详细信息选项卡。

将资产添加到共享资源

创建共享后，您可以添加要与收件人共享的资产。

  1. 在主页中，单击数据共享。
  2. 单击要向其添加资产的共享资源的名称。
  3. 在“资产”选项卡上，单击 “添加资源”图标 添加资产。
  4. 选择工作区或目录作为资产源。
  5. 使用搜索栏或导航到要共享的资产。选择它并单击添加。

从共享资源中删除资产

您可以删除不再希望成为共享资源一部分的资产。

  1. 在主页中，单击数据共享。
  2. 单击要从中删除资产的共享资源的名称。
  3. 在资产选项卡上，单击要删除的资产旁边的 “操作三个点”图标 操作，然后单击删除。
  4. 单击删除。

将收件人添加到数据共享

必须先添加收件人，然后才能将其包括在共享资源中。

  1. 在主页中，单击数据共享。
  2. 单击收件人选项卡。
  3. 单击 “创建收件人”图标 创建收件人。
  4. 输入收件人的名称和描述。
  5. 可选：输入电子邮件地址以向收件人发送激活链接。
  6. 单击创建。

将现有收件人添加到共享资源

您可以将 AI 数据平台工作台中已存在的收件人添加到共享资源。

  1. 在主页中，单击数据共享。
  2. 单击共享资源的名称以向其中添加现有收件人。
  3. 单击收件人选项卡。
  4. 单击 “与现有收件人共享”图标 与现有收件人共享。
  5. 搜索用户，然后选中收件人名称旁边的框。
  6. 单击共享。

手动激活收件人

如果存在阻止收件人使用电子邮件激活链接的问题，您可以选择手动激活收件人。

  1. 在主页中，单击数据共享。
  2. 单击收件人选项卡。
  3. 单击收件人名称，然后单击详细信息选项卡。
  4. 在激活状态旁边，单击激活。
  5. 从提示中复制激活链接，然后粘贴到单独的窗口中。
  6. Verify the Activation status is now set to Active（验证激活状态）。

将激活链接重新发送到收件人

如果激活链接丢失、已删除或收件人未收到其他链接，则可以将激活链接重新发送到提供的电子邮件地址。

收件人必须有电子邮件地址作为其详细信息的一部分，才能向其发送激活链接。如果电子邮件不正确或缺失，则可能需要创建新收件人。
  1. 在主页中，单击数据共享。
  2. 单击收件人选项卡。
  3. 单击收件人名称，然后单击详细信息选项卡。
  4. 单击“激活”电子邮件链接旁边的“发送激活”链接。此时将打开您配置的电子邮件应用程序。
  5. 检查电子邮件并将其发送给收件人。

从共享资源中删除收件人

您可以从共享资源中删除收件人，保留收件人，但删除他们对该共享资源中资产的访问权限。

  1. 在主页中，单击数据共享。
  2. 单击要从中删除收件人的共享。
  3. 单击收件人选项卡。
  4. 在要删除的收件人旁边，单击 “操作三个点”图标 操作，然后单击删除。

修改收件人

您可以在创建收件人后更新其名称、说明和电子邮件地址。

  1. 在主页中，单击数据共享。
  2. 单击收件人选项卡。
  3. 在要更新的收件人旁边，单击 “操作三个点”图标 操作，然后单击编辑。
  4. 为收件人输入新名称或说明。单击保存。

查看接收人详细信息

您可以从“详细信息”选项卡中查看有关收件人的信息，例如激活链接的名称、电子邮件地址、有效状态和创建详细信息。

  1. 在主页中，单击数据共享。
  2. 单击收件人选项卡。
  3. 单击收件人名称，然后单击详细信息选项卡。

删除收件人

您可以删除 AI 数据平台工作台中不再需要的收件人。

  1. 在主页中，单击数据共享。
  2. 单击收件人选项卡。
  3. 在要删除的收件人旁边，单击 “操作三个点”图标 操作，然后单击删除。
  4. 单击删除。