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

MaxCompute:DBeaverをMaxComputeに接続する

最終更新日:Dec 06, 2024

MaxComputeでは、データベース管理ツールDBeaverを使用してMaxComputeプロジェクトにアクセスし、データを管理できます。 このトピックでは、MaxCompute Java Database Connectivity (JDBC) ドライバーを使用してDBeaverをMaxComputeプロジェクトに接続し、DBeaverを使用してデータを管理する方法について説明します。

背景情報

DBeaverは、データベースを使用する必要がある開発者、データベース管理者、アナリスト、および担当者向けのマルチプラットフォームデータベース管理ツールです。 ユーザーはDBeaverを無料で使用できます。 DBeaverの詳細については、「DBeaver」をご参照ください。

前提条件

  • MaxComputeプロジェクトが作成されます。

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

  • MaxComputeプロジェクトへのアクセスに使用されるAlibaba CloudアカウントのAccessKeyペアが取得されます。

    MaxComputeコンソールの右上隅にあるプロファイル画像をクリックし、AccessKey管理を選択してAccessKeyペアを取得します。

  • MaxCompute JDBCドライバーV3.2.8以降のJARパッケージがダウンロードされます。 このパッケージには、jar-with-dependenciesパッケージが含まれています。

    このトピックでは、MaxCompute JDBCドライバーV3.2.9を使用します。

  • DBeaverがダウンロードされ、インストールされます。

    DBeaverのインストール方法の詳細については、「インストール」をご参照ください。

    このトピックでは、DBeaver Community Edition 21.1.3を使用します。

ステップ1: DBeaverをMaxComputeに接続する

  1. DBeaverを開始します。

  2. メインメニューバーで、Newアイコンをクリックします。 [データベースの選択] ダイアログボックスで、[SQL] > [SQLite] を選択し、[次へ] をクリックします。

    Select your database dialog box

  3. [Generic JDBC接続設定] ダイアログボックスの [メイン] タブで、[ドライバ設定の編集] をクリックします。 表示されるダイアログボックスで、[ライブラリ] タブをクリックし、[ファイルの追加] をクリックして、MaxCompute JDBCドライバのJARパッケージをデータソースのライブラリに関連付けます。 このトピックでは、ドライバーパッケージのodps-jdbc-3.2.9-jar-with-dependencies.jarを使用します。

    Edit Driver Settings

  4. [Generic JDBC接続設定] ダイアログボックスの [メイン] タブで、[ドライバ設定の編集] を再度クリックします。 表示されるダイアログボックスで、[設定] タブをクリックし、[クラス名] フィールドにcom.aliyun.odps.jdbc.OdpsDriverと入力し、[URLテンプレート] フィールドにjdbc:odps:{file} と入力し、[OK] をクリックします。

    データソース設定を変更して保存すると、データソースはMaxCompute JDBCドライバーをサポートします。 Enter the driver class name

  5. [Generic JDBC接続の設定] ダイアログボックスの [メイン] タブで、MaxComputeプロジェクトへの接続に使用するURL (Uniform Resource Locator) を [パス] フィールドに入力します。

    Path

    パラメーター

    説明

    パス

    MaxComputeプロジェクトへの接続に使用されるURL。 形式は <MaxCompute_endpoint>?project=<MaxCompute_project_name>&accessId=<access_id>&accessKey=<access_key>[&interactiveMode={true | false}] です。 このパラメーターを設定するときに、角括弧 (<>) を削除します。 パラメーター:

    • <MaxCompute_endpoint>: 必須です。 MaxComputeのエンドポイント。 MaxComputeプロジェクトが存在するリージョンに基づいて、このパラメーターを設定します。

      異なるリージョンのMaxComputeのエンドポイントの詳細については、「エンドポイント」をご参照ください。

    • <MaxCompute_project_name>: 必須です。 MaxCompute プロジェクトの名前を設定します。

      このパラメーターには、MaxComputeプロジェクトが対応するDataWorksワークスペースではなく、MaxComputeプロジェクトの名前を指定します。

      MaxComputeコンソールで、上部のナビゲーションバーでMaxComputeプロジェクトが存在するリージョンを選択し、[プロジェクト管理] タブでMaxComputeプロジェクトの名前を表示します。

    • access_id: 必須です。 MaxComputeプロジェクトへのアクセスに使用されるAccessKey ID。

      MaxComputeコンソールの右上隅にあるプロファイル画像をクリックし、AccessKey管理を選択してAccessKey IDを取得します。

    • access_key: 必須です。 AccessKey IDに対応するAccessKeyシークレット。

      MaxComputeコンソールの右上隅にあるプロファイル画像をクリックし、AccessKey Managementを選択してAccessKeyシークレットを取得できます。

    • interactiveMode: オプション。 このパラメーターは、MaxCompute Query Acceleration (MCQA) 機能を有効にするかどうかを指定します。

      MCQA機能を有効にする場合は、URLの末尾に &interactiveMode=trueを追加します。 MCQA機能の詳細については、「クエリの高速化」をご参照ください。

  6. [接続のテスト] をクリックします。 次の図に示すメッセージが表示されたら、[OK] および [完了] をクリックします。

    Test Connection

ステップ2: DBeaverを使用してデータを照会および分析する

DBeaverをMaxComputeに接続した後、DBeaverの左側のナビゲーションツリーで確立されたMaxCompute接続を表示し、SQL機能を使用してMaxComputeプロジェクトを管理できます。 ビジネス要件に基づいて、次の操作を実行できます。 これらの操作の詳細については、「DBeaverヘルプ情報」をご参照ください。

  • 既存のすべてのテーブルの照会

    確立されたMaxCompute接続の下にリストされているすべての既存のテーブルの情報を照会できます。

    Query all existing tables

  • クエリテーブル構造

    確立されたMaxCompute接続の下でクエリするテーブルを右クリックし、[テーブルの表示] を選択してテーブル構造をクエリできます。

    Query table schema

  • テーブルデータの照会

    確立されたMaxCompute接続の下でクエリするテーブルを右クリックし、[テーブルの表示] を選択します。 表示されるタブで、[データ] タブをクリックして、テーブルのデータを照会します。

    Query table data