メインコンテンツまでスキップ
に最終更新

MySQL プロトコル経由での接続

Apache Doris は MySQL ネットワーク通信プロトコルに完全に対応しています。そのため、このプロトコルに準拠したクライアントツール、可視化ツール、主要なプログラミング言語向けの MySQL ドライバーやライブラリは、Doris 専用のドライバーをインストールすることなく Doris に直接接続できます。

Doris FE はデフォルトでポート 9030 から MySQL プロトコルのサービスを提供します。このポートは query_port 設定項目に対応し、fe.conf で設定します。

主な利用シーン​

MySQL プロトコルによる接続は、用途に応じて主に次の 2 つに分けられます。

シーン主な用途推奨される方法
コマンドライン / スクリプトからのアクセス運用上の問題の調査、アドホッククエリ、自動化スクリプトMySQL CLI
アプリケーションとの連携バックエンドサービス、データ処理プログラム、ETL ジョブ対応する言語の MySQL ドライバー(Java / Go / Rust / Python / C++ など)

接続前の準備​

接続する前に、次の情報を確認してください。

項目説明例
FE_IPDoris FE ノードの IP アドレスまたはホスト名172.20.63.118
FE_QUERY_PORTFE の MySQL プロトコルサービスのポート。query_port 設定項目に対応し、fe.conf で設定します9030
USERログインアカウントroot
PASSWORDログインパスワード(デフォルトでは root アカウントのパスワードは空です)-

ポートを変更する場合は、FE ノードの query_port 設定項目を fe.conf で変更し、FE を再起動してください。

接続例​

以下に、各種 MySQL クライアントや言語別ドライバーを使用した最小限の接続例を示します。タブを切り替えて確認してください。

コマンドラインでの操作、アドホッククエリ、スクリプトからの呼び出しなどに適しています。

1. MySQL クライアントのダウンロードと展開​

MySQL 公式サイトから MySQL クライアントをダウンロードします。Doris は MySQL 5.7 以降のクライアントに対応しています。

展開後、bin/ ディレクトリに mysql コマンドラインツールがあります。

2. Doris への接続​

次のコマンドを実行して Doris に接続します。

mysql -h FE_IP -P FE_QUERY_PORT -u USER -p

Enter キーを押した後、パスワードを入力します(root アカウントにはデフォルトでパスワードがないため、そのまま Enter キーを押します)。

3. ログインの確認​

ログインに成功すると、次のメッセージが表示されます。

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 236
Server version: 5.7.99 Doris version doris-2.0.3-rc06-37d31a5

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>