受管理的災難復原

受管理災難復原(DR)會將您的 Azure Databricks 部署複製到次要區域,讓您能在幾分鐘內從區域故障中恢復。 Azure Databricks 會管理複寫管線、次要端中已複寫目錄的狀態,以及容錯移轉流程。 你不需要撰寫或維護複製腳本。

關於手動災難復原的方法,包括一般災難復原概念與最佳實務,請參見 災難復原。

Important

受管式災難復原僅對特定對象開放。 請透過您的 Azure Databricks 帳戶團隊申請存取權限。 Azure Databricks 會在你獲准後,為你的帳戶啟用受控災害復原 (DR)。

什麼是受管理災難復原?

受管式災難復原建構於您目前已在使用的工作區和中繼資料存放區之上。 你需要準備兩個 Azure Databricks 工作區,一個位於主要區域,另一個位於次要區域,並在每個區域各設置一個中繼存放區。 當時管理的災難:

  • 依照持續排程,將你選擇加入的分類從主要端複寫到次要端。 這兩個類別都是獨立的選擇:Unity Catalog 元資料與管理資料表資料,以及工作區資產,如筆記本、工作、SQL 倉庫、叢集和 ACL。
  • 提供選用的 穩定 URL,即一個始終指向當前主要節點的單一連線字串,讓用戶端在故障轉移後無須重新設定,仍可持續運作。
  • 讓您可在需要時觸發故障轉移,無論是為了進行災難復原測試,還是在發生實際中斷時。

工作區資產 ID 會跨區域保留,因此以 ID 參考工作區資產的 URL 在故障轉移後仍會解析。

哪些內容會被複製

受管 DR 可以在每次複寫週期中複寫下列項目。 這兩個類別都是可選的,所以你可以啟用其中一項或兩者:Unity Catalog 的中繼資料和資料,以及工作區資產。

Unity Catalog 的中繼資料與資料

物件 註釋
Delta Lake 中由 Unity Catalog 管理的資料表 資料與元資料。 請參閱限制。
外部數據表 僅含中繼資料。 請參閱限制。
外部磁碟區 僅含中繼資料。
Views
Functions
權限授予
串流數據表 私人預覽版。 如需詳細資訊,請連絡 Azure Databricks 帳戶團隊。
具體化檢視 私人預覽版。 如需詳細資訊,請連絡 Azure Databricks 帳戶團隊。
列篩選器、欄位遮罩與基於屬性的存取控制(ABAC)政策 私人預覽版。 如需詳細資訊,請連絡 Azure Databricks 帳戶團隊。
外國目錄 私人預覽版。 如需詳細資訊,請連絡 Azure Databricks 帳戶團隊。

目錄的隔離模式也會同步套用。 如果原始型錄是開放的,那麼它的複本也是開放的。 如果來源目錄被隔離並綁定到主要工作區,副本也會被隔離並綁定到次要工作區。

工作區資產

Workspace 資產與其 ACL 一同被複製。

物件 註釋
Notebooks
Jobs 次級的工作排程會暫停。
SQL 數據倉庫 已複製為 STOPPED 狀態。
Clusters 已複製為 TERMINATED 狀態。 同時包含運算策略、實例設定檔及全域初始化腳本。
實例池 容量預留是區域特定的,必須在次要端中設定。
如果您的故障轉移群組是在 2026 年 9 月 17 日之前建立的,請聯絡您的 Azure Databricks 帳戶團隊,將實例池加入您的故障轉移群組。
草擬 AI/BI 儀表板
檔案儲存體
資料夾 不包含 Git 資料夾。
Queries 包含在 SQL 編輯器中建立並儲存的查詢。
Libraries
通知目標
精靈特工 私人預覽版。 如需詳細資訊,請連絡 Azure Databricks 帳戶團隊。
湖流量管線 私人預覽版。 如需詳細資訊,請連絡 Azure Databricks 帳戶團隊。

複製物件的所有權

當受控災難復原(DR)在次要端建立複寫的可保護物件(目錄、綱要、資料表、檢視、函式或磁碟區)時,初始擁有者會是執行複寫作業的 Azure Databricks 服務主體,因為 Unity Catalog 會將所有權指派給建立該物件的身分。 管理式災害復原(Managed DR)接著會將副本的擁有權移轉給主要資料庫中對應可保護物件的擁有者。

如果主要端中某個安全性實體的擁有者,是已從帳戶中刪除的使用者,管理式 DR 就無法將擁有權轉移給已不存在的主體。 在這種情況下,副本可保護物件的擁有者仍為 Azure Databricks 服務主體。 為了解決這個問題,可以在主節點為可安全檔指定一個有效的擁有者,讓 DR 複製它。

