選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料，以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用，但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意，AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定，並顯示相關內容，包括相關廣告。若要接受或拒絕所有非必要 Cookie，請按一下「接受」或「拒絕」。若要進行更詳細的選擇，請按一下「自訂」。

偏好設定
聯絡我們
意見回饋
AWS Documentation
建立 AWS 帳戶

從 Couchbase Server 遷移至 AWS 上的 Couchbase Capella

PDF
焦點模式
從 Couchbase Server 遷移至 AWS 上的 Couchbase Capella - AWS 方案指引
Summary先決條件和限制架構工具史詩相關資源其他資訊

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

由 Battulga Purevragchaa (AWS)、Mark Gamble 和 Saurabh Shanbhag (AWS) 建立

Summary

Couchbase Capella 是完全受管的 NoSQL 資料庫即服務 (DBaaS)，適用於關鍵任務應用程式 （例如，使用者設定檔或線上目錄和庫存管理）。Couchbase Capella 會在 Couchbase 管理的 Amazon Web Services (AWS) 帳戶中管理您的 DBaaS 工作負載。Capella 可讓您在單一界面中輕鬆執行和管理多叢集、多 AWS 區域、多雲端和混合雲端複寫。

Couchbase Capella 可協助您立即擴展 Couchbase Server 應用程式，協助您在幾分鐘內建立多節點叢集。Couchbase Capella 支援所有 Couchbase Server 功能，包括SQL++、全文搜尋、事件服務和分析服務。它也不需要管理安裝、升級、備份和一般資料庫維護。 

此模式說明將自我管理的 Couchbase Server 環境遷移至 AWS 雲端的步驟和最佳實務。模式提供可重複的程序，將資料和索引從在內部部署或雲端執行的 Couchbase Server 叢集遷移至 Couchbase Capella。使用這些步驟可協助您避免遷移期間發生問題，並加速整體遷移程序。

此模式提供下列兩個遷移選項：

  • 如果您的遷移索引少於 50 個，則選項 1 是適當的。 

  • 如果您有超過 50 個要遷移的索引，則選項 2 是適當的。 

您也可以在自我管理的 Couchbase 伺服器上設定範例資料，以隨遷移指南一起遵循。

如果您選擇遷移選項 2，或者如果您使用的是預設值以外的範圍或集合，則必須使用範例組態檔案，其位於其他資訊區段中。

先決條件和限制

先決條件

  • 現有的 Couchbase Capella 付費帳戶。您也可以在 AWS 上建立 Couchbase Capella 帳戶，並使用 Couchbase Capella 免費試用版，然後升級到付費帳戶以設定您的叢集以進行遷移。若要開始使用試用版，請遵循 Couchbase Capella 入門中的指示。

  • 現有的自我管理 Couchbase Server 環境，無論是在內部部署或部署在雲端服務提供者上。 

  • 對於遷移選項 2、Couchbase Shell 和組態檔案。若要建立組態檔案，您可以使用其他資訊區段中的範例檔案。

  • 熟悉管理 Couchbase Server 和 Couchbase Capella。

  • 熟悉在命令列界面 (CLI) 中開啟 TCP 連接埠和執行命令。

遷移程序也需要下表所述的角色和專業知識。

Role

專業知識

責任

Couchbase 管理員

  • 熟悉 Couchbase Server 和 Couchbase Capella

  • 基本命令列知識很有幫助，但並非必要

  • Couchbase Server 和 Capella 特定任務

系統管理員、IT 管理員

  • 熟悉自我管理的 Couchbase Server 系統環境和管理

  • 在自我管理的 Couchbase Server 叢集節點上開啟連接埠並判斷 IP 地址

限制

產品版本

架構

來源技術堆疊

  • Couchbase 伺服器

目標技術堆疊

  • Couchbase Capella

目標架構

Couchbase Capella 會以四個步驟遷移至 AWS 上 Capella 資料平面中的 Couchbase 叢集。

  1. 您可以使用 Capella 控制平面存取 Couchbase Capella。您可以使用 Capella 控制平面來執行下列動作：

    • 控制和監控您的帳戶。

    • 管理叢集和資料、索引、使用者和群組、存取許可、監控和事件。

  2. 叢集已建立。

  3. Capella Data Plane 位於 Couchbase 管理的 AWS 帳戶中。建立新叢集後，Couchbase Capella 會將其部署到所選 AWS 區域中的多個可用區域。

  4. 您可以在 AWS 帳戶中的 VPC 中開發和部署 Couchbase 應用程式。一般而言，此 VPC 會透過 VPC 對等互連存取 Capella 資料平面。

工具

  • Couchbase 跨資料中心複寫 (XDCR) 可協助跨位於不同雲端提供者和不同資料中心的叢集複寫資料。它用於將資料從自我管理的 Couchbase Server 叢集遷移到 Couchbase Capella。

    注意

    XDCR 無法與 Couchbase Server Community Edition 搭配使用，以遷移至 Couchbase Capella。反之，您可以使用 cbexport。如需詳細資訊，請參閱從 Community Edition Epic 遷移資料。

  • Couchbase Shell 是 Couchbase Server 和 Couchbase Capella 存取本機和遠端 Couchbase 叢集的命令列 Shell。在此模式中，Couchbase Shell 會用來遷移索引。

  • cbexport 是用於從 Couchbase 叢集匯出資料的 Couchbase 公用程式。包含在 Couchbase Server CLI 工具中。

史詩

任務描述所需技能

評估自我管理 Couchbase Server 叢集的大小。

