32 分享資料

本章提供有關管理 Oracle AI Data Platform 中資料共用、資產和收件者的詳細資訊。

主題：

資料分享

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

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

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

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

按一下「共用」即可查看共用資產、收件者、詳細資訊以及 RBAC 權限。從資產頁籤，您可以將資產新增至共用。您可以在「收件者」頁籤中管理此特定共用的收件者、建立新收件者或與現有收件者共用。「詳細資訊」頁籤提供「共用」的名稱、描述和建立詳細資訊。您可以在「權限」頁籤中管理該共用的 RBAC 權限。

您可以從「資料共用」最上層收件者頁籤，在 AI 資料平台中查看「共用」收件者的詳細資料。您可以按一下搜尋列旁邊的建立收件者來建立新收件者。

按一下收件者名稱會顯示新增收件者的共用項目、該收件者的詳細資訊，以及該收件者的 RBAC 權限。

使用差異共用

透過匯入 delta_sharing 程式庫，您可以使用 Python 在 AI 資料平台中的差異共用。執行代碼之前，使用者必須先啟動「差異共用」，並將產生的設定檔儲存於工作區中。「差異共用」從屬端會使用設定檔來認證及存取共用表格。 

import delta_sharing

# Path to your downloaded credentials file
profile_file = "<<path to the share file in workspace>>"

# Initialize the client
client = delta_sharing.SharingClient(profile_file)

#List all schemas and tables available to you
tables = client.list_all_tables()
print("Available Tables:", tables)

處理權杖到期

AI 資料平台可重新產生承載者權杖，以供現用收件人共用資料。如果目前的 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 檔案)。

建立股份

您必須在 Oracle AI Data Platform 資料共用中建立「共用」作為管理共用資產的容器。

  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. 按一下建立。

新增現有收件者至共用

您可以將已存在於您 Oracle AI Data Platform 中的收件人新增至「共用」。

  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. 按一下收件人姓名，然後按一下詳細資料頁籤。

刪除收件者

您可以刪除 Oracle AI Data Platform 中不再需要的收件者。

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