Apache Superset は、MySQL や PostgreSQL など、Java Database Connectivity (JDBC) 互換のデータベースエンジンをサポートする、無料でオープンソースのデータ探索および可視化プラットフォームです。本ガイドでは、Superset を AnalyticDB for MySQL クラスターに接続し、SQL Lab で初めてのクエリを実行する手順を説明します。
前提条件
作業を開始する前に、以下の要件を満たしていることを確認してください。
Superset 4.1.1 以降がインストールされていること。インストール手順については、「Quickstart」をご参照ください。
Superset サーバーの IP アドレスが、ご利用の AnalyticDB for MySQL クラスターの IP アドレスホワイトリストに追加済みであること。「IP アドレスホワイトリスト」をご参照ください。
AnalyticDB for MySQL への Superset 接続
ステップ 1：接続情報の収集
Superset で接続を構成する前に、以下の情報を収集してください。
| パラメーター | 説明 |
|---|---|
| HOST | ご利用の AnalyticDB for MySQL クラスターのエンドポイント。Superset がクラスターと同じ VPC 内の Elastic Compute Service (ECS) インスタンス上で実行されている場合は 内部エンドポイント を、オンプレミスサーバー上で実行されている場合は パブリックエンドポイント を使用してください。 |
| PORT | 3306 |
| DATABASE NAME | クラスター内のデータベース名 |
| USERNAME | データベースアカウント名 |
| PASSWORD | データベースアカウントパスワード |
| DISPLAY NAME | Superset 内でのこの接続の表示名 |
ステップ 2：MySQL ドライバーのインストール（Python インストール時のみ）
Docker を使用して Superset をインストールした場合は、このステップをスキップしてください。Docker イメージにはすでに MySQL ドライバーが含まれています。
Python を使用して Superset をインストールした場合は、MySQL ドライバーを手動でインストールする必要があります。ドライバーオプションおよびインストールコマンドについては、「Connecting to Databases」をご参照ください。
ステップ 3：データベース接続の追加
Superset の Web インターフェイスを開き、右上隅の [設定項目] > [データベース接続] を選択します。
[データベース] ページで、右上隅の [+DATABASE] をクリックします。
[データベースの接続] ダイアログボックスで、データソースとして [MySQL] を選択します。
ステップ 1 で収集した接続情報を入力し、[CONNECT] をクリックします。
ステップ 4：SQL Lab 権限の有効化
[操作] 列で、新しく作成した接続の横にある
アイコンをクリックします。[ADVANCED] タブに移動し、[SQL Lab] をクリックします。
許可するデータベース操作を選択します。この例では、[Allow DDL and DML] を選択し、[FINISH] をクリックします。
ステップ 5：SQL Lab でのクエリ実行
上部ナビゲーションバーで、[SQL] > [SQL Labs] を選択します。
左側ペインで、以下のパラメーターを構成します。
パラメーター 説明 DATABASE ステップ 3 で作成した接続 SCHEMA SQL を実行するデータベース SEE TABLE SCHEMA クエリ対象のテーブル 右側のコードエディタに SQL ステートメントを入力し、実行します。
クエリが実行されると、エディタの下に結果が表示されます。これで、AnalyticDB for MySQL クラスターが Superset に接続され、使用可能な状態になりました。