登入 Couchbase Server 的 Couchbase Web 主控台，並評估自我管理叢集的節點和儲存貯體。 

  1. 若要顯示叢集節點清單，請選擇導覽列中的伺服器索引標籤。 

  2. 記錄節點數量，然後選擇清單中的每個節點以顯示其屬性。 

  3. 記錄每個個別節點的記憶體和儲存體。

  4. 選擇導覽列中的儲存貯體索引標籤，然後選擇清單中的每個儲存貯體以顯示其屬性。記錄每個儲存貯體的 RAM 配額和衝突解決設定。

您將使用自我管理的 Couchbase Server 叢集組態作為在 Couchbase Capella 上調整和設定目標叢集的一般指南。

如需更詳細 Couchbase Capella 大小練習的說明，請聯絡 Couchbase。

Couchbase 管理員

在自我管理的 Couchbase Server 叢集上記錄 Couchbase Service 分佈。

  1. 在 Couchbase Web 主控台上，選擇伺服器索引標籤以顯示叢集節點清單。 

  2. 選擇每個節點以顯示其屬性，然後記錄每個節點的 Couchbase Service 分佈 (資料服務、查詢服務、索引服務、搜尋服務、分析服務和事件服務)。

Couchbase 管理員

記錄自我管理 Couchbase Server 叢集節點的 IP 地址。

（如果您使用的是 Community Edition，請忽略此步驟。) 記錄叢集中每個節點的 IP 地址。它們稍後會新增至 Couchbase Capella 叢集上的允許清單。

Couchbase 管理員、系統管理員

準備遷移

任務描述所需技能

評估自我管理 Couchbase Server 叢集的大小。

登入 Couchbase Server 的 Couchbase Web 主控台，並評估自我管理叢集的節點和儲存貯體。 

  1. 若要顯示叢集節點清單，請選擇導覽列中的伺服器索引標籤。 

  2. 記錄節點數量，然後選擇清單中的每個節點以顯示其屬性。 

  3. 記錄每個個別節點的記憶體和儲存體。

  4. 選擇導覽列中的儲存貯體索引標籤，然後選擇清單中的每個儲存貯體以顯示其屬性。記錄每個儲存貯體的 RAM 配額和衝突解決設定。

您將使用自我管理的 Couchbase Server 叢集組態作為在 Couchbase Capella 上調整和設定目標叢集的一般指南。

如需更詳細 Couchbase Capella 大小練習的說明，請聯絡 Couchbase。

Couchbase 管理員

在自我管理的 Couchbase Server 叢集上記錄 Couchbase Service 分佈。

  1. 在 Couchbase Web 主控台上，選擇伺服器索引標籤以顯示叢集節點清單。 

  2. 選擇每個節點以顯示其屬性，然後記錄每個節點的 Couchbase Service 分佈 (資料服務、查詢服務、索引服務、搜尋服務、分析服務和事件服務)。

Couchbase 管理員

記錄自我管理 Couchbase Server 叢集節點的 IP 地址。

（如果您使用的是 Community Edition，請忽略此步驟。) 記錄叢集中每個節點的 IP 地址。它們稍後會新增至 Couchbase Capella 叢集上的允許清單。

Couchbase 管理員、系統管理員
任務描述所需技能

選擇一個範本。

  1. 登入您的 Couchbase Capella 控制平面，選擇主導覽中的儀表板索引標籤或叢集索引標籤，然後選擇建立叢集。 

  2. 使用您從自我管理 Couchbase Server 叢集評估中記錄的資訊，選擇符合組態需求的叢集範本。如果您找不到適當的範本，請在叢集大小編輯器中選擇自訂範本。

Couchbase 管理員

選擇並設定節點。

選擇並設定節點以符合自我管理的 Couchbase Server 叢集環境，包括節點數量、服務分佈、運算或 RAM，以及儲存體。

Couchbase Capella 使用多維擴展最佳實務。只能根據部署最佳實務來選擇服務和節點。這可能表示您無法完全符合自我管理的 Couchbase Server 叢集的組態。

Couchbase 管理員

部署叢集。

選擇支援區域和支援套件，然後部署叢集。如需詳細步驟和說明，請參閱 Couchbase 文件中的建立叢集。

重要

如果您使用的是 Couchbase Capella 免費試用版，您必須在開始遷移之前將其轉換為付費帳戶。若要轉換您的帳戶，請開啟 Couchbase Capella 控制平面的帳單區段，然後選擇新增啟用 ID。在您完成與 Couchbase Sales 的購買協議後，或透過 AWS Marketplace 進行購買後，啟用 ID 會傳送到您的帳單聯絡人電子郵件地址。

Couchbase 管理員

建立資料庫登入資料使用者。

資料庫登入資料使用者專屬於叢集，由使用者名稱、密碼和一組儲存貯體權限組成。建立儲存貯體和存取儲存貯體資料時，需要此使用者。 

在 Couchbase Capella 控制平面中，遵循 Couchbase Capella 文件中設定資料庫憑證的指示，為新叢集建立資料庫憑證。

注意

如果組織使用者想要從遠端或透過 Couchbase Capella UI 存取特定叢集上的儲存貯體資料，則需要指派給他們的組織角色憑證。這與資料庫登入資料不同，通常由應用程式和整合使用。建立組織使用者可讓您在 Couchbase Capella 叢集上建立和管理目標儲存貯體。

Couchbase 管理員

如果使用遷移選項 2，請安裝 Couchbase Shell。

您可以在可存取自我管理 Couchbase Server 和 Couchbase Capella 叢集的任何系統上安裝 Couchbase Shell。如需詳細資訊，請參閱 Couchbase Shell 文件中的Install Couchbase Shell 1.0.0-beta.5 版。

