云數據庫（Relational Database Service，即關系型數據庫服務，簡稱RDS）是阿里云對外提供的一種即開即用、穩定可靠、可彈性伸縮的在線數據庫服務（了解RDS）。

購買RDS前須知

• OpenSearch目前支持RDS for MySQL（不支持5.2以下，8以上版本，支持8.0）；

• 購買RDS實例時，必須是常規實例，雙機高可用版，RDS MySQL基礎版和三節點企業版為非高可用版，不支持。

• RDS實例必須隸屬于當前登錄阿里云賬號才能訪問使用。

• RDS實例所在區域必須與OpenSearch應用區域一致。

• 不支持RDS clone實例，否則應用激活后狀態一直處于初始化。

• 不支持的RDS實例及不滿足相關限制的RDS實例索引重建將會失效。

• RDS數據源只支持VPC網絡

溫馨提示：

• 不支持DRDS數據源。

• 授權：對OpenSearch獲取RDS數據做授權操作，在用戶設置了IP白名單的情況下，OpenSearch會將所用IP添加到用戶白名單中。若不勾選授權，則連接數據不會高亮顯示。

支持功能

• 支持（手動/定時索引重建）拉取指定數據庫表全量。

• 支持單個或多個數據源表數據橫向合并，要求這些源表結構及數據源插件配置必須完全相同，并且主鍵值均不重復（主鍵值重復會覆蓋），主要支持以下2種場景：

  • 應用表中配有一個數據源，并且包含多個源表。

  • 應用表中配有多個數據源，并且各數據源包含1個或多個源表。

• 支持數據源字段轉換插件。

• 支持的數據同步方式：

  • 自動同步；

  • 自購DTS實時同步；

  • 不自動同步。

• 支持（全量）過濾條件。

• 支持通過通配符*匹配數據庫表名。

相關限制

• 只支持RDS的binlog為full模式。

• 只支持RDS中的MySQL常規實例 （雙機高可用版）。

• 不支持5.2以下，8以上版本，支持8.0。

• 5.6版本的RDS，建議合理調大參數loose_max_execution_time、loose_max_statement_time的閾值，以免在索引重建時報錯類似錯誤：Query execution was interrupted, max_statement_time exceeded。

• RDS實例必須隸屬于當前登錄阿里云賬號才能訪問。

• RDS實例所在區域必須與OpenSearch應用區域一致。

• 標準版應用在配置RDS數據源后，不支持（SDK/API）推送增量。

• （外網區域）標準版應用的RDS數據源，暫不支持數據源過濾條件。

• 不支持replace into語法。

• 不支持truncate和drop命令，請使用delete命令刪除數據。

• 不支持RDS clone實例，否則應用激活后狀態一直處于初始化。

• RDS 訪問密碼不能包含%符號，會導致索引重建任務失敗。

• 不支持通過RDS高權限賬號訪問。（否則連接RDS會失敗）。

• 不支持在不同數據庫源表結構之間做字段列合并。

• 不支持無binlog的replica client 和 replica slave。檢查及開啟方式，請點擊查看文檔。

注意事項

• RDS支持內/外網的域名切換，OpenSearch對RDS數據獲取均不收取任何流量費用。

• OpenSearch僅支持從主庫拉取全量數據，建議根據您的業務繁忙情況，選擇低峰期索引重建導入全量數據。

• RDS表中datetime及timestamp此類時間類型，系統會自動轉化為毫秒數，請將對應應用表字段類型設置為TIMESTAMP。

• 外網區域RDS實例，需要申請內網地址后才能訪問，否則會提示連接RDS服務失敗，請稍后再試。

• 不符合數據源過濾條件的（全量）文檔會被過濾，并且如果對應應用表中存在相同主鍵值的文檔也會一并刪除。

• 數據源側長時間（15天及以上）沒有增量數據，可能會導致數據同步異常，如遇此情況請手動操作線下變更即可解決。

