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

MaxCompute:SQL Workbench/J から MaxCompute への接続

最終更新日:Jun 23, 2026

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

背景情報

SQL Workbench/J は、データベース管理システム (DBMS) から独立して動作する、無料のクロスプラットフォーム SQL クエリツールです。Java で記述されており、Java 実行環境を提供するオペレーティングシステムであれば、どのシステムでも実行できます。

前提条件

先に進む前に、以下の要件を満たしていることを確認してください。

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

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

  • MaxCompute プロジェクトへのアクセス権限を持つ AccessKey ID と AccessKey Secret を取得済みであること。

    AccessKey ID と AccessKey Secret は、AccessKey の管理ページから取得できます。

  • 完全な依存関係 JAR パッケージ jar-with-dependencies を含む MaxCompute JDBC ドライバー (バージョン 3.0.1 以降) がダウンロード済みであること。

    このトピックの例では、MaxCompute JDBC ドライバーのバージョン 3.2.9 を使用します。

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

    このトピックの例では、2020年8月22日にリリースされた SQL Workbench/J Build 127 を使用します。

  • Java 8 以降のバージョンをインストール済みであること。

操作手順

次の手順に従って、SQL Workbench/J を MaxCompute に接続します。

  1. ステップ1:ドライバーの作成

    MaxCompute JDBC ドライバーの JAR ファイルを SQL Workbench/J にアップロードし、SQL Workbench/J がこのドライバーを介して MaxCompute プロジェクトにアクセスできるようにします。

  2. ステップ2:SQL Workbench/J から MaxCompute への接続

    接続パラメーターを構成して、SQL Workbench/J を MaxCompute プロジェクトにリンクします。

  3. ステップ3:SQL Workbench/J を使用した MaxCompute プロジェクトの管理

    確立されたデータ接続を SQL Workbench/J で使用して、MaxCompute プロジェクトを管理します。

ステップ1:ドライバーの作成

  1. SQL Workbench を起動し、SQL Workbench インターフェイスを開きます。

    SQL Workbench インターフェイスが開くと、[接続プロファイルの選択] ダイアログボックスが自動的に表示されます。

  2. [接続プロファイルの選択] ダイアログボックスの左下隅にある [ドライバーの管理] をクリックします。新しいドライバーを作成し、カスタムのドライバー名を入力して、MaxCompute JDBC ドライバーの JAR ファイルをアップロードした後、[OK] をクリックしてドライバーの構成を完了します。

    MaxCompute JDBC ドライバーをアップロードすると、[Classname] フィールドは自動的に com.aliyun.odps.jdbc.OdpsDriver に設定されます。

ステップ2:SQL Workbench/J から MaxCompute への接続

  1. [接続プロファイルの選択] ダイアログボックスの右側にあるプロファイル構成ペインで、接続名 (例:MCtoSQL) を入力し、次の表に示すパラメーターを構成します。

    パラメーター

    説明

    ドライバー

    ステップ1 で作成した MaxCompute プロジェクトに接続するためのドライバー、つまり MaxCompute ドライバー (com.aliyun.odps.jdbc.OdpsDriver) です。

    [URL]

    MaxCompute プロジェクトに接続するための URL。フォーマットは jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}] を使用します。構成時には <> 記号を削除してください。パラメーターは以下の通りです:

    • <MaxCompute_endpoint>:必須。MaxCompute プロジェクトが配置されているリージョンのエンドポイント。

      エンドポイントのリストについては、「エンドポイント」をご参照ください。

    • <MaxCompute_project_name>:必須。ターゲットの MaxCompute プロジェクトの名前。

      これはワークスペースではなく、ご利用の MaxCompute プロジェクトの名前です。MaxCompute コンソールにログインし、左上隅でリージョンを切り替え、プロジェクト管理 ページでプロジェクト名を確認できます。

    • interactiveMode:オプション。クエリアクセラレーション機能を有効にするかどうかを指定します。

      クエリアクセラレーションを有効にするには、URL の末尾に &interactiveMode=true を追加します。詳細については、「クエリアクセラレーション」をご参照ください。

    [ユーザー名]

    ターゲットの MaxCompute プロジェクトへのアクセス権限を持つ AccessKey ID。

    AccessKey ID は、AccessKey の管理ページから取得できます。

    パスワード

    AccessKey ID に対応する AccessKey Secret。

    AccessKey Secret は、AccessKey の管理ページから取得できます。

  2. [テスト] をクリックします。接続に成功したら、[OK] をクリックして、SQL Workbench/J と MaxCompute 間のデータ接続を作成します。

ステップ3:SQL Workbench/J を使用した MaxCompute プロジェクトの管理

SQL Workbench/J インターフェイスで、新しく作成したデータ接続を使用して、MaxCompute SQL コマンドを実行し、MaxCompute プロジェクトを管理します。

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

    データ接続を作成すると、SQL Workbench/J は自動的に SQL 実行インターフェイスに切り替わります。コマンド show tables; を実行して、すべてのテーブルを一覧表示します。

    Statement エリアに SQL ステートメントを入力し、ツールバーの [実行] (▶) ボタンをクリックして実行します。結果は、下の [結果] タブに表示されます。

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

    データ接続を作成すると、SQL Workbench/J は自動的に SQL 実行インターフェイスに切り替わります。コマンド desc <table_name>; を実行して、テーブルスキーマを表示します。

  • テーブルデータの表示

    データ接続を作成すると、SQL Workbench/J は自動的に SQL 実行インターフェイスに切り替わります。SELECT クエリを実行して、テーブルデータを表示します。

    Statement エリアに SQL ステートメント (例:select * from bank_data_pt where age=35;) を入力し、ツールバーの [実行] ボタンをクリックします。クエリ結果は、下の [結果] タブにテーブル形式で表示されます。