透過在命令列終端機中測試與自我管理叢集的連線，確認已安裝 Couchbase Shell。

Couchbase 管理員、系統管理員

允許 IP 地址。

  1. 在 Couchbase Capella 控制平面中，選擇叢集，然後選擇您的目標叢集。 

  2. 選擇叢集的連線索引標籤，並記錄在管理允許 IP 下叢集的連線端點。

  3. 若要新增安裝 Couchbase Shell 的系統 IP 地址，以及自我管理 Couchbase Server 叢集執行個體的 IP 地址做為允許的 IP 地址，請執行下列動作： 

    1. 在廣域網路下，選擇管理允許的 IP。 

    2. 選擇新增允許 IP，輸入您安裝 Couchbase Shell 之系統的 IP 地址，然後選擇新增 IP。 

    3. 重複上一個步驟，新增自我管理 Couchbase Server 叢集執行個體的 IP 地址。 

如需允許 IP 地址的詳細資訊，請參閱 Couchbase 文件中的設定允許的 IP 地址。

Couchbase 管理員、系統管理員

設定憑證。

  1. 若要下載叢集的根憑證，請在根憑證下選擇下載。 

  2. 使用 .pem 副檔名將根憑證儲存在將執行 Couchbase Shell 的 系統資料夾中。

  3. 接著，登入自我管理的 Couchbase Server Web 主控台，在左側導覽列中選擇安全性，然後選擇憑證索引標籤。

  4. 複製自我管理的 Couchbase Server 叢集的根憑證，並將其儲存為 .pem 檔案，並儲存到您為 Couchbase Capella 叢集儲存根憑證檔案的相同資料夾。如需根憑證的詳細資訊，請參閱 Couchbase Server 文件中的根憑證。

Couchbase 管理員、系統管理員

建立 Couchbase Shell 的組態檔案。

在 Couchbase Shell 安裝的主目錄中建立組態點檔案 （例如，/<HOME_DIRECTORY>/.cbsh/config)。如需詳細資訊，請參閱 Couchbase 文件中的Config 點檔案。

將來源和目標叢集的連線屬性新增至組態檔案。您可以使用其他資訊區段中的範例組態檔案，並編輯叢集的設定。 

將具有更新設定的組態檔案儲存至 .cbsh 資料夾 （例如，/<HOME_DIRECTORY>/.cbsh/config)。

Couchbase 管理員、系統管理員

建立目標儲存貯體。

對於每個來源儲存貯體，請遵循 Couchbase 文件中的建立儲存貯體中的指示，在 Couchbase Capella 叢集中建立一個目標儲存貯體。

您的目標儲存貯體組態必須符合自我管理 Couchbase Server 叢集中儲存貯體的儲存貯體名稱、記憶體設定和衝突解析設定。

Couchbase 管理員

建立範圍和集合。

每個儲存貯體都包含具有 金鑰空間 的預設範圍和集合_default._default。如果您針對範圍和集合使用任何其他金鑰空間，您必須在目標 Capella 叢集中建立相同的金鑰空間。

  1. 在您安裝 Couchbase Shell 的系統上開啟命令列終端機。 

  2. 若要啟動 Couchbase Shell，請執行下列命令。

    ./cbsh

  3. 對於您要遷移的每個儲存貯體，請執行下列命令，在 Capella 叢集中建立範圍和集合。請務必將 <BUCKET_NAME> 取代為您要遷移的儲存貯體名稱。

scopes --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope | where scope != "_default" | each { |it| scopes create $it.scope --clusters "Capella-Cluster" }
collections --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope collection | where $it.scope != "_default" | where $it.collection != "_default" | each { |it| collections create $it.collection --clusters "Capella-Cluster" --bucket <BUCKET_NAME> --scope $it.scope }
Couchbase 管理員

在 Couchbase Capella 上部署和設定資源

任務描述所需技能

選擇一個範本。

  1. 登入您的 Couchbase Capella 控制平面，選擇主導覽中的儀表板索引標籤或叢集索引標籤，然後選擇建立叢集。 

  2. 使用您從自我管理 Couchbase Server 叢集評估中記錄的資訊，選擇符合組態需求的叢集範本。如果您找不到適當的範本，請在叢集大小編輯器中選擇自訂範本。

Couchbase 管理員

選擇並設定節點。

選擇並設定節點以符合自我管理的 Couchbase Server 叢集環境，包括節點數量、服務分佈、運算或 RAM，以及儲存體。

Couchbase Capella 使用多維擴展最佳實務。只能根據部署最佳實務來選擇服務和節點。這可能表示您無法完全符合自我管理的 Couchbase Server 叢集的組態。

Couchbase 管理員

部署叢集。

選擇支援區域和支援套件，然後部署叢集。如需詳細步驟和說明，請參閱 Couchbase 文件中的建立叢集。

重要

如果您使用的是 Couchbase Capella 免費試用版，您必須在開始遷移之前將其轉換為付費帳戶。若要轉換您的帳戶，請開啟 Couchbase Capella 控制平面的帳單區段，然後選擇新增啟用 ID。在您完成與 Couchbase Sales 的購買協議後，或透過 AWS Marketplace 進行購買後，啟用 ID 會傳送到您的帳單聯絡人電子郵件地址。

Couchbase 管理員

建立資料庫登入資料使用者。

資料庫登入資料使用者專屬於叢集，由使用者名稱、密碼和一組儲存貯體權限組成。建立儲存貯體和存取儲存貯體資料時，需要此使用者。 

在 Couchbase Capella 控制平面中，遵循 Couchbase Capella 文件中設定資料庫憑證的指示，為新叢集建立資料庫憑證。

