使用增量共享(預覽)共享數據<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#share-data-using-delta-sharing-preview" title="">

需求<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#requirements" title="">

• 必須啟用Unity Catalog，並且必須至少存在一個metastore。

• 隻有帳戶管理員可以啟用Delta共享轉移瘤。

• 隻有metastore管理員或帳戶管理員可以使用Delta Sharing共享數據。看到<一個class="reference internal" href="//www.eheci.com/docs/docs/data-governance/unity-catalog/key-concepts.html">Metastore管理．

• 要旋轉收件人的證書，你必須使用Unity Catalog CLI。看到<一個class="reference internal" href="//www.eheci.com/docs/docs/data-governance/unity-catalog/get-started.html">(可選)安裝Unity Catalog命令行．

• 要管理共享和收件人，您可以使用數據科學與工程筆記本或Databricks SQL查詢。

關鍵概念<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#key-concepts" title="">

在Delta Sharing中，a分享要與一個或多個收件人共享的表和表分區的隻讀集合。一個metastore可以有多個share，你可以控製哪個接收者可以訪問每個share。單個metastore可以包含多個share，但是每個share隻能屬於一個metastore。如果刪除一個共享，該共享的所有收件人將失去訪問它的能力。

一個收件人是將組織與允許該組織訪問一個或多個共享的憑據關聯的對象。創建收件人時，將為該收件人生成可下載的憑據。每個轉移體可以有多個受體，但每個受體隻能屬於一個轉移體。一個收件人可以訪問多個共享。如果刪除一個收件人，該收件人將失去對它以前可以訪問的所有共享的訪問權。

共享和接收方彼此獨立存在。

要授予接收方對共享的訪問權限，您需要:

1. 通過加入Delta共享公共預覽<一個class="reference internal" href="//www.eheci.com/docs/data-sharing/delta-sharing/#enable-feature-group">啟用外部數據共享特性組下載您的Databricks帳戶。

2. 為每個Unity Catalog metastore啟用Delta Sharing．

3. 創建一個共享與轉移瘤中的一個或多個表相關聯。

4. 創建一個收件人．為該收件人生成一組憑據。

5. 授予接收者特權一個或多個股票。

6. 使用安全通道，向收件人發送一個激活鏈接，允許他們下載他們的憑證。

7. 收件人使用憑據來<一個class="reference internal" href="//www.eheci.com/docs/docs/data-sharing/delta-sharing/recipient.html">訪問共享．

以下部分展示如何為Databricks帳戶啟用Delta共享、在metastore上啟用Delta共享、管理共享和接收方以及審計Delta共享活動。

為您的帳戶啟用外部數據共享特性組<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#enable-the-external-data-sharing-feature-group-for-your-account" title="">

要參加Delta共享公共預覽，帳戶管理員必須為您的Databricks帳戶啟用外部數據共享特性組。啟用此特性組表示接受附加特性組<一個class="reference external" href="//www.eheci.com/docs/service-specific-terms">服務具體條款．

1. 以“Databricks”帳號admin登錄<一個class="reference external" href="//www.eheci.com/accounts.cloud/login">賬戶控製台．

2. 在側邊欄中，單擊設置．

3. 去功能實現選項卡。

4. 在外部數據共享特性組行,單擊啟用按鈕。

   單擊條款鏈接查看Delta Sharing的附加服務特定條款。點擊啟用代表接受這些條款。

在轉移瘤上啟用Delta Sharing<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#enable-delta-sharing-on-a-metastore" title="">

對於你計劃使用增量共享共享數據的每個亞穩態，遵循以下步驟。

1. 登錄<一個class="reference external" href="//www.eheci.com/accounts.cloud/">賬戶控製台．

2. 在側邊欄中，單擊數據．

3. 點擊一個metastore的名字打開它的詳細信息。

4. 單擊旁邊的複選框啟用Delta共享並允許Databricks用戶在其組織外部共享數據．

5. Databricks建議您配置默認的收件人令牌存活時間。這是收件人令牌過期後必須重新生成的時間。如果不配置此設置，則接收令牌不會過期。

   當您更改默認的收件人生存期時，現有收件人的收件人令牌生存期不會自動更新。若要更新給定收件人的收件人令牌生存期，請參見<一個class="reference internal" href="//www.eheci.com/docs/data-sharing/delta-sharing/#rotate-a-recipients-credential">輪換收件人的證書．

   配置默認的接收令牌存活時間。

   1. 啟用設置過期．

   2. 輸入秒、分、小時或天的數字，並選擇度量單位。

   3. 點擊啟用．

   有關更多信息，請參見<一個class="reference internal" href="//www.eheci.com/docs/data-sharing/delta-sharing/#security-recommendations-for-recipients">給收件人的安全建議．

