DBeaver データベース管理ツールを使用して MaxCompute プロジェクトにアクセスし、データを管理します。このトピックでは、MaxCompute JDBC ドライバーを使用してプロジェクトに接続する方法について説明します。
背景情報
DBeaver は、開発者、データベース管理者、アナリストなど、データベースを扱うすべての人々のための、無料のマルチプラットフォームデータベースツールです。詳細については、「DBeaver」をご参照ください。
前提条件
開始する前に、次のものが揃っていることを確認してください。
MaxCompute プロジェクトが作成済みであること。
詳細については、「MaxCompute プロジェクトの作成」をご参照ください。
MaxCompute プロジェクトにアクセスする権限を持つ AccessKey ペア (AccessKey ID と AccessKey Secret) があること。
詳細については、「AccessKey ペアの作成」をご参照ください。
すべての依存関係を含む 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 を起動します。
接続するデータベースの種類を選択します。
上部メニューで、
[新規接続] アイコンをクリックします。[Select your database] ダイアログボックスで を選択し、次へ をクリックします。[Generic JDBC Connection Settings] ダイアログボックスが開きます。ドライバー設定を編集します。
[Generic JDBC Connection Settings] ダイアログボックスの [Main] タブで、[Edit Driver Settings] をクリックします。
クラス名と URL テンプレートを設定します。
[Edit Driver 'SQLite'] ダイアログボックスの 設定項目 タブで、[Class Name] を com.aliyun.odps.jdbc.OdpsDriver に、[URL Template] を [jdbc:odps:] に設定します。
JDBC ドライバーの JAR パッケージを追加します。
[Edit Driver ['SQLite'] ダイアログボックスの [Libraries] タブで [Add File] をクリックし、MaxCompute JDBC ドライバーの JAR パッケージ
odps-jdbc-3.9.0-jar-with-dependencies.jarをドライバーライブラリに追加します。OK をクリックします。
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を追加します。詳細については、「クエリ高速化」をご参照ください。
[Test Connection] をクリックします。[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] タブをクリックしてデータを表示することもできます。詳細については、「スキーマ構文スイッチ」をご参照ください。
よくある質問
DBeaver の使用時に「Internal error connecting to SQLite」というエラーが表示される場合や、MaxCompute への接続に失敗する場合はどうすればよいですか？
シナリオ 1：「Internal error connecting to SQLite」エラーが表示される場合
このエラーは通常、DBeaver のクライアント設定の問題またはドライバーの欠落が原因であり、MaxCompute サービスの問題ではありません。この問題を解決するには、次の手順を実行してください。
DBeaver クライアントに sqlite-jdbc ドライバーがインストールされているか確認してください。ドライバーがない場合は、ダウンロードしてインストールしてください。
このトピックの「ステップ 1：DBeaver の MaxCompute への接続」セクションの手順に従って、ドライバーのクラス名、URL テンプレート、および JAR パッケージの設定を確認してください。
シナリオ 2：特定のエラーメッセージが表示されない場合や、他の互換性エラーで DBeaver が MaxCompute に接続できない場合
接続の失敗は、DBeaver のバージョンの非互換性が原因である可能性があります。このトピックで推奨されているバージョンである DBeaver Community Edition 24.3.1 を使用することを推奨します。26.x のような新しすぎるバージョンや、互換性が検証されていないバージョンの使用は避けてください。