すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:DBeaver と MaxCompute の接続

最終更新日:Jun 22, 2026

DBeaver データベース管理ツールを使用して MaxCompute プロジェクトにアクセスし、データを管理します。このトピックでは、MaxCompute JDBC ドライバーを使用してプロジェクトに接続する方法について説明します。

背景情報

DBeaver は、開発者、データベース管理者、アナリストなど、データベースを扱うすべての人を対象とした、無料のマルチプラットフォームデータベースツールです。詳細については、「DBeaver」をご参照ください。

前提条件

開始する前に、以下が準備できていることを確認してください。

  • MaxCompute プロジェクトを作成済みであること。

    詳細については、「MaxCompute プロジェクトの作成」をご参照ください。

  • MaxCompute プロジェクトにアクセスする権限のあるアクセスキーペア (AccessKey ID と AccessKey Secret) があること。

    詳細については、「アクセスキーペアの作成」をご参照ください。

  • すべての依存関係を含む jar-with-dependencies JAR パッケージをダウンロード済みであること。

    odps-jdbc-3.9.0-jar-with-dependencies.jar をクリックしてダウンロードするか、GitHub または Maven リポジトリ から最新バージョンの MaxCompute JAR パッケージを入手できます。このトピックの例では、MaxCompute JDBC ドライバーの v3.9.0 を使用します。

  • DBeaver をダウンロードしてインストール済みであること。

    インストールに関する詳細については、「インストール」をご参照ください。このトピックの例では、DBeaver Community Edition 24.3.1 を使用します。

ステップ1:DBeaver と MaxCompute の接続

  1. DBeaver を起動します。

  2. 接続するデータベースの種類を選択します。

    トップメニューバーで、新建 新規接続アイコンをクリックします。[データベースの選択] ダイアログボックスで SQL > SQLite を選択し、次のステップ をクリックすると、[汎用 JDBC 接続設定] ダイアログボックスが開きます。

  3. ドライバー設定を編集します。

    1. [Generic JDBC Connection Settings] ダイアログボックスの [Main] タブで、[Edit Driver Settings] をクリックします。

    2. クラス名と URL テンプレートを設定します。

      [Edit Driver 'Generic'] ダイアログボックスの [設定] タブで、[Class Name] を com.aliyun.odps.jdbc.OdpsDriver に、[URL Template] を [jdbc:odps:{file}] に設定します。

    3. JDBC ドライバー JAR パッケージを追加します。

      [Edit Driver ['Generic']] ダイアログボックスの [Libraries] タブで、[Add File] をクリックして、MaxCompute JDBC ドライバーの JAR パッケージ odps-jdbc-3.9.0-jar-with-dependencies.jar をドライバーライブラリに追加します。

    4. [決定] をクリックします。

  4. JDBC URL を入力します。

    [Generic JDBC Connection Settings] ダイアログボックスの [Main] タブで、[JDBC URL] を設定します。

    パラメーター

    説明

    [接続モード]

    [URL] を選択します。

    JDBC URL

    MaxCompute プロジェクトに接続するための URL。

    • 例: jdbc:odps:https://service.cn-hangzhou.maxcompute.aliyun.com/api?project=test&accessId=xx&accessKey=xx

    • 形式: jdbc:odps:<maxCompute_endpoint>?project=<maxCompute_project_name>&accessId=<accessId>&accessKey=<accessKey>[&interactiveMode={true|false}]。URL に山括弧 (<>) を含めないでください。

      • <maxCompute_endpoint>:必須。MaxCompute プロジェクトがあるリージョンのエンドポイント。詳細については、「エンドポイント」をご参照ください。

      • <maxCompute_project_name>:必須。接続する MaxCompute プロジェクトの名前。

      • accessId:必須。MaxCompute プロジェクトにアクセスする権限のある AccessKey ID。AccessKey ID は、[AccessKey の管理] ページから取得できます。

      • accessKey:必須。AccessKey ID に対応する AccessKey Secret。

      • interactiveMode:任意。クエリ高速化機能を有効にするかどうかを指定します。

        クエリ高速化を有効にするには、URL に &interactiveMode=true を追加します。詳細については、「クエリ高速化」をご参照ください。

  5. [接続をテスト] をクリックします。接続に成功すると、[Connection Test] ダイアログボックスに [Connected] ステータスが表示されます。[OK] をクリックしてこのダイアログボックスを閉じ、[Finish] をクリックして設定を完了します。

ステップ2:データのクエリと分析

DBeaver を MaxCompute に接続すると、新しい接続が左側のナビゲーションペインに表示されます。SQL を使用して MaxCompute プロジェクトを管理できます。次のセクションでは、一般的な操作について説明します。機能の完全なリストについては、DBeaver のドキュメント をご参照ください。

  • すべてのテーブルの表示

    作成した MaxCompute 接続にあるすべてのテーブルに関する情報を表示できます。

    左側のデータベースナビゲーターペインで、MaxCompute 接続ノードを展開し、データベース名を展開し、[default] を展開してから [Tables] を展開すると、テーブルのリストが表示されます。上部の検索ボックスにキーワードを入力して、テーブルを名前で絞り込むこともできます。

  • テーブルスキーマの表示

    MaxCompute 接続で、テーブルを右クリックし、[View Table] を選択します。

    たとえば、sale_detail テーブルには、shop_name (STRING)、customer_id (STRING)、total_price (DOUBLE)、sale_date (STRING)、region (STRING) の 5 つの列があります。

  • テーブルデータの表示

    • MaxCompute 接続で、SQL Editor > New SQL Editor をクリックします。エディターで、対象テーブルの SQL クエリを入力して実行し、データを表示します。

      たとえば、クエリ SELECT * FROM pyodps_ml_100k_lens; を入力します。

    • プロジェクトでスキーマ構文スイッチが有効になっていない場合は、MaxCompute 接続で対象のテーブルを右クリックし、[View Table] を選択してから [Data] タブをクリックしてデータを表示することもできます。詳細については、「スキーマ構文スイッチ」をご参照ください。