全部產品
Search

搜尋本產品

    Data Transmission Service：SQL Adapter

    文件中心

    Data Transmission Service：SQL Adapter

    更新時間：Jul 06, 2024

    ADAM SQL Adapter是基於PostgreSQL通迅協議的SQL轉送 Proxy服務。本文介紹如何使用SQL Adapter實現不相容SQL的轉換。

    功能介紹

    SQL Adapter目前支援Oracle到PolarDB O或PolarDB PostgreSQL的SQL改造。主要功能有：
    • 即時轉換從Oracle遷移到PolarDB O或PolarDB PostgreSQL不完全相容的SQL。
    • 非同步記錄所有需要改造的SQL。
    • 您可以對無法自動轉換的SQL進行自訂修改。

    前提條件

    • 已完成結構遷移。
    • 您的應用需要部署在VPC環境內，SQL Adapter功能暫不支援通過公網使用。
    • Adapter執行個體當前僅支援杭州和北京地區。
    • 已開通AliyunAdamAccessingDatabaseRole角色。

    操作步驟

    1. 申請ADAM SQL Adapter許可權。
      1. 登入Data Management 5.0。
      2. 在頂部功能表列中，選擇整合與開發（DTS） > 異構資料庫遷移（ADAM） > 遷移實驗室。
      3. 在ADAM SQL Adapter地區，單擊申請。
      4. 在申請頁面填寫公司名稱、聯絡電話、申請原因等資訊，單擊提交，完成申請。
    2. 建立Adapter執行個體。
      1. 登入Data Management 5.0。
      2. 在頂部功能表列中，選擇整合與開發（DTS） > 異構資料庫遷移（ADAM） > 遷移實驗室。
      3. 在ADAM SQL Adapter地區，單擊詳情。
      4. 在ADAM Adapter頁面，單擊申請adapter執行個體。
      5. 填寫參數，建立Adapter執行個體。
        建立Adapter執行個體
        參數取值及含義
        VPC網路所在地區表示建立Adapter執行個體的VPC所在地區。
        取值範圍：
        • cn-hangzhou
        • cn-beijing
        VPC可用性區域表示建立Adapter執行個體的VPC所在可用性區域。
        取值範圍：
        • 如果地區選擇cn-hangzhou，可用性區域為cn-hangzhou-b。
        • 如果地區選擇cn-beijing，可用性區域為cn-beijing-b。
        說明 Adapter當前僅支援B可用性區域。
        交換器名稱表示所選VPC地區及可用性區域下已建立的交換器。如無可用交換器，請前往專用網路管理主控台建立，具體方法，請參見建立和管理交換器。
        源庫畫像選擇源庫畫像。如果沒有源庫畫像，請參見資料庫畫像。
      6. 單擊建立執行個體按鈕。
    3. 配置目標庫。
      1. 在ADAM Adapter頁面單擊配置目標庫。
        配置目標庫
      2. 單擊左上方配置目標庫按鈕，填寫目標庫相關參數。
        配置目標庫
        參數取值及含義
        執行個體地區不可修改，與建立Adapter執行個體時取值相同。
        資料庫連通的VPC選擇目標PolarDB執行個體的VPC。
        資料庫執行個體選擇目標PolarDB執行個體的執行個體ID。
        主機IP不可修改，無需配置，自動擷取。
        連接埠無需配置，自動擷取。
        資料庫名填寫PolarDB執行個體中的目標資料庫名稱。
        使用者名稱填寫目標資料庫的使用者名稱。
        口令填寫目標資料庫的密碼。
        CurrentSchema填寫目前使用者對應的Schema。
      3. 單擊測試連結按鈕。在提示測試連接成功後，單擊建立按鈕。
    4. 擷取ADAM Adapter執行個體的IP和連接埠。
      1. 登入Data Management 5.0。
      2. 在頂部功能表列中，選擇整合與開發（DTS） > 異構資料庫遷移（ADAM） > 遷移實驗室。
      3. 在ADAM SQL Adapter地區，單擊詳情。
      4. 查看ADAM Adapter執行個體的IP和連接埠。
        擷取Ip和連接埠
    5. 修改應用串連資料庫的URL。
      jdbc:polardb://172.18.100.6:8888/polardb_test
      參數樣本說明
      URL首碼jdbc:polardb://URL統一使用jdbc:polardb://作為首碼
      串連地址（IP）172.18.100.6ADAM Adapter執行個體的IP。擷取方法請參見擷取ADAM Adapter執行個體的IP和連接埠。。
      連接埠（Port）8888ADAM Adapter執行個體的連接埠。擷取方法請參見擷取ADAM Adapter執行個體的IP和連接埠。。
      資料庫名稱polardb_test串連的資料庫名稱。
      說明 使用者名稱及密碼無需修改。
    6. 查看ADAM Adapter對SQL的相容性以及SQL轉換情況。
      1. 在ADAM Adapter頁面單擊查看詳情。
        查看詳情
      2. 查看ADAM Adapter對SQL的相容性以及SQL轉換情況。
        相容性
    7. 配置自訂SQL轉換規則。
      對於ADAM Adapter不相容無法轉換的SQL，請單擊左上方自訂配置規則。自訂配置規則
      參數取值及說明
      自訂規則類型表示自訂規則轉換的規則類型。
      取值範圍：
      • 文本替換。
      • 正則替換。
      說明 如果使用正則替換，請謹慎配置正則規則，惡意的正則規則可能導致Adapter執行個體資源耗盡，目前Adapter暫不提供高可用保證。
      匹配文本填寫待匹配替換的文本或Regex。
      替換文本填寫替換的文本或Regex。
      規則生效範圍表示配置的替換規則生效的範圍。
      取值範圍：
      • 全域生效。
      • 指定SQL替換。
      不相容SQL選擇該參數僅當規則生效範圍選擇為指定SQL替換時出現。填寫替換規則生效的指定SQL。