すべてのプロダクト
Search

このプロダクト

    Data Transmission Service:SQLアダプタ

    ドキュメントセンター

    Data Transmission Service:SQLアダプタ

    最終更新日:Jan 22, 2025

    Advanced Database & Application Migration (ADAM) SQL Adapterは、PostgreSQL通信プロトコルに基づいて開発されたフォワードプロキシサービスです。 このトピックでは、SQLアダプターを使用して互換性のないSQL文を変換する方法について説明します。

    説明

    SQLアダプタは、OracleデータベースからPolarDB for OracleまたはPolarDB for PostgreSQLクラスターに移行された互換性のないSQL文を変換するために提供されます。 次のシナリオでSQLアダプターを使用できます。
    • OracleデータベースからPolarDB for OracleまたはPolarDB for PostgreSQLクラスターに移行される互換性のないSQL文をリアルタイムで変換します。
    • データ移行中に互換性のないSQL文をすべて非同期で記録します。
    • 自動変換できないSQL文を変更します。

    前提条件

    • スキーマの移行操作が完了しました。
    • アプリケーションは仮想プライベートクラウド (VPC) にデプロイされています。 SQLアダプタはインターネット経由では使用できません。
    • AliyunAdamAccessingDatabaseRoleロールが有効になっています。

    手順

    1. ADAM SQLアダプターを使用する権限を申請します。
      1. データ管理 (DMS) コンソールV5.0
      2. 上部のナビゲーションバーで、ポインタをDTSの上に移動します。 [異種データベース移行 (ADAM)] > [Migration Lab] を選択します。
      3. ADAM SQLアダプターセクションで、[適用] をクリックします。
      4. 表示されるページで、会社名、電話番号、アプリケーションの目的などのパラメーターを指定します。 次に、[送信] をクリックします。
    2. アダプタを作成します。
      1. データ管理 (DMS) コンソールV5.0
      2. 上部のナビゲーションバーで、ポインタをDTSの上に移動します。 [異種データベース移行 (ADAM)] > [Migration Lab] を選択します。
      3. ADAM SQLアダプターセクションで、[詳細] をクリックします。
      4. ADAMアダプターページで、左上隅の [アダプターの作成] をクリックします。
      5. 次の表に示すパラメーターを設定します。
        パラメーター説明
        VPCリージョンVPCがデプロイされているリージョン。 アダプターがVPCに作成されます。
        有効な値：
        • cn-hangzhou
        • cn-beijing
        VPCゾーンVPCがデプロイされているゾーン。 アダプターがVPCに作成されます。
        有効な値：
        • cn-hangzhou-b: VPCは中国 (杭州) リージョンのゾーンBにデプロイされています。
        • cn-beijing-b: VPCは中国 (北京) リージョンのゾーンBにデプロイされています。
        説明 ADAM SQLアダプタはゾーンBでのみ使用できます。
        vSwitch名VPCがデプロイされているリージョン内のゾーンに作成されたvSwitch。 使用可能なvSwitchがない場合は、VPCコンソールで作成します。 詳細については、「vSwitchの作成と管理」をご参照ください。
        ソースデータベースプロファイルソースデータベースプロファイル。 使用可能なプロファイルがない場合は、ADAMコンソールでプロファイルを作成します。 詳細については、「データベースプロファイルの管理」をご参照ください。
      6. [作成] をクリックします。
    3. ターゲットデータベースを設定します。
      1. [ADAMアダプター] ページでアダプターを見つけ、[操作] 列の [宛先データベースの設定] をクリックします。
      2. 次の表に示すパラメーターを設定します。
        パラメーター説明
        インスタンスリージョン移行先クラスターが存在するリージョン。 このパラメーターの値は変更できません。 作成するアダプタのものと同じです。
        VPCターゲットPolarDBクラスターが存在するVPC。
        インスタンス IDターゲットPolarDBクラスターのID。
        Hostname or IP Address宛先クラスターへの接続に使用されるIPアドレス。 このパラメーターの値は自動的に取得され、変更できません。
        ポート番号宛先クラスターのサービスポート番号。 このパラメーターの値は自動的に取得され、変更できません。
        データベース名PolarDBクラスター内のターゲットデータベースの名前。
        データベースアカウントターゲットデータベースのアカウント。
        データベースパスワードターゲットデータベースのパスワード。
        CurrentSchemaターゲットデータベースのスキーマ名。
      3. [Test Connectivity] をクリックします。 [接続テストの成功] メッセージが表示されたら、[作成] をクリックします。
    4. アダプタのIPアドレスとポート番号を取得します。
      1. データ管理 (DMS) コンソールV5.0
      2. 上部のナビゲーションバーで、ポインタをDTSの上に移動します。 [異種データベース移行 (ADAM)] > [Migration Lab] を選択します。
      3. ADAM SQLアダプターセクションで、[詳細] をクリックします。
      4. ADAMアダプタページで、アダプタのIPアドレスとポート番号を表示します。
    5. アプリケーションが接続されているデータベースのURLを変更します。 
      jdbc:polardb:// 172.18.100.6:8888/polardb_test
      パラメーター例説明
      URLプレフィックスjdbc:polardb://URLのプレフィックス。 PolarDBデータベースのすべてのURLの先頭にjdbc:polardb:// があります。
      IP アドレス172.18.100.6アダプタのIPアドレス。 IPアドレスの取得方法の詳細については、このトピックの「アダプタのIPアドレスとポート番号の取得」をご参照ください。
      ポート番号8888アダプタのポート番号。 ポート番号の取得方法の詳細については、このトピックの「アダプタのIPアドレスとポート番号の取得」をご参照ください。
      データベース名polardb_testアプリケーションが接続されているデータベースの名前。
      説明 データベースアカウントまたはパスワードを変更する必要はありません。
    6. アダプタのSQL互換性とSQL文の変換に関する情報を表示します。
      1. ADAMアダプターページでアダプターを見つけ、[操作] 列の [詳細] をクリックします。
      2. アダプタのSQL互換性とSQL文の変換に関する情報を表示します。
    7. SQL文変換のカスタムルールを設定します。
      ADAM SQLアダプタと互換性のないSQL文の場合は、左上隅の [ルールの作成] をクリックします。
      パラメーター説明
      Rule TypeカスタムSQL変換ルールのタイプ。
      有効な値：
      • テキストの置き換え
      • 正規表現の置き換え
      説明 正規表現の置き換えを選択した場合は、正規表現を慎重に使用する必要があります。 悪意のある正規表現は、アダプタのリソースを使い果たす可能性があります。 ADAM SQLアダプターは高可用性を保証しません。
      一致するテキスト置き換えられるテキストまたは正規表現。
      置き換え後のテキスト置き換え後のテキストまたは正規表現。
      有効範囲ルールが適用されるスコープ。
      有効な値：
      • すべてのSQL文
      • 指定されたSQL文
      互換性のないSQL文ルールが適用される指定されたSQL文。 このパラメーターは、[有効範囲] を [指定されたSQL文] に設定した場合にのみ表示されます。 ルールが適用されるSQL文を指定します。