(可選)安裝Unity Catalog命令行<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#optional-install-the-unity-catalog-cli" title="">

要管理共享和收件人，您可以使用SQL命令或Unity Catalog CLI。CLI運行在本地環境，不需要Databricks的計算資源。

安裝命令行，請參見<一個class="reference internal" href="//www.eheci.com/docs/docs/data-governance/unity-catalog/get-started.html">(可選)安裝Unity Catalog命令行在Unity Catalog文檔中。

修改接收令牌存活時間<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#modify-the-recipient-token-lifetime" title="">

當啟用Delta Sharing時，按照以下步驟修改默認的收件人令牌生存期。

1. 登錄<一個class="reference external" href="//www.eheci.com/accounts.cloud/">賬戶控製台．

2. 在側邊欄中，單擊數據．

3. 點擊一個metastore的名字打開它的詳細信息。

4. 啟用設置過期．

5. 輸入秒、分、小時或天的數字，並選擇度量單位。

6. 點擊啟用．

如果禁用設置過期，接收令牌不會過期。有關更多信息，請參見<一個class="reference internal" href="//www.eheci.com/docs/data-sharing/delta-sharing/#security-recommendations-for-recipients">給收件人的安全建議．

管理股票<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#manage-shares" title="">

在Delta Sharing中，a分享是一個命名對象，該對象包含要作為組共享的亞轉移中的表集合。一個share隻能包含來自一個metastore的表。您可以隨時從共享中添加或刪除表。

下麵幾節介紹如何創建、描述、更新和刪除共享。

創建分享［如果不存在］<share_name>［評論<評論>];

顯示股票；

描述分享<share_name>；

顯示所有在分享<share_name>；

改變分享<share_name>添加表格<catalog_name>．<schema_name>．<table_name>［deltaSharingPartitionListSpec］［作為<new_schema_name．<new_table_name>］［評論<評論>];

改變分享<share_name>刪除表格<catalog_name>．<schema_name>．<table_name>；

改變分享share_name添加表格庫存分區（一年＝“2021”)，（一年＝“2020”，月＝“12月”)，（一年＝“2019”，月＝“12月”，日期＝“2019-12-25”）;

下降分享［如果存在］<share_name>；

管理接受者<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#manage-recipients" title="">

接收方是一組命名的憑據，它表示要與之共享數據的組織。本節展示如何在Delta Sharing中管理收件人。

創建收件人［如果不存在］<recipient_name>評論<評論>

顯示收件人［就像<模式>];

描述收件人<recipient_name>；

下降收件人［如果存在］<recipient_name>

管理收件人的權限<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#manage-privileges-for-a-recipient" title="">

創建共享和收件人後，使用格蘭特而且撤銷語句授予接收方對共享的訪問權限。在以下示例中，替換占位符值:

• < share_name >:共享名稱。

• < recipient_name >:收件人的姓名

顯示某一股的所有授予:

顯示格蘭特在分享<share_name>；

查詢指定受助人的所有獎助金。

顯示格蘭特來收件人<recipient_name>；

授權訪問:

格蘭特選擇在分享<share_name>來收件人<recipient_name>；

撤銷訪問:

撤銷選擇在分享<share_name>從收件人<recipient_name>；

對Delta共享資源的訪問和活動進行審計<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#audit-access-and-activity-for-delta-sharing-resources" title="">

在你<一個class="reference internal" href="//www.eheci.com/docs/docs/administration-guide/account-settings/audit-logs.html">配置審計日誌記錄， Delta Sharing為以下活動保存審計日誌:當某人創建、修改、更新或刪除共享或收件人時，當收件人訪問激活鏈接並下載憑據時，或當收件人的憑據旋轉或過期時。Delta共享活動在帳戶級別記錄。

1. 使審計日誌為您的帳戶。

   重要的

   Delta共享活動在帳戶級別記錄。不輸入值workspace_ids_filter．

   審計日誌為您帳戶中的每個工作空間以及帳戶級別的活動交付。日誌下發到配置的S3桶中。

