升級到新的主要版本

當資料庫的主要版本達到使用期限 (EOL) 時，請升級至現行主要版本。您可以升級 IBM Cloud® Databases for Elasticsearch 部署，以使用最新版 Elasticsearch。

升級至 Databases for Elasticsearch可用的最新版本 Elasticsearch。透過型錄、Cloud Databases CLI 外掛程式或 Cloud Databases API尋找最新版本。

升級是透過將資料的備份還原至新的部署來處理。從備份還原有一些優點:

原始資料庫會維持執行，正式作業工作則可以不間斷。
您可以在正式作業之外測試新資料庫，並處理任何應用程式不相容。
整個過程可以隨時重新運作。
全新的復原降低了舊版資料庫中不需要的工件轉移到新資料庫的可能性。

升級之前

將叢集升級到版本之前8.x，採取以下措施：

檢查在Databases for Elasticsearch上自動啟用並傳送至 IBM® Cloud Logs 的棄用日誌，以了解您是否正在使用任何已棄用的功能並更新您的程式碼。
回顧重大變化並對版本的程式碼和配置進行任何必要的更改8.x。
如果您使用插件，請確保每個插件版本都相容Elasticsearch版本8.x。

索引對映

Elasticsearch 7.x及更高版本中刪除了映射類型。在 Elasticsearch 7.x 或更新版本中建立的索引不再接受預設對映。在 7.x中，也會在 API 中淘汰類型。如需相關資訊，請參閱 Elasticsearch 移除對映類型。

重新檢索準則

Databases for Elasticsearch 索引僅與它們建立所在版本的相同版本或 plusOne 版本相容。只有明確的重新檢索作業會將索引更新為現行資料庫版本。

與 Kibana 的連線

如果您要部署 Kibana 以連接至 Databases for Elasticsearch 實例，請記住您部署的 Kibana 版本必須符合 Elasticsearch 實例的版本。佈建新的 Kibana 版本，以維護與已升級實例的連線功能。

在使用者介面中升級

升級到新版本時恢復備份從備份和復原選項卡上的概述您的部署頁面。點選恢復備份在所選備份的溢出選單或擴充表行上。這將開啟恢復配置頁面，您可以在其中選擇新部署的選項。其中一個選項是「資料庫版本」，它會自動移入可供您使用的版本。選擇版本並點擊恢復備份啟動配置和恢復過程。

透過 CLI 升級

當您透過備份升級和還原時IBM Cloud CLI，從資源控制器使用下列設定指令。

ibmcloud resource service-instance-create <service-name> <service-id> <service-plan-id> <region>

參數 service-name、service-id、service-plan-id 和 region 都是必要的。您也可以在 JSON 物件中提供版本及備份 ID 參數給 -p。在備份時，會使用與來源部署相同的磁碟及記憶體來自動調整新部署的大小。

可以使用下列命令檢索部署的備份清單和備份 ID。

ibmcloud cdb deployment-backups-list <deployment name or CRN> --json

使用您選擇的備份的 ID 作為資源控制器命令中的參數，如下所示。

ibmcloud resource service-instance-create example-es-upgrade databases-for-elasticsearch standard us-south \
-p \ '{
  "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version":8.12
}'

透過 API 升級

類似於透過 API 佈建，您需要先完成使用資源控制器 API 的必要步驟，然後才能使用它從備份升級。然後，傳送 POST 要求給 API。參數 name、target、resource_group 和 resource_plan_id 都是必要的。您也提供版本和備份 ID。新部署與備份時的來源部署具有相同的記憶體及磁碟配置。

可以使用以下 API 請求檢索部署的備份清單和備份 ID。

curl -X GET  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/backups  
-H 'Authorization: Bearer <>' \

在資源控制器 API 請求中使用您選擇的備份的 ID，如下例所示。

curl -X POST \
  https://resource-controller.cloud.ibm/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "my-instance",
    "target": "bluemix-us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-elasticsearch-standard",
    "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
    "version":8.12
  }'