注意

如果組織使用者想要從遠端或透過 Couchbase Capella UI 存取特定叢集上的儲存貯體資料，則需要指派給他們的組織角色憑證。這與資料庫登入資料不同，通常由應用程式和整合使用。建立組織使用者可讓您在 Couchbase Capella 叢集上建立和管理目標儲存貯體。

Couchbase 管理員

如果使用遷移選項 2，請安裝 Couchbase Shell。

您可以在可存取自我管理 Couchbase Server 和 Couchbase Capella 叢集的任何系統上安裝 Couchbase Shell。如需詳細資訊，請參閱 Couchbase Shell 文件中的Install Couchbase Shell 1.0.0-beta.5 版。

透過在命令列終端機中測試與自我管理叢集的連線，確認已安裝 Couchbase Shell。

Couchbase 管理員、系統管理員

允許 IP 地址。

  1. 在 Couchbase Capella 控制平面中，選擇叢集，然後選擇您的目標叢集。 

  2. 選擇叢集的連線索引標籤，並記錄在管理允許 IP 下叢集的連線端點。

  3. 若要新增安裝 Couchbase Shell 的系統 IP 地址，以及自我管理 Couchbase Server 叢集執行個體的 IP 地址做為允許的 IP 地址，請執行下列動作： 

    1. 在廣域網路下，選擇管理允許的 IP。 

    2. 選擇新增允許 IP，輸入您安裝 Couchbase Shell 之系統的 IP 地址，然後選擇新增 IP。 

    3. 重複上一個步驟，新增自我管理 Couchbase Server 叢集執行個體的 IP 地址。 

如需允許 IP 地址的詳細資訊，請參閱 Couchbase 文件中的設定允許的 IP 地址。

Couchbase 管理員、系統管理員

設定憑證。

  1. 若要下載叢集的根憑證，請在根憑證下選擇下載。 

  2. 使用 .pem 副檔名將根憑證儲存在將執行 Couchbase Shell 的 系統資料夾中。

  3. 接著，登入自我管理的 Couchbase Server Web 主控台，在左側導覽列中選擇安全性，然後選擇憑證索引標籤。

  4. 複製自我管理的 Couchbase Server 叢集的根憑證，並將其儲存為 .pem 檔案，並儲存到您為 Couchbase Capella 叢集儲存根憑證檔案的相同資料夾。如需根憑證的詳細資訊，請參閱 Couchbase Server 文件中的根憑證。

Couchbase 管理員、系統管理員

建立 Couchbase Shell 的組態檔案。

在 Couchbase Shell 安裝的主目錄中建立組態點檔案 （例如，/<HOME_DIRECTORY>/.cbsh/config)。如需詳細資訊，請參閱 Couchbase 文件中的Config 點檔案。

將來源和目標叢集的連線屬性新增至組態檔案。您可以使用其他資訊區段中的範例組態檔案，並編輯叢集的設定。 

將具有更新設定的組態檔案儲存至 .cbsh 資料夾 （例如，/<HOME_DIRECTORY>/.cbsh/config)。

Couchbase 管理員、系統管理員

建立目標儲存貯體。

對於每個來源儲存貯體，請遵循 Couchbase 文件中的建立儲存貯體中的指示，在 Couchbase Capella 叢集中建立一個目標儲存貯體。

您的目標儲存貯體組態必須符合自我管理 Couchbase Server 叢集中儲存貯體的儲存貯體名稱、記憶體設定和衝突解析設定。

Couchbase 管理員

建立範圍和集合。

每個儲存貯體都包含具有 金鑰空間 的預設範圍和集合_default._default。如果您針對範圍和集合使用任何其他金鑰空間，您必須在目標 Capella 叢集中建立相同的金鑰空間。

  1. 在您安裝 Couchbase Shell 的系統上開啟命令列終端機。 

  2. 若要啟動 Couchbase Shell，請執行下列命令。

    ./cbsh

  3. 對於您要遷移的每個儲存貯體，請執行下列命令，在 Capella 叢集中建立範圍和集合。請務必將 <BUCKET_NAME> 取代為您要遷移的儲存貯體名稱。

scopes --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope | where scope != "_default" | each { |it| scopes create $it.scope --clusters "Capella-Cluster" }
collections --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope collection | where $it.scope != "_default" | where $it.collection != "_default" | each { |it| collections create $it.collection --clusters "Capella-Cluster" --bucket <BUCKET_NAME> --scope $it.scope }
Couchbase 管理員
任務描述所需技能

在自我管理的 Couchbase Server 叢集節點上開啟 TCP 連接埠。

確定在自我管理的 Couchbase Server 叢集節點上開啟 XDCR 通訊的適當連接埠。如需詳細資訊，請參閱 Couchbase Server 連接埠文件。

Couchbase 管理員、系統管理員

