本記事では、OB CloudクラウドデータベースのMySQLモードを例に、グアンユエンBIでOB Cloudクラウドデータベースに接続してデータを表示する方法を紹介します。
前提条件
グアンユエンBIをご購入いただいていること。
注意
グアンユエンBIの利用には、グアンユエンBIの料金規則が適用され、該当する料金が発生する場合があります。続行する前に、公式サイトをご覧いただくか関連ドキュメントを確認し、その料金体系をご確認のうえ、ご同意いただきますようお願いいたします。同意できない場合は、操作を続けないでください。
OB Cloudデータベースアカウントに登録済みで、トランザクション型インスタンスとMySQLモードのテナントを作成していること。詳細については、クラスタインスタンスの作成およびテナントの作成をご参照ください。
ステップ１：OB Cloudデータベースの接続文字列を取得する
OB Cloudコンソールにログインします。インスタンス一覧ページで対象のインスタンスの**接続をクリックし、接続文字列を取得**を選択します。
ポップアップウィンドウで、**パブリックネットワークを使用**を選択します。
**パブリックIPを使用してデータベースに接続**ページで以下の設定を完了し、接続文字列を生成します：
ステップ１：パブリックエンドポイントを取得：**エンドポイントを取得をクリックします。パブリックアドレスの取得に成功したら、次へ**をクリックします。
ステップ2：セキュリティ設定：**1. IPアドレスを追加で、追加をクリックして、エグジットIPをホワイトリストに追加します。次に、2. 証明書をダウンロードで、CA証明書をダウンロードして設定します。完了後、次へ**をクリックします。
ステップ3：接続：**データベースとアカウントのドロップダウンリストで、それぞれボタンをクリックしてデータベースとアカウントを新規作成します。次に、接続方式としてMySQL CLI**を選択します。
注意
アカウント作成後、作成時に生成されたパスワードを適切に保管してください。
ステップ2：グアンユエンBIでドライバーとコネクターを設定する
グアンユエンBIコンソールにログインし、ページの右上隅で管理センター > リソース管理 > ドライバーとコネクター管理を選択します。
ドライバー管理タブの下で新規ドライバーをクリックし、ドライバー名を編集して、**保存**をクリックして新規ドライバーの作成を完了します。
新規作成したドライバーOceanBase-MySQLをクリックし、**ファイルのアップロードボタンをクリックして、ドライバーのJarパッケージと利用可能なDriver Classをアップロードします。適用**をクリックしてドライバーの設定を完了します。
説明
OceanBase (MySQL)のドライバーJarパッケージをダウンロードするには、OceanBaseソフトウェアダウンロードセンターにアクセスし、CPUアーキテクチャに応じてダウンロードしてください。
データベースコネクター管理タブをクリックし、新規データベースコネクターをクリックして、ポップアップウィンドウでデータベースコネクターを設定します。完了後、**OK**をクリックします。
パラメータ説明表示ICON データアカウントおよびデータベースデータセットの新規作成時に表示される、カスタムデータ接続の画像ICONを設定します。 コネクタ名 ユーザーの習慣に合わせて自由に定義します。特殊文字は使用できません。 デフォルト方言サポート MySQLを選択します。 テーブルリスト取得SQL {"sql": "SHOW TABLES", "tableNameIdx": 1}と入力します。デフォルトドライバ 手順3で新規作成したドライバOceanBase-MySQLを選択します。
ステップ3：Guan Yuan BIでデータアカウントを作成する
Guan Yuan BIコンソールでデータ準備>データアカウントを選択します。
データアカウントの新規作成をクリックし、データアカウントを設定します：
a. コネクタの選択では、手順2で作成したコネクタOceanBase-MySQLを選択します。完了後、**次へ**をクリックします。
b. データアカウントの設定では、データアカウント情報を設定します。設定完了後、**接続テストをクリックし、OceanBaseデータベースへの接続が正常か確認します。確認後、次へ**をクリックします。
パラメータ説明ユーザー名 接続文字列の -uパラメータから取得したアカウント名です。パスワード 接続文字列の -pパラメータから取得したアカウントのパスワードです。JDBC URL 接続文字列の -h、-P、-D、-u、-pパラメータを連結して作成します。連結構文は以下のとおりです：jdbc:oceanbase://host:port/databasename?[username&password]
例：jdbc:oceanbase://t5******.aws-ap-southeast-1.oceanbase.cloud:3306/test?user=test_user001@sys&password=***1**最大接続数 単一データアカウントの接続プール数の上限を設定します。 ドライバ 手順2で作成したドライバOceanBase-MySQLをカスタム選択します。 c. データアカウント情報の確認では、現在のデータベースのデータアカウントに名前を付け、完了後、新規作成を確認をクリックします。
ステップ4：Guan Yuan BIにデータを接続する
Guan Yuan BIコンソールで、ページの右上隅にある データ準備 > データセット を選択し、次に 新規データセット > データベース を選択します。
データセット接続情報を設定します：
a. データアカウントとデータテーブルの選択 で、ステップ3で作成したデータアカウント OceanBaseアカウント を選択し、SQLクエリでデータを取得します。完了後、次へ をクリックします。
b. データ接続と更新の設定 で、データ接続と更新情報を設定します。完了後、次へ をクリックします。
c. データテーブル情報の確認 で、データ取得結果を確認し、データセット名、保存パスなどを設定します。完了後、新規作成を確認 をクリックします。
データセットリストに接続したデータセットが表示されれば、データソースへの接続に成功しています。
次のステップ
データソースの作成が完了したら、Guan Yuan BIの使用を開始できます。Guan Yuan BIの詳細な操作ガイドについては、Guan Yuan BIヘルプセンターをご参照ください。