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 に接続します。
-
MaxCompute JDBC ドライバーの JAR ファイルを SQL Workbench/J にアップロードし、SQL Workbench/J がこのドライバーを介して MaxCompute プロジェクトにアクセスできるようにします。
-
ステップ2:SQL Workbench/J から MaxCompute への接続
接続パラメーターを構成して、SQL Workbench/J を MaxCompute プロジェクトにリンクします。
-
ステップ3:SQL Workbench/J を使用した MaxCompute プロジェクトの管理
確立されたデータ接続を SQL Workbench/J で使用して、MaxCompute プロジェクトを管理します。
ステップ1:ドライバーの作成
-
SQL Workbench を起動し、SQL Workbench インターフェイスを開きます。
SQL Workbench インターフェイスが開くと、[接続プロファイルの選択] ダイアログボックスが自動的に表示されます。
-
[接続プロファイルの選択] ダイアログボックスの左下隅にある [ドライバーの管理] をクリックします。新しいドライバーを作成し、カスタムのドライバー名を入力して、MaxCompute JDBC ドライバーの JAR ファイルをアップロードした後、[OK] をクリックしてドライバーの構成を完了します。
MaxCompute JDBC ドライバーをアップロードすると、[Classname] フィールドは自動的に com.aliyun.odps.jdbc.OdpsDriver に設定されます。
ステップ2:SQL Workbench/J から MaxCompute への接続
-
[接続プロファイルの選択] ダイアログボックスの右側にあるプロファイル構成ペインで、接続名 (例: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 の管理ページから取得できます。
-
-
[テスト] をクリックします。接続に成功したら、[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;) を入力し、ツールバーの [実行] ボタンをクリックします。クエリ結果は、下の [結果] タブにテーブル形式で表示されます。