如果您使用的是 Couchbase Server Enterprise Edition，請設定 Couchbase XDCR。

  1. 在 Couchbase Capella 控制平面主要導覽中，選擇叢集，然後選擇要遷移的目標叢集。 

  2. 在根憑證下，選擇複製。

  3. 登入自我管理的 Couchbase Server Web 主控台，然後在主要導覽中選擇 XDCR。然後選擇新增遠端。 

  4. 輸入以下設定： 

    • 叢集名稱 – Capella 叢集連線的名稱

    • IP/Hostname – Couchbase Capella 叢集的連線端點

    • 遠端叢集的使用者名稱 – Couchbase Capella 叢集的資料庫使用者

    • 密碼 – Couchbase Capella 叢集的資料庫使用者密碼

    • 啟用安全連線 – 已選取

    • 完整 (TLS 加密密碼和資料） – 已選取

  5. 貼上您先前複製的 Capella 叢集根憑證，然後選擇儲存。

Couchbase 管理員

啟動 Couchbase XDCR。

  1. 在自我管理的 Couchbase Server Web 主控台中，選擇主導覽中的 XDCR，然後選擇新增複寫。

  2. 輸入以下設定：

    • 從儲存貯體複寫 – 選取來源儲存貯體以進行遷移。

    • 遠端儲存貯體 – 輸入目標儲存貯體名稱。

    • 遠端叢集 – 選取您先前建立的目標叢集。

  3. 選擇儲存複寫。複寫程序應該會在幾秒鐘內開始。

Couchbase 管理員

從 Enterprise Edition 遷移資料

任務描述所需技能

在自我管理的 Couchbase Server 叢集節點上開啟 TCP 連接埠。

確定在自我管理的 Couchbase Server 叢集節點上開啟 XDCR 通訊的適當連接埠。如需詳細資訊，請參閱 Couchbase Server 連接埠文件。

Couchbase 管理員、系統管理員

如果您使用的是 Couchbase Server Enterprise Edition，請設定 Couchbase XDCR。

  1. 在 Couchbase Capella 控制平面主要導覽中，選擇叢集，然後選擇要遷移的目標叢集。 

  2. 在根憑證下，選擇複製。

  3. 登入自我管理的 Couchbase Server Web 主控台，然後在主要導覽中選擇 XDCR。然後選擇新增遠端。 

  4. 輸入以下設定： 

    • 叢集名稱 – Capella 叢集連線的名稱

    • IP/Hostname – Couchbase Capella 叢集的連線端點

    • 遠端叢集的使用者名稱 – Couchbase Capella 叢集的資料庫使用者

    • 密碼 – Couchbase Capella 叢集的資料庫使用者密碼

    • 啟用安全連線 – 已選取

    • 完整 (TLS 加密密碼和資料） – 已選取

  5. 貼上您先前複製的 Capella 叢集根憑證，然後選擇儲存。

Couchbase 管理員

啟動 Couchbase XDCR。

  1. 在自我管理的 Couchbase Server Web 主控台中，選擇主導覽中的 XDCR，然後選擇新增複寫。

  2. 輸入以下設定：

    • 從儲存貯體複寫 – 選取來源儲存貯體以進行遷移。

    • 遠端儲存貯體 – 輸入目標儲存貯體名稱。

    • 遠端叢集 – 選取您先前建立的目標叢集。

  3. 選擇儲存複寫。複寫程序應該會在幾秒鐘內開始。

Couchbase 管理員
任務描述所需技能

將自我管理叢集索引遷移至 Couchbase Capella。

重要

如果您的遷移索引少於 50 個，建議您執行此程序。如果您有超過 50 個要遷移的索引，建議您使用遷移選項 2。

  1. 在 Couchbase Web 主控台上，選擇索引。

  2. 在索引清單中，選擇您要遷移的第一個索引。接著會顯示索引定義。

  3. 使用 CREATE陳述式複製索引定義，但不複製 WITH { "defer_build":true }。

    例如，從下列範例索引定義中，您只能複製 CREATE INDEX `cityindex` ON `travel-sample`(`city`)。 

    CREATE INDEX `cityindex` ON `travel-sample`(`city`) WITH { "defer_build":true }

  4. 在 Couchbase Capella 控制平面中，選擇叢集，然後選擇目標叢集。 

  5. 在工具下拉式清單中，選擇查詢工作台。將您先前複製的CREATE陳述式貼到查詢編輯器，然後選擇執行。這會建立並建置索引。

  6. 若要確認已建立索引，請從工具下拉式清單中選擇索引。清單顯示已建立並建置索引。

  7. 針對每個必須遷移的索引重複此程序。

Couchbase 管理員、系統管理員

使用選項 1 遷移索引

任務描述所需技能

將自我管理叢集索引遷移至 Couchbase Capella。

重要

如果您的遷移索引少於 50 個，建議您執行此程序。如果您有超過 50 個要遷移的索引，建議您使用遷移選項 2。

  1. 在 Couchbase Web 主控台上，選擇索引。

  2. 在索引清單中，選擇您要遷移的第一個索引。接著會顯示索引定義。

  3. 使用 CREATE陳述式複製索引定義，但不複製 WITH { "defer_build":true }。

    例如，從下列範例索引定義中，您只能複製 CREATE INDEX `cityindex` ON `travel-sample`(`city`)。 

    CREATE INDEX `cityindex` ON `travel-sample`(`city`) WITH { "defer_build":true }

  4. 在 Couchbase Capella 控制平面中，選擇叢集，然後選擇目標叢集。 

  5. 在工具下拉式清單中，選擇查詢工作台。將您先前複製的CREATE陳述式貼到查詢編輯器，然後選擇執行。這會建立並建置索引。

  6. 若要確認已建立索引，請從工具下拉式清單中選擇索引。清單顯示已建立並建置索引。

  7. 針對每個必須遷移的索引重複此程序。

Couchbase 管理員、系統管理員
任務描述所需技能

遷移索引定義。

重要

如果您有超過 50 個要遷移的索引，建議您執行此程序。如果您的遷移索引少於 50 個，建議您使用遷移選項 1。

  1. 在您安裝 Couchbase Shell 的系統上開啟命令列終端機。 

  2. 若要啟動 Couchbase Shell，請執行下列命令。

    ./cbsh

  3. 若要連線至自我管理的 Couchbase Server 叢集，請執行下列命令。

    cb-env cluster On-Prem-Cluster

  4. 若要將索引定義從自我管理的 Couchbase Server 叢集遷移至 Couchbase Capella 叢集，請針對您要遷移的每個儲存貯體執行下列命令。請確定您使用對應至您要遷移之索引的儲存貯體名稱<BUCKET_NAME>取代 。此遷移選項需要您的目標儲存貯體名稱與來源儲存貯體名稱相同。

    query indexes --definitions | where bucket =~ <BUCKET_NAME>| get definition | each { |it| query $it --clusters Capella-Cluster }
Couchbase 管理員、系統管理員

建置索引定義。

  1. 若要切換內容至 Couchbase Capella 叢集，請執行下列命令：

    cb-env cluster Capella-Cluster

  2. 若要建置遷移至 Couchbase Capella 叢集的索引定義，請執行下列命令，將 取代<BUCKET_NAME>為對應至您要建置之索引的儲存貯體名稱。

    query 'SELECT RAW CONCAT("BUILD INDEX ON ", k , "(['", CONCAT2 ("','", inames), "']);") FROM system:indexes AS s LET bid = CONCAT("`",s.bucket_id, "`"), sid = CONCAT("`", s.scope_id, "`"), kid = CONCAT("`", s.keyspace_id, "`"), k = NVL2(bid, CONCAT2(".", bid, sid, kid), kid) WHERE s.namespace_id = "default" AND s.bucket_id = "" GROUP BY k LETTING inames = ARRAY_AGG(s.name) FILTER (WHERE s.state = 'deferred') HAVING ARRAY_LENGTH(inames) > 0;' | each { |it| query $it }

  3. 針對每個儲存貯體重複上述動作。

Couchbase 管理員、系統管理員

使用選項 2 遷移索引

任務描述所需技能

遷移索引定義。

重要

如果您有超過 50 個要遷移的索引，建議您執行此程序。如果您的遷移索引少於 50 個，建議您使用遷移選項 1。

  1. 在您安裝 Couchbase Shell 的系統上開啟命令列終端機。 

  2. 若要啟動 Couchbase Shell，請執行下列命令。

    ./cbsh

  3. 若要連線至自我管理的 Couchbase Server 叢集，請執行下列命令。

    cb-env cluster On-Prem-Cluster

  4. 若要將索引定義從自我管理的 Couchbase Server 叢集遷移至 Couchbase Capella 叢集，請針對您要遷移的每個儲存貯體執行下列命令。請確定您使用對應至您要遷移之索引的儲存貯體名稱<BUCKET_NAME>取代 。此遷移選項需要您的目標儲存貯體名稱與來源儲存貯體名稱相同。

    query indexes --definitions | where bucket =~ <BUCKET_NAME>| get definition | each { |it| query $it --clusters Capella-Cluster }
Couchbase 管理員、系統管理員

建置索引定義。

  1. 若要切換內容至 Couchbase Capella 叢集，請執行下列命令：

    cb-env cluster Capella-Cluster

  2. 若要建置遷移至 Couchbase Capella 叢集的索引定義，請執行下列命令，將 取代<BUCKET_NAME>為對應至您要建置之索引的儲存貯體名稱。

    query 'SELECT RAW CONCAT("BUILD INDEX ON ", k , "(['", CONCAT2 ("','", inames), "']);") FROM system:indexes AS s LET bid = CONCAT("`",s.bucket_id, "`"), sid = CONCAT("`", s.scope_id, "`"), kid = CONCAT("`", s.keyspace_id, "`"), k = NVL2(bid, CONCAT2(".", bid, sid, kid), kid) WHERE s.namespace_id = "default" AND s.bucket_id = "" GROUP BY k LETTING inames = ARRAY_AGG(s.name) FILTER (WHERE s.state = 'deferred') HAVING ARRAY_LENGTH(inames) > 0;' | each { |it| query $it }

  3. 針對每個儲存貯體重複上述動作。

Couchbase 管理員、系統管理員
任務描述所需技能

將自我管理叢集全文搜尋索引遷移至 Couchbase Capella。

  1. 在 Couchbase Web 主控台中，選擇搜尋。 

  2. 在全文搜尋 (FTS) 索引清單中，選擇您要遷移的第一個 FTS 索引，選擇顯示索引定義 JSON，然後選擇複製到剪貼簿。記下索引名稱及其所屬的儲存貯體。

  3. 在 Couchbase Capella 控制平面中，選擇叢集，然後選擇目標叢集。 

  4. 在工具下拉式清單中，選擇全文搜尋。 

  5. 選擇匯入索引，然後貼上 FTS 索引定義。 

  6. 輸入索引名稱，選取正確的儲存貯體，如自我管理叢集所述，然後選擇建立。

  7. 針對每個必須遷移的 FTS 索引重複此程序。

Couchbase 管理員

遷移全文搜尋索引

任務描述所需技能

將自我管理叢集全文搜尋索引遷移至 Couchbase Capella。

  1. 在 Couchbase Web 主控台中，選擇搜尋。 

  2. 在全文搜尋 (FTS) 索引清單中，選擇您要遷移的第一個 FTS 索引，選擇顯示索引定義 JSON，然後選擇複製到剪貼簿。記下索引名稱及其所屬的儲存貯體。

  3. 在 Couchbase Capella 控制平面中，選擇叢集，然後選擇目標叢集。 

  4. 在工具下拉式清單中，選擇全文搜尋。 

  5. 選擇匯入索引，然後貼上 FTS 索引定義。 

  6. 輸入索引名稱，選取正確的儲存貯體，如自我管理叢集所述，然後選擇建立。

  7. 針對每個必須遷移的 FTS 索引重複此程序。

Couchbase 管理員
任務描述所需技能

從自我管理的 Couchbase Server Community Edition 匯出資料。

Couchbase Community Edition 不提供加密的 XDCR。您可以從 Couchbase Community Edition 匯出資料，然後手動將資料匯入 Couchbase Capella。

若要從來源儲存貯體匯出資料，cbexport請在命令列使用 。

以下命令提供為範例。

cbexport json \
--cluster localhost \
--bucket <SOURCE BUCKET NAME> \
--format lines \
--username <USERNAME> \
--password <PASSWORD> \
--include-key cbkey \
--scope-field cbscope \
--collection-field cbcoll \
--output cbexported_data.json

請注意，cbkey、cbcoll、 cbscope和 cbexported_data.json是任意標籤。稍後會在程序中參考它們，因此如果您選擇以不同的名稱命名，請記下來。

Couchbase 管理員

將資料匯入 Couchbase Capella。

  1. 在 Couchbase Capella 控制平面中，選擇叢集，然後選擇目標叢集。

  2. 在工具下拉式清單中，選擇匯入。這將開啟精靈，其中包含下列六個步驟：

    1. 儲存貯體 – 選擇目標儲存貯體。

    2. 檔案 – 選擇 JSON、選擇行，然後選擇使用您的 Web 瀏覽器。如果您有大量資料，您可以探索手動選項。選取 建立的檔案cbexport。 

    3. 集合 – 選擇自訂集合映射。 

      如果您的 Community Edition 資料庫不使用範圍或集合，或僅使用 _default，您可以改為選擇選取單一集合選項。

      針對集合映射表達式，輸入 %cbscope%.%cbcoll%。若要驗證此表達式是否正常運作，您可以貼上範例資料，如下所示。

      { "cbscope":"inventory", "cbcoll":"landmark", "cbkey":"landmark_3991" }

    4. 金鑰 – 選擇客戶產生。（如果您不在乎保留要匯入之資料的金鑰，您可以改為選取自動產生 UUID，然後繼續進行步驟 5。) 針對金鑰名稱產生器表達式，輸入 %cbkey%。若要驗證此表達式是否正常運作，請貼上一些範例資料。

    5. 組態 – 選擇忽略欄位，然後輸入 cbscope、cbcoll、cbkey。這些欄位包含匯入後不需要在目標儲存貯體中的暫時性資訊。將其他設定保留為各自的預設設定。

    6. 匯入 – 檢閱，然後在準備好時選擇匯入。等待上傳和資料匯入。

對於大型檔案，Couchbase Capella 支援使用 cURL 匯入命令列。您可以在 Couchbase Capella 文件的匯入資料中，更詳細地探索匯入選項。

Couchbase 管理員

從 Couchbase Community Edition 遷移資料

任務描述所需技能

從自我管理的 Couchbase Server Community Edition 匯出資料。

Couchbase Community Edition 不提供加密的 XDCR。您可以從 Couchbase Community Edition 匯出資料，然後手動將資料匯入 Couchbase Capella。

若要從來源儲存貯體匯出資料，cbexport請在命令列使用 。

以下命令提供為範例。

cbexport json \
--cluster localhost \
--bucket <SOURCE BUCKET NAME> \
--format lines \
--username <USERNAME> \
--password <PASSWORD> \
--include-key cbkey \
--scope-field cbscope \
--collection-field cbcoll \
--output cbexported_data.json

請注意，cbkey、cbcoll、 cbscope和 cbexported_data.json是任意標籤。稍後會在程序中參考它們，因此如果您選擇以不同的名稱命名，請記下來。

Couchbase 管理員

將資料匯入 Couchbase Capella。

  1. 在 Couchbase Capella 控制平面中，選擇叢集，然後選擇目標叢集。

  2. 在工具下拉式清單中，選擇匯入。這將開啟精靈，其中包含下列六個步驟：

    1. 儲存貯體 – 選擇目標儲存貯體。

    2. 檔案 – 選擇 JSON、選擇行，然後選擇使用您的 Web 瀏覽器。如果您有大量資料，您可以探索手動選項。選取 建立的檔案cbexport。 

    3. 集合 – 選擇自訂集合映射。 

      如果您的 Community Edition 資料庫不使用範圍或集合，或僅使用 _default，您可以改為選擇選取單一集合選項。

      針對集合映射表達式，輸入 %cbscope%.%cbcoll%。若要驗證此表達式是否正常運作，您可以貼上範例資料，如下所示。

      { "cbscope":"inventory", "cbcoll":"landmark", "cbkey":"landmark_3991" }

    4. 金鑰 – 選擇客戶產生。（如果您不在乎保留要匯入之資料的金鑰，您可以改為選取自動產生 UUID，然後繼續進行步驟 5。) 針對金鑰名稱產生器表達式，輸入 %cbkey%。若要驗證此表達式是否正常運作，請貼上一些範例資料。

    5. 組態 – 選擇忽略欄位，然後輸入 cbscope、cbcoll、cbkey。這些欄位包含匯入後不需要在目標儲存貯體中的暫時性資訊。將其他設定保留為各自的預設設定。

    6. 匯入 – 檢閱，然後在準備好時選擇匯入。等待上傳和資料匯入。