要求

若要設定受管理的災難復原,您必須具備以下條件:

  • 在 高級方案 中,主要區域和次要區域都有工作空間。
  • 兩個工作區都啟用了關鍵任務(Mission Critical)工作區外掛。 請參閱在兩個工作區中啟用 Mission Critical。
  • 兩個工作空間都啟用了無伺服器運算。 大多數支援 Unity 目錄的工作區預設提供無伺服器運算。 請參閱連線至無伺服器計算。
  • 帳戶管理員角色,擁有你計劃複製目錄中所有外部位置的所有 權限 。

設定前置條件

若要使用受管理的災難復原,請確保下列設定與資源都已妥善配置。

類別 詳細資料
次要工作區與中繼商店
  • 位於次要區域中的次要工作區和 Unity Catalog 中繼存放區,與主要工作區同屬於相同的 Azure Databricks 帳戶,且位於相同的雲端。
  • 在設定副手時請注意以下注意事項:
    • 次要中繼儲存庫不得包含與已複寫目錄同名的目錄。
    • 針對工作區資產複寫,Azure Databricks 會在初始複寫完成時,刪除次要工作區中現有的範圍內資產。 超出範圍的資產不受影響,因此次要工作區不必是空的。
身份
  • 帳號層級 的 SSO ,啟用 所有工作區 ,並透過 AIM 或 SCIM 同步身份與帳號,讓使用者、群組和服務主體在兩個區域都存在。
  • 若要使用穩定的 URL:為您的 Azure Databricks 網域佈建的自訂 URL(請聯絡您的帳戶團隊),以及帳戶層級 OAuth。
儲存與資料存取
  • 位於次要區域的 Azure Databricks Access Connector,在次要儲存帳戶上具有 Storage Blob Data Contributor 角色,並已新增為次要工作區中的儲存認證。
  • 每個由你主要目錄參考的檔案,在次要區域中都有一個對應的外部位置和儲存憑證。 受控 DR 不會自動複寫外部位置或儲存憑證。 你必須在次要位置建立它們。
網路
  • 確保以下帳號層級物件同時關聯到你的主要和次要工作區:網路連接設定(NCC)、網路政策(無伺服器出口)、私人存取設定(PAS)和 IP 存取清單。
  • 來源與次要儲存都必須允許 Azure Databricks 雙向無伺服器網路存取。
  • 在次要區域設置一個網路連接配置(Network Connectivity Configuration,NCC),分配到次要工作區,讓無伺服器運算能透過私有端點抵達儲存。 參見 設定與Azure資源的私人連線。
  • 如果你使用 私有連線 連接存放來源或複製資料的儲存帳號,那麼主要和次要工作區都需要對主要和次要儲存帳號設置私有端點。 為每個帳號上的這兩個子資源 dfs 和 blob 建立私有端點。 在 Azure 入口網站核准它們。
成本與治理
  • 將帳號層級的無伺服器使用政策(前稱無伺服器預算政策)與主要及次要工作區關聯起來。
資料表設定
  • 對於以時間戳記查詢的資料表,使用時間旅行或變更資料摘要,Databricks 建議在設定複寫前啟用 提交內時間戳記。 請參閱限制。

在兩個工作空間啟用 Mission Critical

在建立容錯移轉群組之前,請先在主要與次要工作區啟用「關鍵任務」附加元件。 每個啟用該附加元件的工作空間的運算使用量會依關鍵任務費率計費。 請聯絡您的 Azure Databricks 帳戶團隊以了解目前的費率。

  1. 在帳號主控台中,點選 工作區,然後點選工作區。
  2. 點擊「 附加元件 」標籤。
  3. 在 Mission Critical 卡片上,開啟切換按鈕並確認。

對次要工作區重複此步驟。

可選:穩定網址

Azure Databricks 建議使用 stable URL。 穩定的 URL 總是解析到目前的主要工作區,因此透過該 URL 連接的客戶端在故障轉移後不需要重新設定。 原始工作區 URL 仍可用於直接存取該工作區,但在容錯移轉後,它仍會指向原先的主要執行個體,而該執行個體此時已成為次要執行個體。 將以下下游客戶端指向穩定的 URL,而非原始的工作區 URL:

  • Azure Databricks 網頁介面。
  • JDBC 和 ODBC 連線至 SQL 資料倉儲。
  • 直接 REST API 請求。

前端(入站)Private Link 支援固定 URL。 使用輸入 Private Link 時,穩定 URL 會使用您自訂的 URL 和固定的連線 ID,而不是標準的工作區 URL 格式。

