これらのインストラクションを使用するダイアレクト
MySQL、MariaDB、SingleStore(旧称 MemSQL)は、Looker を分析データベースに接続するために、このページで説明されているデータベース設定要件を共有しています。セルフホスト型 Looker インスタンスの内部バックエンド データベースとして MySQL を構成するには、Looker バックエンド データベースを MySQL に移行するをご覧ください。
ネットワークトラフィックの暗号化
Looker アプリケーションとデータベース間のネットワーク トラフィックを暗号化することをおすすめします。セキュアなデータベース アクセスを可能にするドキュメント ページに記載されているオプションのいずれかを検討してください。
SSL 暗号化の使用を検討している場合は、こちらの MySQL のドキュメント ページをご覧ください。
ユーザーとセキュリティ
必要なアクセス権限を作成し、Looker ユーザーに付与するには、お使いのデータベースの言語とバージョンに該当するセクションの指示に従ってください。
MySQL 8.4.X
MySQL 8.4.X では、デフォルトの認証プラグインは caching_sha2_password で、mysql_native_password プラグインはデフォルトで無効になっています。Looker 接続で SSL が有効になっているかどうかに応じて、次のいずれかの認証方法を選択します。
SSL を有効にして接続する場合(推奨): Looker JDBC ドライバは、
mysql_native_passwordを有効にせずに SSL 接続を介してcaching_sha2_passwordをサポートします。Looker 接続を作成するときに [SSL] を選択し、次のコマンドを実行してユーザーを作成し、SELECT権限を付与します。CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH caching_sha2_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';SSL を有効にせずに接続する場合: Looker は、暗号化されていない顧客データベース接続で自動 RSA 公開鍵取得(
allowPublicKeyRetrieval)を有効にしないため、mysql_native_passwordで認証する必要があります。デプロイに応じて、次のいずれかの方法で MySQL 8.4.X サーバーを構成し、
mysql_native_passwordプラグインを有効にします。--mysql-native-password=ONフラグを指定して MySQL サーバーを起動します。my.cnf構成ファイルのプロパティを設定します。[mysqld] mysql_native_password=ONGoogle Cloud、AWS、または Azure のクラウドホスト型 MySQL 8.4.X インスタンスの場合、デフォルトで有効になっていない場合は、インスタンス構成またはパラメータ グループで
mysql_native_passwordデータベース フラグまたはパラメータを有効にし、必要に応じてデータベース インスタンスを再起動します。構成の詳細については、クラウド プロバイダのドキュメントをご覧ください。
mysql_native_passwordを使用してデータベース ユーザーを作成し、SELECT権限を付与します。CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
上記のコマンドの次のプレースホルダを置き換えます。
- DB_USERNAME: Looker データベース ユーザーのユーザー名(
lookerなど) - PASSWORD: 一意の安全なパスワード
- DATABASE_NAME: データベースの名前
MySQL 8.0.X
MySQL 8.0.X のデフォルト認証プラグインは caching_sha2_password です。Looker は、mysql_native_password プラグインを使用して、JDBC ドライバを介して MySQL 8.0.X データベースに対する認証を行います。MySQL 8.0.X を正しく機能させるには、次の手順を完了します。
mysql_native_passwordプラグインを使用するように MySQL データベースを構成します。これは複数の方法で実行できます。どの方法を使用するかは、MySQL 8データべースのデプロイ方法と、構成へのアクセスのタイプによって決まります。--default-auth=mysql_native_passwordフラグでプロセスを開始するmy.cnf構成ファイルのプロパティを設定します。
[mysqld] default-authentication-plugin=mysql_native_password- データベース インスタンスが AWS RDS を介してホストされている場合、このデータベース インスタンスに適用される RDS パラメータ グループを介して
default_authentication_pluginパラメータを設定します。
次のコマンドを実行します。
PASSWORDは、一意の安全なパスワードに置き換えてください。CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON database_name.* TO 'looker'@'%';
MySQL 5.7.X 以前、MariaDB、SingleStore:
次のコマンドを実行します。PASSWORD は、一意の安全なパスワードに置き換えてください。
CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('PASSWORD');
GRANT SELECT ON database_name.* TO 'looker'@'%';
永続的派生テーブルの一時スキーマの設定
これらのデータベース ダイアレクトでは、永続的な派生テーブル(PDT)の作成がサポートされています。非常に有用な機能であるため、可能な場合は有効化することをお勧めします。
PDT を有効化するには、一時スキーマを設定する必要があります。次のコマンドは、一時データベースの作成と必要な権限の looker ユーザーへの付与の例を示しています。
データベース接続の作成時に、一時データベース フィールドで一時データベースの名前を指定できます。一時データベースの名前を指定しない場合、Looker は
looker_tmpという名前のスクラッチ データベースを生成します。次のコマンドはlooker_tmpを使用していますが、別の一時データベース名を指定している場合は、looker_tmpの代わりにお使いの一時データベース名を使用します。
CREATE SCHEMA looker_tmp;
GRANT
SELECT,
INDEX,
INSERT,
UPDATE,
DELETE,
CREATE,
DROP,
ALTER,
CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
SingleStore の場合、またはお使いのデータベースで GTID ベースのレプリケーションを使用している場合、PDT を使用するには create_process LookML パラメータを使用する必要があります。これは、GTID では CREATE TABLE AS SELECT ステートメントがサポートされないためです。
標準派生テーブルの代替設定
永続的な派生テーブルの作成を許可しない場合でも、通常の派生テーブルを使用できます。通常の派生テーブルを使用する場合でも、looker_tmp というスキーマに特定の権限を追加する必要があります。ただし、looker_tmp スキーマがお使いのデータベースに実際に存在する必要はありません。
GRANT
SELECT,
INDEX,
INSERT,
DROP,
CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
-- Note that the looker_tmp schema does not need to actually exist,
-- even though these permission grants are still needed
max_allowed_packet 変数の設定
MySQL では、「SQLException: Packet for query is too large」エラーを防ぐために、MySQL max_allowed_packet 変数を最大値(1073741824)に設定します。
データベースへの Looker 接続の作成
データベースの構成が完了したら、Lookerからデータベースに接続できます。Looker からデータベースへの接続を作成するには、次の手順を行います。
- Looker の [管理者] セクションで [接続] を選択し、[新しい接続] をクリックします。
[言語] プルダウン メニューから、データベース言語名(MySQL、MySQL 8.0.12 以降(MySQL 8.0.12 以降の 8.X バージョン(MySQL 8.4.X を含む))、MariaDB、SingleStore、SingleStore 7 以降)を選択します。
接続の詳細を入力します。設定の大部分は、ほとんどのデータベース言語に共通するものです。詳細については、Looker をデータベースに接続するのドキュメント ページをご覧ください。
接続が成功したことを確認するには、[接続設定] ページの下部にある [ステータスの詳細] セクションの [接続をテスト] ボタンをクリックします。
Looker に [接続可能] と表示されたら、[接続] を押して接続を作成します。
これで、データベース接続が Looker の [接続管理] ページのリストに追加されます。
サポートされている JDBC パラメータ
MySQL、MariaDB、SingleStore の場合、Looker は接続の [その他の JDBC パラメータ] フィールドで次の JDBC パラメータをサポートしています。これらのパラメータについては、データベースのドキュメントをご覧ください。
allowMultiQueriesautocommitcharacterSetResultsclientCertificateKeyStorePasswordclientCertificateKeyStoreUrlconnectionAttributesconnectionCollationconnectionTimeZoneconnectTimeoutdefaultAuthenticationPlugindisableSslHostnameVerificationdisconnectOnExpiredPasswordsenabledSslCipherSuitesfailOverReadOnlyfallbackToSystemTrustStoreforceConnectionTimeZoneToSessioninteractiveClientlookerFailovermaxIdleTimemaxQuerySizeToLogoldModeNoPrecisionTimestamppasswordpasswordCharacterEncodingpermitMysqlSchemepinGlobalTxToPhysicalConnectionpreserveInstantsqueryInterceptorsrestrictedAuthrewriteBatchedStatementssocketTimeoutsslModetcpKeepAlivetrustCertificateKeyStorePasswordtrustCertificateKeyStoreUrluseCompressionusePipelineAuthuseruseServerPrepStmtsverifyServerCertificateyearIsDateType
機能のサポート
一部の機能については、Looker でサポートするには、データベース言語が同じ機能に対応している必要があります。
MySQL は、Looker 26.22 の時点で、次の機能をサポートしています。
| 機能 | サポート対象 |
|---|---|
| Looker(Google Cloud コア) | |
| 対称集計 | |
| 派生テーブル | |
| 永続的な SQL 派生テーブル | |
| 永続的なネイティブ派生テーブル | |
| 安定したビュー | |
| クエリの強制終了 | |
| SQL ベースのピボット | |
| タイムゾーン | |
| SSL | |
| Subtotals | |
| JDBC の追加パラメータ | |
| 大文字と小文字を区別 | |
| ロケーション タイプ | |
| リストの種類 | |
| パーセンタイル | |
| 個別のパーセンタイル | |
| SQL Runner の表示プロセス | |
| SQL Runner の説明テーブル | |
| SQL Runner 表示インデックス | |
| SQL Runner Select 10 | |
| SQL ランナーの数 | |
| SQL の説明 | |
| OAuth 2.0 認証情報 | |
| コンテキスト コメント | |
| 接続プーリング | |
| HLL スケッチ | |
| 集計テーブルの自動認識 | |
| 増分PDT | |
| ミリ秒 | |
| マイクロ秒 | |
| マテリアライズド ビュー | |
| 前期比の指標 | |
| Approximate Count Distinct | |
| データベース内分析モデル | |
| カスタム カレンダー |
MySQL 8.0.12 以降では、Looker 26.22 の時点で、次の機能をサポートしています。
| 機能 | サポート対象 |
|---|---|
| Looker(Google Cloud コア) | |
| 対称集計 | |
| 派生テーブル | |
| 永続的な SQL 派生テーブル | |
| 永続的なネイティブ派生テーブル | |
| 安定したビュー | |
| クエリの強制終了 | |
| SQL ベースのピボット | |
| タイムゾーン | |
| SSL | |
| Subtotals | |
| JDBC の追加パラメータ | |
| 大文字と小文字を区別 | |
| ロケーション タイプ | |
| リストの種類 | |
| パーセンタイル | |
| 個別のパーセンタイル | |
| SQL Runner の表示プロセス | |
| SQL Runner の説明テーブル | |
| SQL Runner 表示インデックス | |
| SQL Runner Select 10 | |
| SQL ランナーの数 | |
| SQL の説明 | |
| OAuth 2.0 認証情報 | |
| コンテキスト コメント | |
| 接続プーリング | |
| HLL スケッチ | |
| 集計テーブルの自動認識 | |
| 増分PDT | |
| ミリ秒 | |
| マイクロ秒 | |
| マテリアライズド ビュー | |
| 前期比の指標 | |
| Approximate Count Distinct | |
| データベース内分析モデル | |
| カスタム カレンダー |
MariaDB は、Looker 26.22 の時点で、次の機能をサポートしています。
| 機能 | サポート対象 |
|---|---|
| Looker(Google Cloud コア) | |
| 対称集計 | |
| 派生テーブル | |
| 永続的な SQL 派生テーブル | |
| 永続的なネイティブ派生テーブル | |
| 安定したビュー | |
| クエリの強制終了 | |
| SQL ベースのピボット | |
| タイムゾーン | |
| SSL | |
| Subtotals | |
| JDBC の追加パラメータ | |
| 大文字と小文字を区別 | |
| ロケーション タイプ | |
| リストの種類 | |
| パーセンタイル | |
| 個別のパーセンタイル | |
| SQL Runner の表示プロセス | |
| SQL Runner の説明テーブル | |
| SQL Runner 表示インデックス | |
| SQL Runner Select 10 | |
| SQL ランナーの数 | |
| SQL の説明 | |
| OAuth 2.0 認証情報 | |
| コンテキスト コメント | |
| 接続プーリング | |
| HLL スケッチ | |
| 集計テーブルの自動認識 | |
| 増分PDT | |
| ミリ秒 | |
| マイクロ秒 | |
| マテリアライズド ビュー | |
| 前期比の指標 | |
| Approximate Count Distinct | |
| データベース内分析モデル | |
| カスタム カレンダー |
SingleStore では、Looker 26.22 の時点で、次の機能をサポートしています。
| 機能 | サポート対象 |
|---|---|
| Looker(Google Cloud コア) | |
| 対称集計 | |
| 派生テーブル | |
| 永続的な SQL 派生テーブル | |
| 永続的なネイティブ派生テーブル | |
| 安定したビュー | |
| クエリの強制終了 | |
| SQL ベースのピボット | |
| タイムゾーン | |
| SSL | |
| Subtotals | |
| JDBC の追加パラメータ | |
| 大文字と小文字を区別 | |
| ロケーション タイプ | |
| リストの種類 | |
| パーセンタイル | |
| 個別のパーセンタイル | |
| SQL Runner の表示プロセス | |
| SQL Runner の説明テーブル | |
| SQL Runner 表示インデックス | |
| SQL Runner Select 10 | |
| SQL ランナーの数 | |
| SQL の説明 | |
| OAuth 2.0 認証情報 | |
| コンテキスト コメント | |
| 接続プーリング | |
| HLL スケッチ | |
| 集計テーブルの自動認識 | |
| 増分PDT | |
| ミリ秒 | |
| マイクロ秒 | |
| マテリアライズド ビュー | |
| 前期比の指標 | |
| Approximate Count Distinct | |
| データベース内分析モデル | |
| カスタム カレンダー |
SingleStore 7 以降では、Looker 26.22 の時点で、次の機能をサポートしています。
| 機能 | サポート対象 |
|---|---|
| Looker(Google Cloud コア) | |
| 対称集計 | |
| 派生テーブル | |
| 永続的な SQL 派生テーブル | |
| 永続的なネイティブ派生テーブル | |
| 安定したビュー | |
| クエリの強制終了 | |
| SQL ベースのピボット | |
| タイムゾーン | |
| SSL | |
| Subtotals | |
| JDBC の追加パラメータ | |
| 大文字と小文字を区別 | |
| ロケーション タイプ | |
| リストの種類 | |
| パーセンタイル | |
| 個別のパーセンタイル | |
| SQL Runner の表示プロセス | |
| SQL Runner の説明テーブル | |
| SQL Runner 表示インデックス | |
| SQL Runner Select 10 | |
| SQL ランナーの数 | |
| SQL の説明 | |
| OAuth 2.0 認証情報 | |
| コンテキスト コメント | |
| 接続プーリング | |
| HLL スケッチ | |
| 集計テーブルの自動認識 | |
| 増分PDT | |
| ミリ秒 | |
| マイクロ秒 | |
| マテリアライズド ビュー | |
| 前期比の指標 | |
| Approximate Count Distinct | |
| データベース内分析モデル | |
| カスタム カレンダー |