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 の接続
DBeaver を起動します。
接続するデータベースの種類を選択します。
トップメニューバーで、
新規接続アイコンをクリックします。[データベースの選択] ダイアログボックスで を選択し、次のステップ をクリックすると、[汎用 JDBC 接続設定] ダイアログボックスが開きます。ドライバー設定を編集します。
[Generic JDBC Connection Settings] ダイアログボックスの [Main] タブで、[Edit Driver Settings] をクリックします。
クラス名と URL テンプレートを設定します。
[Edit Driver 'Generic'] ダイアログボックスの [設定] タブで、[Class Name] を com.aliyun.odps.jdbc.OdpsDriver に、[URL Template] を [jdbc:odps:{file}] に設定します。
JDBC ドライバー JAR パッケージを追加します。
[Edit Driver ['Generic']] ダイアログボックスの [Libraries] タブで、[Add File] をクリックして、MaxCompute JDBC ドライバーの JAR パッケージ
odps-jdbc-3.9.0-jar-with-dependencies.jarをドライバーライブラリに追加します。[決定] をクリックします。
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を追加します。詳細については、「クエリ高速化」をご参照ください。
[接続をテスト] をクリックします。接続に成功すると、[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 クエリを入力して実行し、データを表示します。
たとえば、クエリ
SELECT * FROM pyodps_ml_100k_lens;を入力します。プロジェクトでスキーマ構文スイッチが有効になっていない場合は、MaxCompute 接続で対象のテーブルを右クリックし、[View Table] を選択してから [Data] タブをクリックしてデータを表示することもできます。詳細については、「スキーマ構文スイッチ」をご参照ください。