例如,穩定 URL 的形式為 <my-custom-url>.azuredatabricks.net/?w=stable_connection_id。 請參閱「為具備受管災難復原的工作空間配置 inbound Private Link」。

將客戶端連線至穩定的 URL

用戶端透過穩定 URL 連線的方式與連線至工作區 URL 的方式相同,但有兩個差異:使用穩定 URL 的主機,而非原始工作區 URL,並在 w 查詢參數中以穩定連線 ID 識別工作區。 用帳號層級的 OAuth 認證。

JDBC 與 ODBC 連接至 SQL 倉庫

將 伺服器主機名稱 設為穩定網址的主機,然後附加 ?w=stable_connection_id 到倉庫 的 HTTP 路徑:

/sql/1.0/warehouses/<warehouse-id>?w=stable_connection_id

從倉庫的 Connection details 索引標籤中的 HTTP 路徑 取得倉庫 ID(請參閱 Azure Databricks 計算資源的 Get connection details)。 使用與原始工作區 URL 相同的埠和驅動設定。

直接 REST API 請求

將請求傳送到穩定 URL 的主機名稱,並在請求中加入 w=stable_connection_id 查詢參數。 例如,列出叢集:

GET https://<my-custom-url>/api/2.0/clusters/list?w=stable_connection_id

建立複製

容錯移轉與容錯回復直到第一個複寫週期完成後才可用。 首次複寫週期會將涵蓋範圍內的所有資料複製到次要端。 對於大型工作區,初始的工作區資產初始化可能需要長達五天。 初始啟動完成後,複製會持續執行。 故障轉移群組可以稍後再切換回去。 參見 初始複製。

在複製期間,次級範圍內目錄為唯讀,次級工作區無法進行運算。 為了在不寫入次要區域的情況下執行驗證查詢,Azure Databricks 建議在次要區域設置獨立的唯讀監控工作區。

要建立故障切換群組:

  1. 在帳戶主控台中,點選 「韌性」。
  2. 如果你打算使用穩定的網址,請點選 穩定的網址 標籤,然後 建立穩定的網址。 輸入名稱,選擇目前的主要工作區,並建立穩定的網址。 將下游客戶端(JDBC、ODBC、Azure Databricks 網頁介面、直接 API 請求)指向穩定的 URL,而非原本的工作區 URL。
  3. 點選「 備援群組 」標籤,然後 建立備援群組。
  4. 請填寫表格:
    • 備援群組名稱:你為備援群組選擇的名稱。
    • 主要工作空間:你的主要工作空間。
    • 次要工作區:次要區域的工作區。
    • 複製工作區資產 (可選):預設關閉。 開啟以將 工作區資產 及其 ACL 從主節點複製到次要節點。 需要兩個工作區都啟用 Mission Critical 外掛。 如果你開啟工作區資產複製,Azure Databricks 會在初次複製完成時刪除次級中所有現有的範圍內資產。 超出範圍的資產則不受影響。
    • 穩定 URL (可選):你在步驟 2 建立的穩定 URL。
    • 複製範圍:目錄要複製。 您必須先選擇主要工作區,才能開啟此欄位。
    • 儲存映射:針對你複製的目錄在主區域中使用的每個外部位置,新增一個條目,將儲存路徑映射到你在次要區域建立的對應外部位置(見 需求)。 你可以使用 * 作為前綴比對的萬用字元。
  5. 點擊 建立故障轉移群組。

例如,Azure 儲存映射可能會abfss://data@primary.dfs.core.windows.net/*映射到 abfss://data@secondary.dfs.core.windows.net/*。

由管理式災難恢復所建立的資源

當您建立容錯移轉群組時,受管理的 DR 會佈建輔助的 Unity Catalog 資源,供複寫管線用於在不同區域之間複製資料。 在主要與次級元儲存庫中,管理式災難恢復會產生:

  • 指向另一個區域中的工作區的 連線。
  • 每個複製目錄都有 一個外國目錄 。 外國目錄會參考其他地區的相應目錄。

這些資源會與你自己的目錄一同出現在目錄探索器中。 你可以透過其註解來識別這些項目,註解中會註明這些項目是由 Azure Databricks 災難復原所建立及管理。

Important

預設情況下,只有 metastore 管理員能修改或刪除這些資源。 不要刪除 Managed DR 建立的連線或外部目錄。 刪除兩者中的任一個,都會使容錯移轉群組的複寫中斷。

穩定工作空間識別碼

