このトピックでは、MaxCompute JDBC ドライバーを使用して DataGrip を MaxCompute プロジェクトに接続する方法について説明します。
背景情報
DataGrip は、開発者向けのデータベース管理環境であり、データベースのクエリ、作成、管理を簡素化します。ローカル、サーバーベース、クラウドのデータベースをサポートしています。詳細については、「DataGrip」をご参照ください。
前提条件
次の要件を満たしていることを確認してください。
-
MaxCompute プロジェクトが作成済みであること。
詳細については、「MaxCompute プロジェクトの作成」をご参照ください。
-
MaxCompute プロジェクトにアクセスする権限を持つ AccessKey ID と AccessKey Secret があること。
AccessKey 管理ページに移動して、AccessKey ID と AccessKey Secret を取得します。
-
すべての依存関係を含む MaxCompute JDBC ドライバーの JAR パッケージ (
jar-with-dependencies) をダウンロード済みであること。odps-jdbc-3.9.0.jar をクリックしてドライバーをダウンロードするか、GitHub または Maven リポジトリから最新バージョンを取得します。このトピックでは、MaxCompute JDBC ドライバー v3.9.0 を例として使用します。
-
DataGrip をダウンロードしてインストール済みであること。
詳細については、「DataGrip のインストール」をご参照ください。
このトピックでは、DataGrip 2024.3.3 を例として使用します。
操作手順
DataGrip を MaxCompute に接続するには、次の手順に従います。
-
MaxCompute JDBC ドライバーを DataGrip に追加し、MaxCompute プロジェクトの接続パラメーターを設定します。
-
ステップ 2: DataGrip を使用した MaxCompute プロジェクトの管理
DataGrip で作成した接続を使用して、MaxCompute プロジェクトを管理します。
ステップ 1: ドライバーとデータソースの設定
-
DataGrip を起動します。
-
メインメニュー
から、 を選択します。 -
[New Project] ダイアログボックスで、プロジェクト名 (例: MaxCompute_test) を入力します。
-
新しいプロジェクトウィンドウの左上隅にある 新しい
> Driver をクリックします。 -
Data Sources and Drivers ダイアログボックスで、Drivers タブに移動します。
アイコンをクリックし、User Driver を選択します。ドライバーに名前を付けます (例: MaxCompute)。 -
Driver Files セクションで、
アイコンをクリックし、Custom JARs を選択します。ローカルマシンから、ダウンロードした MaxCompute JDBC ドライバーの JAR ファイル (例: odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar) を選択します。パラメーター
説明
Name
新しいドライバーの名前 (例: MaxCompute)。
Class
MaxCompute JDBC ドライバーの JAR ファイルをアップロードした後、ドロップダウンリストから com.aliyun.odps.jdbc.OdpsDriver を選択します。
-
データソース タブに移動します。
アイコンをクリックし、作成したドライバー (例: MaxCompute) を選択します。 -
General タブで、次のパラメーターを設定します。
パラメーター
説明
名前
デフォルトではドライバー名が使用されます。カスタム名を指定することもできます。
Authentication
User & Password を選択します。
User
MaxCompute プロジェクトにアクセスする権限を持つ AccessKey ID。
AccessKey 管理ページに移動して、AccessKey ID を取得できます。
Password
AccessKey ID に対応する AccessKey Secret。
URL
MaxCompute プロジェクトの接続 URL。フォーマットは
jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}]です。URL に山括弧 (<>) は含めないでください。パラメーターの説明は次のとおりです。-
<MaxCompute_endpoint>：必須。MaxCompute プロジェクトが配置されているリージョンのエンドポイント。
エンドポイントのリストについては、「エンドポイント」をご参照ください。
-
<MaxCompute_project_name>：必須。ターゲットの MaxCompute プロジェクトの名前。
これはワークスペースではなく、MaxCompute プロジェクトの名前です。MaxCompute コンソールにログインし、左上隅でリージョンを切り替え、プロジェクト管理
-
interactiveMode：オプション。クエリ高速化機能を有効にするかどうかを指定します。
クエリ高速化を有効にするには、URL に
&interactiveMode=trueを追加します。詳細については、「クエリ高速化」をご参照ください。
-
useProjectTimeZone：オプション。このパラメーターは、DataGrip と MaxCompute サーバーインスタンス間のタイムゾーンを同期します。同じタイムゾーンを使用するには、URL に
&useProjectTimeZone=trueを追加します。
-
-
Test Connection をクリックして設定を検証します。
-
決定 をクリックして設定を保存します。
ステップ 2: プロジェクトの管理
接続を作成すると、左側のパネルに新しい MaxCompute 接続が表示されます。SQL スクリプトを作成・実行して、MaxCompute プロジェクトを管理できます。詳細については、「DataGrip ヘルプ」をご参照ください。
-
すべてのテーブルの表示
MaxCompute 接続配下のすべてのテーブルに関する情報を表示できます。
左側の Database Explorer パネルで、[MaxCompute connection] > [プロジェクト名] > [default] > [tables] の順に展開し、スキーマ内のすべてのテーブルを表示します。
-
テーブルスキーマの表示
対象のテーブルを右クリックし、 を選択します。次に、右側の SQL エディターで SQL スクリプトを作成・実行して、テーブルスキーマを表示します。
たとえば、
DESC sale_detailコマンドを実行します。出力には、shop_name(STRING)、customer_id(STRING)、total_price(DOUBLE) を含むネイティブ列と、sale_date(STRING)、region(STRING) を含むパーティション列がリストされます。 -
テーブルデータの表示
対象のテーブルを右クリックし、 を選択します。次に、右側の SQL エディターで SQL スクリプトを作成・実行して、テーブルデータを表示します。
たとえば、pyodps_iris テーブルをクエリするには、
SELECT * FROM pyodps_iris;コマンドを実行します。ツールバーの緑色の三角形の実行アイコンをクリックすると、下部の結果パネルにテーブルデータが表示されます。