Google Cloud SQL for MySQL に接続する

Cloud SQL for MySQL は、Cloud Platform 上のリレーショナル MySQL データベースの設定、維持、運用、管理を簡単にできるようにするフルマネージド データベース サービスです。Cloud SQL for MySQL コネクタを使用すると、Looker Studio 内で Cloud SQL for MySQL データベースのデータにアクセスできるようになります。

この記事の内容:

• サポートされるバージョン
• 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 データベース テーブル、または指定したカスタムクエリに接続できます。

接続方法

1. Looker Studio にログインします。
2. Looker Studio のホームページで、左上にある [作成] をクリックして、[データソース] を選択します。
3. Cloud SQL for MySQL コネクタを選択します。
4. 求められた場合は、Looker Studio にデータへのアクセスを許可します。
5. データベースへの接続を設定します。

   ホスト名または IP アドレスを使って接続する

   1. 左側の [基本] を選択します。
   2. 接続の詳細を入力します。
      1. インスタンス接続名（インスタンス接続を一覧表示する方法については下記をご覧ください）
      2. データベース
      3. ユーザー名
      4. パスワード

   JDBC URL を使用して接続する

   1. 左側の [JDBC URL] を選択します。
   2. 接続の詳細を入力します。
      1. JDBC URL

         例
         
         jdbc:google:mysql://<インスタンス接続名>/<データベース>

      2. ユーザー名
      3. パスワード

   JDBC ホスト名オプションを使用すると、一般公開されている Whois などの DNS ルックアップ ツールで、そのホスト名がアクセス可能かどうかを確認できます。

   IPv6 リテラル アドレスを使用して接続するには、アドレスを角かっこで囲みます（例: jdbc:google:mysql://[2001:db8:1:1:1:1:1:1]/your_db）。

   詳細については、https://datatracker.ietf.org/doc/html/rfc2732 をご覧ください。
   注: Looker Studio は localhost に接続できません。公開ホスト名または IP アドレスを使用する必要があります。
6. [認証] をクリックします。
7. リストからテーブルを選択するか、カスタムクエリを入力します。

   1 つの表に接続する代わりに、SQL クエリを指定するには [カスタムクエリ] オプションを選択します。Looker Studio では、データベースに対するクエリが生成されるたびに、このカスタム SQL が内部 SELECT ステートメントとして使用されます。

   カスタム SQL クエリには、1 つのステートメントのみを含めることがます。

   たとえば以下は、複数の 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 分後にタイムアウトすることがあります。カスタムクエリがタイムアウトした場合は、次の方法で問題を解決してみてください。

   • 実行速度を上げるために、クエリを簡素化します。
   • データベースでクエリを実行し、結果を別のテーブルに保存してからデータソース内のそのテーブルに接続します。
8. [接続] をクリックします。

すぐに、データソースのフィールド一覧ページが表示されます。右上にある [レポートを作成] または [探索] をクリックして、データの可視化を開始します。

備考

インスタンス接続名を探す

Google Cloud では、お客様のインスタンスをインスタンス接続名で識別します。これを取得するには Cloud コンソールを使用するか、コマンドラインを使用します。

コンソールを使用する

1. https://console.cloud.google.com/sql/instances に移動します。
2. 接続先のインスタンス ID をクリックします。
3. 左側の [このインスタンスに接続] セクションに接続名が表示されます。

コマンドラインを使用する

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 以外の文字はサポートされていません。

関連資料

• データソースを作成する
• Cloud SQL for MySQL デベロッパー向けドキュメント