有些工具以工作區 ID 而非 URL 來識別工作空間,包括 Databricks 的 Terraform 提供者 與 宣告式自動化套件。 每個穩定的 URL 都有 一個穩定的工作區 ID ,該 ID 會解析為目前的主要工作區,因此這些工具在故障轉移後會持續鎖定該活躍的工作區。 只要工具要求工作區 ID,就用穩定工作區 ID,就像一般工作區 ID 一樣。

要找到穩定的工作區 ID,請用 Databricks CLI 列出你帳戶的穩定 URL,並閱讀 stable_workspace_id 相關穩定 URL 欄位:

databricks api get /api/disaster-recovery/v1/accounts/<account-id>/stable-urls

使用宣告式自動化套件與 Terraform 部署

宣告式自動化套件(DABs)與 Databricks Terraform 提供者會透過工作空間主機 URL 或 Azure Databricks 帳號的自訂 URL 與工作空間 ID 組合來鎖定工作空間。 若要在容錯移轉後繼續部署至目前的主要主機,請將主機設為你的自訂 URL——也就是 stable URL 的主機部分,而非原始的各工作區 URL——並在 欄位中指定 workspace_id。 它們會合併到目前的主要工作區,因此你的 CI/CD 管線在故障轉移後仍會部署到活躍工作區,且不會更改設定。

  • 新部署:使用第一次部署時的自訂 URL 和穩定的工作區 ID。
  • 現有部署:將你之前的 Terraform 專案狀態匯入一個設定有自訂 URL 和穩定工作區 ID 的新專案,然後移除之前的專案。 不要重新定位現有專案——部署不再辨識它建立的資源與原始每個工作區的 URL 連結,因此重新部署會銷毀並重新建立這些資源。
  • DAB:在故障轉移群組啟用 工作空間資產複製 。 套件會將其部署狀態儲存在工作區,該狀態僅在工作區資產複製過程中才會抵達新的主狀態。

Note

故障轉移後,第一次重新部署會重建所有管理 DR 無法複製的資源,因為它們不存在於新的主伺服器上。 複製的資源會保留原位。 請參閱 限制, 了解受管理的災難恢復所能複製與不複製的內容。

監控複寫

備援群組分頁會顯示每個備援群組的當前狀態、複製點及任何有效錯誤。 可能狀態:

狀態 Meaning
CREATING 故障轉移群組正在配置中。
INITIAL_REPLICATION 故障轉移群組目前還沒有複製點。 無法使用容錯移轉或容錯回復。 參見 初始複製。
ACTIVE 複製處於穩態。 容錯移轉可供使用。
FAILING_OVER 故障切換正在進行中。
FAILOVER_FAILED、CREATION_FAILED、DELETION_FAILED 手術未能完成。 請查看故障轉移群組的狀態細節以獲得指引。

選擇故障轉移群組名稱以開啟其詳細頁面。 複寫會持續執行,但複寫點會顯示上一次 所有範圍內資源 被一起複製的時間。 個別資源可能較為最新,但 並非所有 複製點之後的資料都存在於次級節點,且在故障轉移時可能遺失。

當顯示複製點時,表示所有未被錯誤覆蓋的部分都已複製到該點為止。 管理災難復原完全不支援的資產類型不會出現 system.replication.states 在系統資料表中。 請參閱限制。 要驗證特定資產,請在次要端檢查該資產(請參閱 設定複寫)。

要監控歷史的 RPO 趨勢並查看阻礙複製的錯誤,請查詢 system.replication.states 系統資料表。 請參見複製系統表格參考。 關於最常見的錯誤類別及其解決方法,請參見 參考文獻。

初始複製

故障轉移群組會處於 INITIAL_REPLICATION 狀態,直到擁有第一個複製點。 這種情況發生在以下情況:

  • 在你建立故障轉移群組之後。
  • 在故障轉移後,當複寫開始朝反方向進行時。
  • 在你將目錄加入故障轉移群組的複製範圍之後,

在初始複製時,故障轉移不可用,故障轉移群組以目前已複製的範圍內資產百分比來報告進度。 故障切換群組也能顯示阻擋第一個複製點的錯誤。 當第一個複寫點存在時,故障轉移群組會轉換為 ACTIVE。

容錯移轉和容錯回復

同樣的程序也適用於計畫性故障轉移(DR 測試、排程維護)及非計畫性故障轉移(區域性故障)。 若要容錯移轉回原區域,請將區域對調後重複此程序。

當你觸發故障轉移時,Azure Databricks:

  • 如果已附加穩定 URL,則將其指向新的主要區域。
  • 反轉複製的方向。
  • 暫停前一輪初選的工作排程。
  • 將故障轉移群組 FAILING_OVER 轉換至 INITIAL_REPLICATION。 在故障切換群組回到 ACTIVE 之前,你無法容錯移轉回復。 參見 初始複製。

