MaxCompute Java Database Connectivity (JDBC) ドライバーを使用して DBeaver を MaxCompute プロジェクトに接続し、使い慣れた GUI からデータのクエリ実行および管理を行います。
本トピックは、DBeaver Community Edition 24.3.1 および MaxCompute JDBC ドライバー v3.9.0 を用いて検証済みです。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
MaxCompute プロジェクト。詳細については、「MaxCompute プロジェクトの作成」をご参照ください。
Alibaba Cloud アカウントの AccessKey ペア。詳細については、「AccessKey ペアの作成」をご参照ください。
MaxCompute JDBC ドライバーの JAR ファイル(
odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar)。以下のいずれかのソースからダウンロードしてください。GitHub リリース(最新バージョン)
Maven リポジトリ(最新バージョン)
DBeaver Community Edition のインストール。公式サイト dbeaver.io からダウンロードしてください。
手順 1:DBeaver で MaxCompute JDBC ドライバーを設定する
DBeaver にはデフォルトで MaxCompute ドライバーが含まれていません。SQLite の汎用ドライバーをテンプレートとして使用して、ドライバーを設定します。
DBeaver を起動します。
トップメニューバーで、
をクリックして、[データベースの選択] ダイアログボックスを開きます。[SQL] > [SQLite] を選択し、[次へ] をクリックして、[汎用 JDBC 接続設定] ダイアログボックスを開きます。
[Main]タブで、[Driver Settings]をクリックして、[Edit Driver 'SQLite']ダイアログボックスを開きます。
[設定] タブで、以下のフィールドを設定します。
フィールド 値 クラス名 com.aliyun.odps.jdbc.OdpsDriverURL テンプレート jdbc:odps:{file}
[ライブラリ] タブで、[ファイルの追加] をクリックし、ダウンロードした
odps-jdbc-3.9.0-rc4-jar-with-dependencies.jarファイルを選択します。
[OK]をクリックします。
手順 2:MaxCompute プロジェクトへの接続
[汎用 JDBC 接続設定] ダイアログボックスで、[メイン] タブに移動します。
[接続方法] を [URL] に設定します。
[JDBC URL] フィールドに、MaxCompute プロジェクトの接続 URL を入力します。URL フォーマット:
jdbc:odps:<maxCompute_endpoint>?project=<maxCompute_project_name>&accessId=<access_id>&accessKey=<access_key>[&interactiveMode={true|false}]例:
jdbc:odps:https://service.cn-hangzhou.maxcompute.aliyun.com/api?project=test&accessId=xx&accessKey=xxプレースホルダーを実際の値に置き換えてください。
プレースホルダー 必須 説明 <maxCompute_endpoint>はい ご利用の MaxCompute プロジェクトが配置されているリージョンのエンドポイント <maxCompute_project_name>はい 接続対象の MaxCompute プロジェクト名 <access_id>はい AccessKey ID。詳細については、AccessKey 管理ページをご参照ください。 <access_key>はい AccessKey ID に対応する AccessKey Secret interactiveModeいいえ を有効にする場合は trueMaxCompute クエリアクセラレーション (MCQA) を指定します。このパラメーターを省略すると MCQA は無効になります。[接続のテスト] をクリックします。
ヒント:テストが 1 分以上停止した場合、エンドポイントが MaxCompute プロジェクトのリージョンと一致していること、および AccessKey ID とシークレットが正しいことをご確認ください。
[接続テスト] ダイアログボックスに [接続済み] と表示された場合、接続が確立されます。

手順 3:データのクエリ実行および管理
接続後、MaxCompute プロジェクトが左側のナビゲーションツリーに表示されます。SQL エディターを使用してクエリを実行し、ナビゲーションツリーでデータを参照できます。
DBeaver の機能に関する完全なドキュメントについては、DBeaver ウィキをご参照ください。
テーブルの参照
ナビゲーションツリー内の接続を展開して、MaxCompute プロジェクト内のすべてのテーブルを表示します。

テーブルスキーマの表示
テーブルを右クリックし、[テーブルの表示] を選択して、そのスキーマを表示します。

SQL クエリの実行
[SQL エディター] > [新しい SQL エディター] に移動し、クエリを入力して実行します。例:
SELECT * FROM <your_table_name> LIMIT 10;
別の方法として、テーブルを右クリックし、[プロジェクトを表示] を選択し、[データ] タブに移動してテーブルデータを直接参照します。

SQL クエリがスキーマ関連のエラーで失敗する場合は、まずプロジェクトに対してスキーマ機能を有効化してください。
次のステップ
DBeaver ドキュメントを参照して、データのエクスポート、インポート、および可視化機能について学習してください。
インタラクティブなクエリのパフォーマンスを高速化するには、JDBC URL に
&interactiveMode=trueを追加して、MaxCompute クエリアクセラレーション (MCQA) を有効化します。