對於大型檔案，Couchbase Capella 支援使用 cURL 匯入命令列。您可以在 Couchbase Capella 文件的匯入資料中，更詳細地探索匯入選項。

Couchbase 管理員
任務描述所需技能

驗證資料遷移。

  1. 在 Couchbase Capella 控制平面中，選擇叢集，然後在叢集清單中選擇目標叢集。 

  2. 選擇目標叢集的儲存貯體標籤。確認目標儲存貯體中的項目 （文件） 數量符合來源儲存貯體中的項目數量。

  3. 在目標叢集的工具下拉式清單中，選擇文件。確認所有文件都已遷移。

  4. （選用） 遷移所有資料後，您可以透過刪除複寫來關閉複寫。如需詳細資訊，請參閱 Couchbase 文件中的刪除複寫。

Couchbase 管理員

驗證索引遷移。

在 Couchbase Capella 控制平面中，在目標叢集的工具下拉式清單中，選擇索引。確認索引已遷移並建置。

Couchbase 管理員

驗證查詢結果。

  1. 在 Couchbase Capella 控制平面中，在目標叢集的工具下拉式清單中，選擇查詢工作台。 

  2. 執行範例 N1QL 查詢或應用程式中使用的查詢。請確定您收到的結果與在自我管理的 Couchbase Server 叢集中執行查詢時的結果相同。