若要容錯移轉:

  1. 通知你的團隊,故障轉移即將開始。

  2. 僅適用於已規劃的容錯移轉:

    1. 在主要工作區,終止所有正在執行的叢集並停止所有 SQL 倉庫。
    2. 確認對主記憶體的寫入已經停止,然後等待複製進度追上。 若要確認,請開啟容錯移轉群組的詳細資料頁面,並確認 複寫點 與你停止寫入的時間相差在幾秒內。
  3. 在帳號主控台中,點選 韌性 → 故障轉移群組,然後點選故障轉移群組名稱。

  4. 點擊 失敗切換。

  5. 選擇新的主要區域並確認。 故障轉移會在幾分鐘內完成。

  6. 在新的主伺服器中,啟動故障轉移前正在執行的運算。 複製叢集和 SQL 倉儲在新的主要執行個體中,會分別以 TERMINATED 和 STOPPED 狀態出現。

  7. 手動在新的主帳戶中恢復你需要的工作排程。 前初選的行程已經暫停。

透過穩定 URL 連接的客戶端在故障轉移後仍能正常運作。 將仍使用原始工作區 URL 的客戶端重新定位到穩定的 URL 或新主工作區的 URL。

Important

在非計畫故障轉移中,寫入主節點的資料可能會遺失,尤其是在最後一個複製點之後。 確認任何損失是否落在你的RPO目標範圍內。

Tip

定期測試故障切換,例如每季一次,讓團隊在實際停電前熟悉程序。

拆除管理的DR

  1. 在帳號主控台中,點選 韌性 → 故障轉移群組,然後點選故障轉移群組名稱並刪除它。 在工作區有故障轉移群組啟動時,你無法關閉關鍵任務。
  2. 若要停止以 Mission Critical 費率計費,請前往各個工作區的 附加元件 分頁,關閉 Mission Critical。

Limitations

管理式災難復原有以下限制:

  • 未被複製的有:受管磁碟區、Unity 目錄與工作區秘密、機器學習模型、模型服務端點、向量搜尋索引、Delta 共用、已發佈的 AI/BI 儀表板(草稿會複製),以及 Lakeflow 管道外的 Spark 結構化串流。 支援 Delta Lake 歸檔delta.timeUntilArchived的資料表會在系統資料表中標記為 複製失敗,這些失敗會阻礙 RPO,直到你將該資源從故障轉移群組的範圍移除。 非 Delta Lake 外部資料表不支援使用分割區元資料的中繼資料複製。
  • 實體化檢視、串流資料表及 Lakeflow 管線的複製則在私有預覽中。 如需詳細資訊,請連絡 Azure Databricks 帳戶團隊。
  • 帶有列過濾器或欄遮罩及 ABAC 標籤資源的資料表會在系統資料表中標記為 「複製失敗 」,這些失敗會阻擋 RPO,直到你將該資源從故障轉移群組的範圍內移除。 這些資源的複寫目前為私人預覽。 如需詳細資訊,請連絡 Azure Databricks 帳戶團隊。
  • 使用不同目錄函數的列篩選器、欄位遮罩及 ABAC 政策無法複製,即使兩個目錄都屬於故障轉移群組。 這些資源會在含有 的系統資料表中標記為 DR_UNSUPPORTED_FEATURE.CROSS_CATALOG_POLICY_FUNCTION,且此失敗會延遲 RPO,直到該函式與使用它的資料表或原則位於同一個目錄中。
  • 從外部引擎對受控資料表進行的寫入,其可偵測性有限。 受管理的 DR 偵測 Azure Databricks 運算寫入時對 Unity Catalog 管理資料表的變更。 從外部(非 Azure Databricks)引擎透過開放 API(如 Iceberg REST 目錄)寫入複製的受管理資料表,可能無法被偵測到,因此這些寫入可能無法複製到次要資料,且在故障轉移時可能會遺失。 對於使用受控 DR 複寫的資料表,請透過 Azure Databricks 計算資源進行寫入。
  • 次要範圍內的目錄為唯讀。 唯讀僅適用於被複製的實體。 您仍可為受管理的 DR 範圍外的可保護物件自行設定複寫。 然而,啟用受控災害復原時,您無法在次要工作區執行運算工作,因此會限制在該處運作自行建置的複寫管線。
  • 重新命名 Unity Catalog 的安全性物件時,會觸發在次要端刪除並重新建立。 對於受管理的資料表,重新命名會在下一個週期重新複製資料表資料。 避免在穩態複製過程中重新命名。
  • UNDROP 不會傳播到次要端。
  • 對於沒有提交時時間戳記的資料表,透過時間戳記的時間旅行可能會回傳錯誤的版本。 在這些資料表中,Delta Lake 會將每個提交的時間戳取自提交檔案的修改時間,而複製的提交檔案則以複製時間為基準,而非原始提交時間。 因此,時間旅行查詢與按時間戳記進行的變更資料串流讀取,可以解析成與來源資料表不同的版本,且不會產生錯誤。 這會在資料表複製後立即影響次要節點,並在故障轉移或故障回復後影響主要節點。 依版本進行時間回溯則不受影響。 為了避免這種情況,在設定複寫前,先在這些資料表啟用提交時時間戳記。 請參閱 設定前置條件。
  • 大型工作區的初始資產初始化可能需要長達五天。
  • 在與受控 DR 搭配使用的工作區儲存體帳戶上使用 工作區儲存體防火牆 需要手動設定。 你必須在儲存防火牆允許相關的控制平面 IP 位址,這樣 Azure Databricks 才能複製資料。 請參閱 需求。

