すべてのプロダクト
Search

このプロダクト

    MaxCompute:DBeaver を MaxCompute に接続する

    ドキュメントセンター

    MaxCompute:DBeaver を MaxCompute に接続する

    最終更新日:Mar 27, 2026

    MaxCompute Java Database Connectivity (JDBC) ドライバーを使用して DBeaver を MaxCompute プロジェクトに接続し、使い慣れた GUI からデータのクエリ実行および管理を行います。

    本トピックは、DBeaver Community Edition 24.3.1 および MaxCompute JDBC ドライバー v3.9.0 を用いて検証済みです。

    前提条件

    開始する前に、以下の条件を満たしていることを確認してください。

    手順 1：DBeaver で MaxCompute JDBC ドライバーを設定する

    DBeaver にはデフォルトで MaxCompute ドライバーが含まれていません。SQLite の汎用ドライバーをテンプレートとして使用して、ドライバーを設定します。

    1. DBeaver を起動します。

    2. トップメニューバーで、新規作成 をクリックして、[データベースの選択] ダイアログボックスを開きます。

    3. [SQL] > [SQLite] を選択し、[次へ] をクリックして、[汎用 JDBC 接続設定] ダイアログボックスを開きます。

    4. ［Main］タブで、［Driver Settings］をクリックして、［Edit Driver 'SQLite'］ダイアログボックスを開きます。

    5. [設定] タブで、以下のフィールドを設定します。

      フィールド値
      クラス名com.aliyun.odps.jdbc.OdpsDriver
      URL テンプレートjdbc:odps:{file}

      image

    6. [ライブラリ] タブで、[ファイルの追加] をクリックし、ダウンロードした odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar ファイルを選択します。

      image

    7. ［OK］をクリックします。

    手順 2：MaxCompute プロジェクトへの接続

    1. [汎用 JDBC 接続設定] ダイアログボックスで、[メイン] タブに移動します。

    2. [接続方法] を [URL] に設定します。

    3. [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 は無効になります。

    4. [接続のテスト] をクリックします。

      ヒント：テストが 1 分以上停止した場合、エンドポイントが MaxCompute プロジェクトのリージョンと一致していること、および AccessKey ID とシークレットが正しいことをご確認ください。

      [接続テスト] ダイアログボックスに [接続済み] と表示された場合、接続が確立されます。

      P6

    手順 3：データのクエリ実行および管理

    接続後、MaxCompute プロジェクトが左側のナビゲーションツリーに表示されます。SQL エディターを使用してクエリを実行し、ナビゲーションツリーでデータを参照できます。

    DBeaver の機能に関する完全なドキュメントについては、DBeaver ウィキをご参照ください。

    テーブルの参照

    ナビゲーションツリー内の接続を展開して、MaxCompute プロジェクト内のすべてのテーブルを表示します。

    P7

    テーブルスキーマの表示

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

    P8

    SQL クエリの実行

    [SQL エディター] > [新しい SQL エディター] に移動し、クエリを入力して実行します。例：

    SELECT * FROM <your_table_name> LIMIT 10;
    p9

    別の方法として、テーブルを右クリックし、[プロジェクトを表示] を選択し、[データ] タブに移動してテーブルデータを直接参照します。

    p10
    SQL クエリがスキーマ関連のエラーで失敗する場合は、まずプロジェクトに対してスキーマ機能を有効化してください。

    次のステップ