Couchbase 管理員

驗證全文搜尋結果 （如果您遷移 FTS 索引，則適用）。

  1. 在 Couchbase Capella 控制平面中，在目標叢集的工具下拉式清單中，選擇全文搜尋。 

  2. 選擇 FTS 索引的名稱來選取 FTS 索引。 

  3. 選擇 Search (搜尋)。 

  4. 輸入範例搜尋查詢，然後選擇搜尋。 

  5. 確認結果與在自我管理叢集上執行搜尋時相同。

Couchbase 管理員

測試和驗證遷移

任務描述所需技能

驗證資料遷移。

  1. 在 Couchbase Capella 控制平面中，選擇叢集，然後在叢集清單中選擇目標叢集。 

  2. 選擇目標叢集的儲存貯體標籤。確認目標儲存貯體中的項目 （文件） 數量符合來源儲存貯體中的項目數量。

  3. 在目標叢集的工具下拉式清單中，選擇文件。確認所有文件都已遷移。

  4. （選用） 遷移所有資料後，您可以透過刪除複寫來關閉複寫。如需詳細資訊，請參閱 Couchbase 文件中的刪除複寫。

Couchbase 管理員

驗證索引遷移。

在 Couchbase Capella 控制平面中，在目標叢集的工具下拉式清單中，選擇索引。確認索引已遷移並建置。