Reference

當資源無法複製時,故障轉移群組會在系統資料表中顯示錯誤類別 system.replication.states ,並附上識別受影響資源的訊息。 以下章節將介紹最常見的錯誤類別及其解決方法。 在你修正底層問題後,複製會自動恢復。

DR_MISSING_DEPENDENCY

資產參考了次要端中不存在的相依項,因此該資產無法複寫。 子類識別缺失的依賴類型,並以 、 DR_MISSING_DEPENDENCY.CATALOG、 .SCHEMA或 .TABLE的形式出現.RESOURCE。 它們的解析度都相同。

  1. 檢查該資產是否也因缺少相依項目而在主要版本中損壞。 如果是,請在主要項目中修正或移除該資產。
  2. 如果該資產在主群組中有效,該相依要麼不在任何故障轉移群組的複製範圍內,要麼它在該群組或其他故障轉移群組的範圍內但未能複製。 如果相依性不在範圍內,請編輯容錯移轉群組的 複寫範圍,將其也納入複寫。 如果相依項目已在範圍內,請檢查 system.replication.states 中封鎖其複寫的錯誤,並排除該錯誤。
DR_INVALID_CONFIGURATION.MISSING_LOCATION_MAPPING

管理式災難恢復(Managed DR)透過將故障轉移群組的儲存映射套用到資產的來源儲存位置,決定每個複製資產的放置位置。 映射必須精確匹配位置,或作為前綴同時涵蓋子路徑。 此錯誤表示沒有任何對應關係涵蓋來源儲存位置,因此受管理的 DR 無法判斷應將資產放置在次要端的何處。 對於外部資料表和磁碟區,缺少映射表示主資料與次要資料使用相同位置的 URI。 訊息中的 storage_location 是未對應的 來源 路徑。

  1. 在帳號主控台中,進入 韌性 → 故障轉移群組 ,並編輯故障轉移群組。
  2. 在 儲存映射中,新增或擴大映射,使其涵蓋訊息中的來源位置。 若要涵蓋子路徑,請對應父路徑,並加上 /* 後綴以進行前綴比對。 請參閱 儲存映射。
  3. 確認次要元儲存庫中的外部位置已經覆蓋了映射的目標路徑。 故障轉移群組會拒絕其目標不在現有外部位置之下的映射,因此,如果該外部位置尚不存在,請先建立該外部位置。 請參閱 使用 Unity Catalog 連接到雲端物件存儲。
DR_INVALID_CONFIGURATION.MISSING_EXTERNAL_LOCATION

儲存體對應已將複寫資產解析為次要中繼存放區中的目標路徑,但次要中繼存放區中的任何外部位置都未涵蓋該路徑,因此 Unity Catalog 無處可放置該資產的資料。 訊息中的 storage_location 是未涵蓋的 次要(目標) 路徑。

這通常有兩種情況:先前覆蓋路徑的外部位置被移除或縮小,或新複製的資產解析到沒有外部位置覆蓋的次要路徑。 第二種情況是,例如你在主資料表中建立一個外部資料表,該資料表位於一個儲存路徑下,而你的儲存映射都不涵蓋該路徑。 管理式災難復原(Managed DR)接著會退回到資料表的原始路徑,但次要中繼存放區中沒有任何外部位置涵蓋到該路徑,因此資料將無處可存放。

  1. 從訊息中的 storage_location 找出未涵蓋的次要路徑。
  2. 決定次要儲存庫中哪個外部位置應該覆蓋該路徑:你擴展的現有外部位置,或是你新建立的。
  3. 要麼調整故障轉移群組的 儲存映射 ,使路徑解析到已存在的外部位置,要麼建立該外部位置(連同其儲存憑證),並擴展映射指向該位置。 請參閱 使用 Unity Catalog 連接到雲端物件存儲。
DR_INTERNAL_ERROR

系統端故障發生在複製過程中。 無需採取行動;系統會自動恢復。 如果問題沒有自行解決,請聯絡 Azure Databricks 客服。

DR_INVALID_CONFIGURATION.CROSS_CATALOG_VIEW_PERMISSION

受管災難復原會複製該視圖及其授與的權限,但如果某個視圖參照其他目錄中的物件,則其擁有者也必須能夠存取次要端中的這些參照物件,因為該視圖會以擁有者的權限執行。 這個錯誤表示,擁有者在次要端上缺少該存取權限,因此你必須在該處的相關物件上授予這項權限。

  1. 找出視圖所參考的物件以及視圖的擁有者。 被參考的物件在定義中會以完全限定 catalog.schema.object 的名稱出現;授權必須送給擁有者,你也可以從目錄探索器中的 擁有者 欄位讀取。

    SHOW CREATE TABLE <catalog>.<schema>.<view>;
    
  2. 在次要物件上,檢查擁有者對每個參考物件的當前權限。 讀取資料表需要在其目錄上具有 USE CATALOG、在其結構描述上具有 USE SCHEMA,以及在該資料表上具有 SELECT。

    SHOW GRANTS `<view_owner>` ON CATALOG <ref_catalog>;
    SHOW GRANTS `<view_owner>` ON SCHEMA <ref_catalog>.<ref_schema>;
    SHOW GRANTS `<view_owner>` ON TABLE <ref_catalog>.<ref_schema>.<ref_table>;
    
  3. 將每個參照物件上缺少的任何權限授予給視圖擁有者。

    GRANT USE CATALOG ON CATALOG <ref_catalog> TO `<view_owner>`;
    GRANT USE SCHEMA ON SCHEMA <ref_catalog>.<ref_schema> TO `<view_owner>`;
    GRANT SELECT ON TABLE <ref_catalog>.<ref_schema>.<ref_table> TO `<view_owner>`;
    
  4. 確認視圖所參考的每個目錄都包含在故障轉移群組的 複製範圍中,因此它也存在於次要群組中。

如需詳細資訊,請參閱 在 Unity 目錄中管理許可權。

DR_INVALID_CONFIGURATION.NETWORK_UNAUTHORIZED_ACCESS

在跨區域資料表資料複寫期間,次要工作區的無伺服器運算會從來源儲存體讀取資料,但儲存體拒絕了該網路連線:可能是儲存體防火牆或網路規則將其封鎖,或缺少必要的私人端點,或該端點尚未獲得核准。

確認你的來源和次要儲存裝置是否允許 Azure Databricks 無伺服器網路存取,詳情見需求說明。

DR_INVALID_CONFIGURATION.MISSING_STORAGE_PRIVATE_ENDPOINT

當你的儲存使用私有連線時,管理式災難恢復會透過私人端點複製資料表資料。 來源與次要儲存帳戶上的私有端點必須相符。 要嘛兩個帳號都沒有私人端點,要嘛兩個帳號都有 blob 和 dfs 私人端點。 這個錯誤表示它們不匹配。 訊息列出了缺少的端點。

  1. 對於訊息中提到的每個儲存帳號,建立缺少的 blob 和 dfs 私人端點,讓雙方都匹配。 主工作區和次要工作區都需要私人端點來連接兩個儲存帳號。 參見 設定與Azure資源的私人連線。
  2. 在 Azure 入口網站中核准新的私有端點。 請參閱 設定前置條件。
DR_INVALID_CONFIGURATION.SERVERLESS_COMPUTE_PERMISSION

管理式災難復原會在次要工作區中使用無伺服器運算來複製資料,但該處不允許使用無伺服器運算。 這通常表示該帳號或工作區已停用無伺服器功能,或是該工作區不符合資格。

  1. 確認次要工作區是否符合資格。 在支援的區域內,啟用 Unity 目錄的工作區預設提供無伺服器運算。 請參閱連線至無伺服器計算。
  2. 請檢查是否有全帳號的選擇退出。在帳號主控台,進入 設定 → 功能啟用 ,檢查無伺服器開關是否存在且關閉。
  3. 啟用 serverless 來滿足你需要的範圍。 要啟用所有符合資格的工作空間,帳號管理員會開啟帳號層級的無伺服器開關。 若要只啟用次要工作區,請關閉帳號層級的開關,並由工作區管理員從工作區 的預覽中啟用無伺服器。
  4. 如果沒有切換開關,或者在啟用後無伺服器功能仍然無法執行,請聯絡您的 Azure Databricks 帳戶團隊。
DR_INVALID_CONFIGURATION.OVERLAPPING_EXTERNAL_LOCATIONS

當受控 DR 在次要端對應的目標路徑建立複寫物件時,Unity Catalog 會拒絕該路徑,因為它與該處現有的儲存體重疊,例如既有的外部位置、先前或未完成設定所遺留的可保護物件、受控位置,或工作區的預設(DBFS)儲存體。

  1. 找出佔據路徑的是什麼。

    在目錄總管中,檢查您的外部位置、受控儲存位置,以及外部資料表和磁碟區,找出其路徑涵蓋或與目標路徑重疊的物件。

  2. 如果衝突物件不應該擁有路徑,請移除它。 常見原因之一是先前設定遺留的外部資料表或外部磁碟區;如果不再需要,請將其刪除。 如果它是個不應涵蓋該路徑的外部位置,請將其移除或重新定義。

  3. 否則,將故障轉移群組的儲存映射重新指向專用且不重疊的目標路徑。 偏好特定的子路徑而非寬廣的桶根,並避免使用工作區的預設(DBFS)儲存空間。

DR_UNSUPPORTED_FEATURE

該資產使用了管理式災難復原無法複製的功能。 該子類別可識別不支援的功能,例如會顯示為 DR_UNSUPPORTED_FEATURE.ABAC_POLICY。 解決這個錯誤有兩種方法。

  1. 從主要工作區中的資產移除不支援的功能。
  2. 如果無法移除此功能,考慮將該資產從故障轉移群組的 複製範圍中移除。
DR_UNSUPPORTED_FEATURE.CROSS_CATALOG_POLICY_FUNCTION

列過濾器、欄位遮罩或 ABAC 政策使用來自與使用該函式的表格或政策不同目錄的函式。 受管理的災難復原無法複製它,即使兩個目錄都在故障轉移群組中。 在次級系統中授予權限並不能解決這個錯誤。 訊息中會標明受影響的資產和函式。

  1. 在主要工作區中,將函式建立在與資料表相同的目錄中,或在 ABAC 政策所附加之可保護物件所在的相同目錄中建立。

  2. 將列過濾器、欄位遮罩或策略指向新函式:

    -- Row filter
    ALTER TABLE <table_name> SET ROW FILTER <catalog>.<schema>.<function_name> ON (<column_name>, ...);
    
    -- Column mask
    ALTER TABLE <table_name> ALTER COLUMN <column_name> SET MASK <catalog>.<schema>.<function_name>;
    

    對於 ABAC 政策,請執行 CREATE OR REPLACE POLICY,使用相同的名稱和 securable,並在每個子句中指定新函式。 請參閱「編輯政策」。

  3. 如果你無法移動該函式,請將該資產從故障轉移群組的 複製範圍中移除。

複寫會在資產使用自身目錄中的函式後的下一個週期繼續。

DR_UNSUPPORTED_FEATURE.TABLE_ARCHIVED_FILES

表格已啟用 Delta Lake 封存支援(delta.timeUntilArchived)。 受管理的災難復原會複製所有資料檔案,因此歸檔的物件必須還原到熱儲存層,且必須在主要端取消設定資料表屬性,複寫才能繼續。 請參見Azure Databricks中的歸檔支援。

  1. 關閉資料表儲存位置的雲端生命週期歸檔政策,這樣列出後不會有額外檔案被歸檔。

  2. 列出需要還原的檔案:

    SHOW ARCHIVED FILES FOR <table_name>;
    
  3. 先在雲端服務提供商中還原這些物件,然後等待還原完成。 請參見 還原已歸檔檔案。

  4. 取消設定 table delta.timeUntilArchived 屬性。 這只會更新元資料,讓 Databricks 不再追蹤表上的歸檔:

    ALTER TABLE <table_name> UNSET TBLPROPERTIES ('delta.timeUntilArchived');
    
  5. 確認完整讀取成功,例如 SELECT COUNT(*) FROM <table_name>;。 之後,複寫就可以複製該資料表。

請注意,取消設定屬性並不會還原物件。 還原物件是一項雲端服務提供者的操作,必須透過雲端提供者機制手動完成。

關於災難復原的概念與最佳實務,請參見 災難復原。