• 通過OpenSearch同步RDS數據源數據時，需要將OpenSearch服務器的IP地址段加入到RDS對應的安全設置中，各區域的IP白名單可參考如下列表：

  地域	IP地址段
  杭州	100.104.190.128/26,100.104.241.128/26
  北京	100.104.16.192/26,100.104.179.0/26
  上海	100.104.37.0/26,100.104.46.0/26
  深圳	100.104.87.192/26,100.104.132.192/26
  青島	100.104.240.128/26,100.104.111.128/26
  張家口	100.104.155.192/26,100.104.238.64/26
  德國	100.104.127.0/26,100.104.35.192/26
  美國	100.104.193.128/26,100.104.119.128/26
  新加坡	100.104.58.192/26,100.104.74.192/26

賬號授權問題

MySQL5.7+ 接入&使用建議：

• MySQL5.7+ 接入時，需要授權訪問RDS實例。并且填寫賬號密碼,初次接入時，請謹慎選擇賬號密碼。

• 【確保賬號權限】必須確保賬號能有查看該庫所有表的權限（上游DTS服務的限制）， 保證能正確執行 show create table *. *，如果沒有。可能會發生實時服務同步出現問題。

• 【少做賬號權限變更】當前OpenSearch實時任務也是MySQL的客戶端。賬號變更會帶來當前實時任務的不能正常消費。同時新版本創建也會受影響。若變更賬號密碼，需要刪除實例重新接入庫。

• OpenSearch需要用戶RDS的最小權限是：1. show create table權限；2. REPLICATION SLAVE 或 REPLICATION CLIENT權限；3. binlog_row_image為FULL；4. binlog_format 為ROW

• 如果RDS開啟了SSL證書加密，一定要保證證書有效期沒有過期，如果過期了，會導致連接異常，請及時更新SSL證書有效期。

常見問題

• 使用RAM子賬號在控制臺中為應用配置RDS數據源，必須要對該RAM子賬號進行授權，否則會提示連接RDS服務失敗，請稍后再試，參考 創建RAM用戶文檔（確保主賬號有創建OpenSearch服務關聯角色）。

• RDS訪問密碼不能包含%符號，否則會導致索引重建任務失敗。（報錯提示： Illegal hex characters in escape (%) pattern）。

• 系統要求應用表主鍵值不重復，如果分表情況下主鍵值有重復會覆蓋，可使用StringCatenateExtractor數據源插件合并多個字段值，來源字段為pk,$table（pk替換為RDS表主鍵字段，$table為默認系統變量，表示對應數據庫表名，$table需要配置通配符分表才可以用），拼接字符為-（可自定義）。例如，RDS表為my_table_0，主鍵字段值為123456，拼接后新主鍵值為123456-my_table_0。

• 根據數據庫表中的date或datetime字段類型過濾數據，假設數據庫表字段名為createtime，則數據源過濾條件中的時間格式必須為 createtime>'2018-03-01 00:00:00'，如果使用 createtime>'2018-3-1 00:00:00'這種格式會報錯。

配置RDS數據源流程

• 在快速搭建應用過程，配置RDS數據源。

• 已創建應用可通過應用詳情頁——“線下變更”修改。

控制臺配置步驟及注意事項

1.選擇RDS數據源，點擊新建數據庫。

2.RDS信息填寫完成后，點擊連接按鈕。

OpenSearch會嘗試連接，并根據具體情形，給出結果提示：

3.已建立數據源連接界面如下，選擇對應表，并單擊向右箭頭，保存到右側已選擇界面。

• 選擇或輸入該數據庫下需要訪問的表名（大小寫敏感）。

• 支持分表規則 table_* 的方式，例如 table_a、table_b 等。

4.字段映射，選擇需要拉取的數據庫字段。單擊確定，完成應用創建。

• 在該界面可以添加需要映射同步的數據庫字段。

• 在該界面中的內容轉換，可以添加數據源插件，插件的使用及說明文檔，請數據源插件說明。

5.配置RDS數據源過濾條件。

• OpenSearch應用表中也可配置多個數據源，但最終這些表結構及配置必須完全相同。

• RDS數據源配置的過濾條件只能拉取符合該條件的記錄，詳細配置請參考數據源過濾條件（RDS/PolarDB）。