CData MySQL コネクタで Apache Doris に接続する方法



Apache Doris は、高速なクエリ性能で知られる MPP ベースのリアルタイムデータウェアハウスです。大規模なデータセットに対するクエリでも、サブ秒単位で結果を返すことができます。高い同時実行性が求められるポイントクエリと、高スループットの複雑な分析の両方に対応しています。レポート分析、アドホッククエリ、統合データウェアハウス、データレイククエリの高速化など、さまざまな用途で活用できます。Apache Doris をベースに、ユーザー行動分析、A/B テストプラットフォーム、ログ分析、ユーザープロファイル分析、EC サイトの注文分析などのアプリケーションを構築できます。

CData MySQL ドライバーの最新アップデートにより、Apache Doris インスタンスへの接続とクエリが可能になりました。この記事では、Windows マシン上の DBeaver で CData MySQL コネクタを使用して Apache Doris に接続する方法をご紹介します。

前提条件

  • 最新の WSL がインストール・構成された Windows 環境
  • Windows マシンにインストールされた DBeaver
  • SQL とデータベース接続に関する基本的な知識

Apache Doris のダウンロードとインストール

始める前に、最新バージョンの WSL(Windows Subsystem for Linux)がインストールされていることを確認してください。Apache Doris のダウンロードとインストールの詳細な手順は、公式ドキュメントをご参照ください: Apache Doris Quick Start Guide。ガイドに記載されている手順に従って、Apache Doris インスタンスを起動してください。

Apache Doris で互換性のあるユーザーを作成する

CData ドライバーとの互換性を確保するために、適切な権限を持つユーザーを Apache Doris に作成する必要があります。Doris クライアント(例:Doris に含まれる mysql-client)で以下の SQL コマンドを実行してください:

  1. MySQL クライアントを使用して Doris に接続する
    mysql -h 127.0.0.1 -P 9030 -u root
  2. データベースとユーザーを作成する
    CREATE DATABASE DORISTEST;
    		USE DORISTEST;
    		CREATE USER testuser@'%' identified by 'YourPasswordHere';
    		GRANT ALL ON DORISTEST.* TO 'testuser'@'%';
  3. Doris データベースにテーブルを作成してデータを挿入する
    create table myTestTable (k1 TINYINT,k2 DECIMAL(10, 2) DEFAULT "10.05",k3 CHAR(10) COMMENT "string column",k4 INT NOT NULL DEFAULT "1" COMMENT "int column") COMMENT "my first table" DISTRIBUTED BY
    HASH(k1) BUCKETS 1 PROPERTIES ("replication_num" = "1");
    
    insert into myTestTable values (1,0.14,'a1',20),(2,1.04,'b2',21),(3,3.14,'c3',22),(4,4.35,'d4',23);

CData MySQL JDBC Driver のダウンロードとインストール

まず、CData の Web サイトから MySQL JDBC Driver をダウンロードしてインストールしてください: https://jp.cdata.com/drivers/mysql/download/jdbc/

必要な連絡先情報を入力してください。

注意:ライセンス版のインストーラーをダウンロードする場合は、会社のメールアドレスとプロダクトキーを使用してください。

ドライバーをインストールする:

  • インストーラーを実行し、インストールウィザードに従ってください
  • インストールディレクトリをメモしておいてください(通常は C:\Program Files\CData\CData JDBC Driver for MySQL\lib
  • JAR ファイルを確認してください:cdata.jdbc.mysql.jar

DBeaver でドライバーと接続を構成する

以下の手順でドライバーの .jar ファイルを追加してください:

  1. DBeaver アプリケーションを開き、Database メニューから Driver Manager オプションを選択します。New をクリックして Create New Driver フォームを開きます。
  2. Driver Name ボックスに、ドライバーのわかりやすい名前を入力します。
  3. .jar ファイルを追加するには、Libraries タブで Add File をクリックします。インストールディレクトリの lib サブフォルダにある cdata.jdbc.mysql.jar ファイルを選択してください。(注意:.lic ファイルは .jar ファイルと同じフォルダに配置する必要があります。
  4. Find Class をクリックし、リストから「cdata.jdbc.mysql.MySQLDriver」を選択します。
  5. URL Template フィールドに jdbc:cdata:mysql: と入力します。

DBeaver で Doris に接続する

注意:Apache Doris を WSL で実行している場合、Windows ホストから接続するには WSL の IP アドレスを使用する必要があります。または、localhost フォワーディング(WSL 2 の機能)を有効にすることで、localhost 経由で接続することもできます。

  1. DBeaver で新しい接続を作成する
    • New Database Connection をクリックします
    • カスタムの CData MySQL for Doris ドライバーを選択します
    • 接続を構成します:
      • Server:WSL の IP アドレス(例:172.X.X.X)を入力するか、localhost フォワーディングを有効にしている場合は localhost を入力します
      • Port9030
      • DatabaseDORISTEST
      • Usernametestuser
      • PasswordYourPasswordHere
  2. 接続をテストする
    • Test Connection をクリックします
    • 接続に関する問題があれば解決してください
    • 接続を保存します

接続の確認

接続が完了したら、すべてが正常に動作していることを確認しましょう:

  1. データベースに移動する
    • DBeaver で接続を展開します
    • DORISTEST データベースに移動します
    • テーブルとスキーマを確認します

CData MySQL JDBC ドライバーを使用して Apache Doris データベースへの接続が完了しました!

CData で Apache Doris への接続をシンプルに

CData MySQL コネクタは、Apache Doris データへのシームレスな接続を実現します。CData MySQL コネクタを試すには、Apache Doris 連携ページにアクセスして、30 日間の無料トライアルをお試しください!