Cloud SQL for MySQL は、Cloud Platform 上のリレーショナル MySQL データベースの設定、維持、運用、管理を簡単にできるようにするフルマネージド データベース サービスです。Cloud SQL for MySQL コネクタを使用すると、Looker Studio 内で Cloud SQL for MySQL データベースのデータにアクセスできます。
サポート対象のバージョン
Cloud SQL for MySQL コネクタは、次の MySQL バージョンでテストされました。
- 5.6
- 5.7
- 8.0
サポートされているバージョンの使用で問題が発生した場合は、Looker Studio のヘルプ コミュニティでお知らせください。機能に関するリクエストの追加や投票はこちらから行うことができます。
Cloud SQL for MySQL に接続する方法
Looker Studio のデータソースは、1 つの Cloud SQL for MySQL データベース テーブル、または指定したカスタムクエリに接続できます。
サービスとパートナー向けの
- Looker Studio にログインします。
- Looker Studio のホームページで、左上にある
[作成] をクリックして、[データソース] を選択します。 - Cloud SQL for MySQL コネクタを選択します。
- 求められた場合は、Looker Studio にデータへのアクセスを許可します。
データベースへの接続を設定します。
- ホスト名または IP アドレスを使って接続するには、
- 左側の [ 基本 ] を選択します。
- 接続の詳細を入力します。
- インスタンス接続名（インスタンス接続を一覧表示する方法については下記をご覧ください）。
- データベース
- ユーザー名
- パスワード
- JDBC URL を使用して接続するには、
- 左側の [ JDBC URL ] を選択します。
- 接続の詳細を入力します。
- JDBC URL
例
jdbc:google:mysql: //<instance connection name>/ - ユーザー名
- パスワード
- JDBC URL
IPv6 リテラル アドレスを使用して接続するには、アドレスを角かっこで囲みます。例:
jdbc:google:mysql://\[2001:db8:1:1:1:1:1:1\]/your_db- 注 : Looker Studio は
localhostに接続できません。公開ホスト名または IP アドレスを使用する必要があります。
- ホスト名または IP アドレスを使って接続するには、
[認証] をクリックします。
リストからテーブルを選択するか、カスタムクエリを入力します。
1 つの表に接続する代わりに、SQL クエリを指定するには [カスタムクエリ] オプションを選択します。Looker Studio では、データベースに対するクエリが生成されるたびに、このカスタム SQL が内部 SELECT ステートメントとして使用されます。
たとえば以下は、複数の SQL ステートメントが含まれるため機能しません。
DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;
SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;
Looker Studio のクエリは 3 ～ 5 分後にタイムアウトする場合があります。カスタムクエリがタイムアウトした場合は、次の方法で問題を解決してみてください。
- 実行速度を上げるために、クエリを簡素化します。
- データベースでクエリを実行し、結果を別のテーブルに保存してからデータソース内の新しいテーブルに接続します。
- [接続] をクリックします。
すぐに、データソースのフィールド一覧ページが表示されます。[レポートを作成] をクリックして、データの可視化を開始します。
メモ
インスタンス接続名を探す
インスタンス接続名は、 Google Cloudでお客様のインスタンスを識別するためのものです。これを取得するには、 Google Cloud コンソールを使用するか、コマンドラインを使用します。
コンソールを使用する
- https://console.cloud.google.com/sql/instances に移動します。
- 接続先のインスタンス ID をクリックします。
- 左側の [このインスタンスに接続] セクションに接続名が表示されます。
コマンドラインの使用
Cloud コマンドライン インターフェースを使用して接続名を確認するには、次のコマンドを使用します。
gcloud sql instances describe [INSTANCE_NAME] | grep connectionName
権限
接続を作成するには、Cloud SQL for MySQL プロジェクトにおいて cloudsql.client 以上の権限が必要です。この権限がない（または取得できない）場合は、代わりに MySQL コネクタを使用してください。
ネットワーク接続
Cloud SQL for MySQL コネクタでは、パブリック IP 接続とプライベート IP 接続を使った Cloud SQL for MySQL インスタンスへの接続がサポートされています。
Cloud SQL for MySQL コネクタを使用するには、事前に Cloud SQL for MySQL インスタンスへのパブリック IP 接続またはプライベート IP 接続を構成する必要があります。
Looker Studio で Cloud SQL のデータにアクセスし、そのデータに対するクエリをプライベート接続で実行できるようにするには、Cloud SQL for MySQL インスタンスの設定で、[Google Cloud サービスのプライベート パス] オプションを選択します。
データ型
Looker Studio は、データベースの組み込みデータ型を、統合されたデータ型一式にマッピングします。Looker Studio がサポートされていない表やクエリで列を検出すると、その列についてはフィールドが作成されません。
注 : Looker Studio では、MySQL 空間データの拡張はサポートされていません。
Cloud SQL for MySQL コネクタの制限事項
- このコネクタを使用すると、1 クエリあたり最大 15 万行のクエリを実行できます。この上限値を超えたデータは切り捨てられます。
- 列見出し（フィールド名）には ASCII 文字のみを使用する必要があります。ASCII 以外の文字はサポートされていません。
トラブルシューティング
一般的なエラー メッセージとその解決方法については、Looker Studio のトラブルシューティング ガイドをご覧ください。