7 共享資料

本章提供有關在「AI 資料平台工作台」中管理資料共用、資產和收件者的詳細資訊。

主題：

資料分享

在 Oracle AI Data Platform Workbench 中共用資料，無需重複資料即可在組織內外安全且有效率地共用即時資料。

AI Data Platform Workbench 使用 Delta Sharing 協定安全地共用資料。若要共用資料，您必須完成下列步驟：
  1. 建立合住。
  2. 新增要共用的資產。資產可以是綱要或表格。
  3. 建立收件者並將其新增至共用。共用和收件者可以使用權限模型來控制存取。
  4. 啟用收件者。

您可以從「資料共用」頁面查看 AI Data Platform Workbench 中的所有共用，以及 AI Data Platform Workbench 中共用的所有收件者、共用及其他共用項目已將您設為收件者。

您可以從共用頁籤查看「AI 資料平台工作台」中的共用詳細資訊，包括共用的資產數目、收件者數目以及擁有該共用的人員。您可以按一下搜尋列旁邊的建立共用來建立新的共用。

按一下「共用」即可查看共用資產、收件者、詳細資訊以及 RBAC 權限。從資產頁籤，您可以將資產新增至共用。您可以在「收件者」頁籤中管理此特定共用的收件者、建立新收件者或與現有收件者共用。「詳細資訊」頁籤提供「共用」的名稱、描述和建立詳細資訊。您可以在「權限」頁籤中管理該共用的 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> 是差異共用端點。您可以使用 sql("DESCRIBE recipient <<recipient_name>>") 並檢查收件者 delta_share_enpoint 的值，來取得收件者的這個值。

限制

  • 您可以使用電子郵件應用程式傳送啟用權杖電子郵件，或是複製啟用連結並使用其現有的電子郵件服務撰寫電子郵件。
  • 您無法使用資料共用來共用磁碟區或工作區檔案 (資料、記事本、SQL 或 python 檔案)。

建立合住

您必須建立「共用」作為容器，以在 AI Data Platform Workbench 資料共用過程中管理共用資產。

  1. 在首頁上，按一下資料分享。
  2. 按一下 建立共用圖示 建立共用。
  3. 輸入您的 Share 的名稱和描述。
  4. 按一下建立。

變更分享

您可以在建立共用後更新其名稱與描述。

  1. 在首頁上，按一下資料分享。
  2. 在要修改的共用旁邊，按一下 動作 3 點圖示 動作，然後按一下編輯。
  3. 輸入您的分享的新名稱或說明。按一下「儲存」。

刪除共用

您可以刪除不再需要的共用項目。

  1. 在首頁上，按一下資料分享。
  2. 在要刪除的共用旁邊，按一下 動作 3 點圖示 動作，然後按一下刪除。
  3. 按一下「刪除」。

檢視共用明細

  1. 在首頁上，按一下資料分享。
  2. 按一下共用頁籤。
  3. 按一下共用名稱，然後按一下詳細資訊頁籤。

將資產新增至共用

建立「共用」之後，您可以新增要與收件者共用的資產。

  1. 在首頁上，按一下資料分享。
  2. 按一下「共用」的名稱以新增資產。
  3. 在「資產」頁籤上，按一下 新增資產圖示 新增資產。
  4. 選取工作區或目錄作為資產來源。
  5. 使用搜尋列或導覽至您要共用的資產。選取它並按一下新增。

從共用中移除資產

您可以移除不再想要成為「共用」一部分的資產。

  1. 在首頁上，按一下資料分享。
  2. 按一下「共用」的名稱以移除資產。
  3. 在資產頁籤中，您要移除的資產旁邊，按一下 動作 3 點圖示 動作，然後按一下刪除。
  4. 按一下「刪除」。

新增收件者至資料共用

您必須先新增收件人，才能將其納入「股份」中。

  1. 在首頁上，按一下資料分享。
  2. 按一下收件者頁籤。
  3. 按一下 「建立收件者」圖示 建立收件者。
  4. 輸入接收者的名稱和描述。
  5. 選擇性：輸入電子郵件地址，以傳送收件人的啟用連結。
  6. 按一下建立。

新增現有收件者至共用

您可以將已存在於「AI 資料平台工作台」中的收件者新增至「共用」。

  1. 在首頁上，按一下資料分享。
  2. 按一下「共用」名稱以新增現有收件人。
  3. 按一下收件者頁籤。
  4. 按一下 「與現有收件人共用」圖示 與現有收件者共用。
  5. 搜尋使用者，並選取收件者名稱旁的方塊。
  6. 按一下共用。

手動啟用收件者

如果有問題阻止收件人使用電子郵件啟用連結，您可以選擇手動啟用收件人。

  1. 在首頁上，按一下資料分享。
  2. 按一下收件者頁籤。
  3. 按一下收件人姓名，然後按一下詳細資料頁籤。
  4. 在啟動狀態旁邊，按一下啟動。
  5. 從提示複製啟用連結，然後貼到個別的視窗中。
  6. 確認「啟動」狀態現在已設為作用中。

重新傳送啟用連結給收件者

如果收件者遺失、刪除或未收到啟用連結，您可以將啟用連結重新傳送到提供的電子郵件地址。

收件者詳細資訊中必須要有一個電子郵件地址，才能傳送啟用連結給他們。如果電子郵件不正確或遺失，您可能需要建立新的收件人。
  1. 在首頁上，按一下資料分享。
  2. 按一下收件者頁籤。
  3. 按一下收件人姓名，然後按一下詳細資料頁籤。
  4. 在啟用電子郵件連結旁邊，按一下傳送啟用連結。就會開啟您設定的電子郵件應用程式。
  5. 複查並傳送電子郵件給收件者。

從分享中移除收件者

您可以從「共用」中移除收件人、保留收件人，但移除其對該「共用」中資產的存取權。

  1. 在首頁上，按一下資料分享。
  2. 按一下您要移除收件者的共用。
  3. 按一下收件者頁籤。
  4. 在要移除的收件者旁邊，按一下 動作 3 點圖示 動作，然後按一下移除。

修改收件者

建立收件者之後，您可以更新收件者的名稱、描述和電子郵件地址。

  1. 在首頁上，按一下資料分享。
  2. 按一下收件者頁籤。
  3. 要更新的收件者旁邊，按一下 動作 3 點圖示 動作，然後按一下編輯。
  4. 輸入您的收件人的新名稱或說明。按一下「儲存」。

檢視收件者明細

您可以從「詳細資訊」頁籤查看收件者的相關資訊，例如名稱、啟用連結的電子郵件地址、作用中狀態，以及建立詳細資訊。

  1. 在首頁上，按一下資料分享。
  2. 按一下收件者頁籤。
  3. 按一下收件人姓名，然後按一下詳細資料頁籤。

刪除收件者

您可以刪除「AI 資料平台工作台」中不再需要的收件者。

  1. 在首頁上，按一下資料分享。
  2. 按一下收件者頁籤。
  3. 要刪除的收件者旁邊，按一下 動作 3 點圖示 動作，然後按一下刪除。
  4. 按一下「刪除」。