Couchbase 管理員

驗證查詢結果。

  1. 在 Couchbase Capella 控制平面中，在目標叢集的工具下拉式清單中，選擇查詢工作台。 

  2. 執行範例 N1QL 查詢或應用程式中使用的查詢。請確定您收到的結果與在自我管理的 Couchbase Server 叢集中執行查詢時的結果相同。

Couchbase 管理員

驗證全文搜尋結果 （如果您遷移 FTS 索引，則適用）。

  1. 在 Couchbase Capella 控制平面中，在目標叢集的工具下拉式清單中，選擇全文搜尋。 

  2. 選擇 FTS 索引的名稱來選取 FTS 索引。 

  3. 選擇 Search (搜尋)。 

  4. 輸入範例搜尋查詢，然後選擇搜尋。 

  5. 確認結果與在自我管理叢集上執行搜尋時相同。

Couchbase 管理員

相關資源

準備遷移

遷移資料和索引

Couchbase Capella SLAs 和支援

其他資訊

下列程式碼是 Couchbase Shell 的範例組態檔案。 

Version = 1
 
[[clusters]]
identifier = "On-Prem-Cluster"
hostnames = ["<SELF_MANAGED_COUCHBASE_CLUSTER>"]
default-bucket = "travel-sample"
username = "<SELF_MANAGED_ADMIN>"
password = "<SELF_MANAGED_ADMIN_PWD>"
tls-cert-path = "/<ABSOLUTE_PATH_TO_SELF_MANAGED_ROOT_CERT>"
data-timeout = "2500ms"
connect-timeout = "7500ms"
query-timeout = "75s"
 
[[clusters]]
identifier = "Capella-Cluster"
hostnames = ["<COUCHBASE_CAPELLA_ENDPOINT>"]
default-bucket = "travel-sample"
username = "<CAPELLA_DATABASE_USER>"
password = "<CAPELLA_DATABASE_USER_PWD>"
tls-cert-path = "/<ABSOLUTE_PATH_TO_COUCHBASE_CAPELLA_ROOT_CERT>"
data-timeout = "2500ms"
connect-timeout = "7500ms"
query-timeout = "75s"

儲存組態檔案之前，請使用下表來確保您已新增自己的來源和目標叢集資訊。

 

<SELF_MANAGED_COUCHBASE_CLUSTER>

使用自我管理 Couchbase Server 叢集的 IP 地址。

<SELF_MANAGED_ADMIN>

使用自我管理 Couchbase Server 叢集的管理員使用者。

<ABSOLUTE_PATH_TO_SELF_MANAGED_ROOT_CERT>

針對自我管理的 Couchbase Server 叢集，使用儲存根憑證檔案的絕對路徑。

<COUCHBASE_CAPELLA_ENDPOINT>

使用 Couchbase Capella 叢集的連線端點。

<CAPELLA_DATABASE_USER>

將資料庫使用者用於您的 Couchbase Capella 叢集。

<CAPELLA_DATABASE_USER_PWD>

為您的 Couchbase Capella 叢集使用資料庫使用者密碼。

<ABSOLUTE_PATH_TO_COUCHBASE_CAPELLA_ROOT_CERT>

使用 Couchbase Capella 叢集儲存根憑證檔案的絕對路徑。

在本頁面

隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。