2. 記錄Delta共享的事件名設置為unityCatalog．的requestParams節中每個事件都包含一個delta_sharing前綴。

   例如，下麵的審計事件顯示了對收件人令牌生存期的更新。在本例中，編校值被替換為> <修訂．

   ｛“版本”：“2.0”，“auditLevel”：“ACCOUNT_LEVEL”，“時間戳”：1629775584891，“orgId”：“3049059095686970”，“shardName”：“示例工作空間”，“accountId”：“> <修訂”，“sourceIPAddress”：“> <修訂”，“userAgent”：“旋度/ 7.64.1”，“sessionId”：“> <修訂”，“userIdentity”: {“電子郵件”：“> <修訂”，“subjectName”：零}，“名”：“unityCatalog”，“actionName”：“updateMetastore”，“requestId”：“> <修訂”，“requestParams”: {“id”：“> <修訂”，“delta_sharing_enabled”：“真正的”“delta_sharing_recipient_token_lifetime_in_seconds”：31536000}，“響應”: {“statusCode”：200，“errorMessage”：零，“結果”：零}，“MAX_LOG_MESSAGE_LENGTH”：16384｝

下表從數據提供程序的角度列出了Delta Sharing的審計事件。

從數據接收方的角度來看，記錄以下Delta共享錯誤。項目之間<而且>字符表示占位符文本。

• 在選定的亞轉移上沒有啟用增量共享。

  DatabricksServiceException: FEATURE_DISABLED: Delta Sharing is not enabled '

• 試圖對不存在的目錄執行操作。

  目錄“xxx”不存在。

• 非帳戶管理員或非轉移管理員的用戶試圖執行特權操作。

  DatabricksServiceException：PERMISSION_DENIED：隻有管理員可以<operation_name><operation_target>

• 從未分配給該轉移瘤的工作空間對該轉移瘤進行了操作。

  DatabricksServiceException：INVALID_STATE：工作空間<workspace_name>是沒有長分配來這metastore

• 請求缺少收件人名稱或共享名稱。

  DatabricksServiceException：INVALID_PARAMETER_VALUE：CreateRecipient/CreateShare失蹤要求場：<recipient_name>/<share_name>

• 請求包含無效的收件人名稱或共享名稱。

  DatabricksServiceException：INVALID_PARAMETER_VALUE：CreateRecipient/CreateShare<recipient_name>/<share_name>是不一個有效的的名字

• DatabricksServiceException:INVALID_PARAMETER_VALUE:隻有管理或外部表格在團結目錄可以是添加來一個份額。

  用戶試圖共享一個不在Unity Catalog轉移庫中的表。

• DatabricksServiceException:INVALID_PARAMETER_VALUE:在那裏是已經兩個活躍的令牌為收件人< recipient_name >。

  用戶試圖旋轉已處於旋轉狀態且其上一個令牌尚未過期的收件人。

• DatabricksServiceException:RECIPIENT_ALREADY_EXISTS / SHARE_ALREADY_EXISTS:收件人/分享<名稱>已經存在

  用戶試圖創建與已有名稱相同的新收件人或共享。

• DatabricksServiceException:RECIPIENT_DOES_NOT_EXIST / SHARE_DOES_NOT_EXIST:收件人/分享“<名稱>”做不存在。

  用戶試圖對不存在的收件人或共享執行操作。處理步驟

• DatabricksServiceException:RESOURCE_ALREADY_EXISTS:共享表格“<名稱>”已經的存在。

  用戶試圖向共享添加表，但該表已被添加。

• DatabricksServiceException:TABLE_DOES_NOT_EXIST:表格“<名稱>”做不存在。

  用戶試圖執行引用不存在的表的操作。

• DatabricksServiceException:SCHEMA_DOES_NOT_EXIST:模式“<名稱>”做不存在。

  用戶試圖執行引用不存在的模式的操作。

有關數據接收者的可審計事件和錯誤，請參見<一個class="reference internal" href="//www.eheci.com/docs/docs/data-sharing/delta-sharing/recipient.html">對Delta共享資源的訪問和活動進行審計．

限製<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#limitations" title="">

• 隻有存儲在Unity Catalog metastore中的表才能與Delta Sharing共享。

• 隻支持Delta格式的托管表和外部表。

• 此預覽中不支持共享視圖。

下一個步驟<一個class="headerlink" href="//www.eheci.com/docs/data-sharing/delta-sharing/#next-steps" title="">

• 了解收信人如何做<一個class="reference internal" href="//www.eheci.com/docs/docs/data-sharing/delta-sharing/recipient.html">訪問股票與達美共享。

• 了解更多關於<一個class="reference internal" href="//www.eheci.com/docs/docs/data-governance/unity-catalog/index.html">統一目錄．