ネットワークトラフィックの暗号化
Looker アプリケーションとデータベース間のネットワーク トラフィックを暗号化することをおすすめします。セキュアなデータベースアクセスを可能にするドキュメント ページに記載されているオプションのいずれかを検討してください。
Apache Druid クラスタの構成
<DRUID_BASE_DIR>
は、Apache Druid クラスタがサーバーにインストールされているベース ディレクトリを指します。
SQL の有効化
Druid データベースで SQL を有効にするには、次の行を broker/runtime.properties
構成ファイルに追加します。
<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties
druid.sql.enable=true
COUNT DISTINCT
近似をオフにする(省略可)
デフォルトでは、Druid は COUNT DISTINCT
で近似します。正確な結果を得るために、次の行を broker/runtime.properties
構成ファイルに追加します。
<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties
`druid.sql.planner.useApproximateCountDistinct=false`
データベースへの Looker 接続の作成
Looker の [管理者] セクションで [接続] を選択し、[新しい接続] をクリックします。
接続の詳細を入力します。設定の大部分は、ほとんどのデータベース言語に共通するものです。詳細については、Looker をデータベースに接続するのドキュメント ページをご覧ください。設定の一部を次に説明します。
- Name: 接続の名前。
Dialect: Apache Druid、Apache Druid 0.13 以降、Apache Druid 0.18 以降。
Host: クラスタ Broker の DNS または IP アドレス。これは
broker/runtime.properties
ファイルにあります。Port: Broker のポート。デフォルトのポートは、8082 です。クラスタが SSL で保護されている場合、デフォルトのポートは 8182 です。
Database: データベースの名前。デフォルトは
druid
です。Username: Apache Druid クラスタが Druid の基本セキュリティを使用するよう構成されている場合、データベースのユーザー名。そうでない場合は、任意の文字列を指定できます。
パスワード: ユーザーのパスワード。Druid の基本セキュリティを使用するようにクラスタが構成されていない場合は、任意の文字列を指定できます。
その他の JDBC パラメータ: セミコロンで区切られた Avatica JDBC パラメータ。
- 次のプロパティは、接続プロパティとして設定できます。
useApproximateCountDistinct
useApproximateTopN
useFallback
sqlTimeZone
例:
none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit
- 次のプロパティは、接続プロパティとして設定できます。
データグループと PDT メンテナンス スケジュール:
cron
式。Looker がいつデータグループと永続的な派生テーブルを確認するかを示します。この設定の詳細については、データグループと PDT のメンテナンス スケジュールのドキュメントをご覧ください。SSL: Apache Druid クラスタが Druid TLS を使用するように構成されている場合はオンにします。
SSL の検証: オンにすると、ホスト名の厳密な検証が適用されます。
ノードあたりの最大接続数: デフォルトは 25 です。この設定は、最初はデフォルト値のままにしておくことができます。詳細については、Looker をデータベースに接続するのドキュメント ページをご覧ください。
接続プールのタイムアウト: デフォルトは 120 秒です。
SQL Runner Precache: SQL Runner でテーブルの情報を事前に読み込まず、テーブルを選択したときにのみテーブルの情報が読み込まれるようにするには、このオプションをオフにします。この設定の詳細については、SQL Runner の事前キャッシュのドキュメントをご覧ください。
データベースのタイムゾーン: データベースのタイムゾーン。Apache Druid 0.13 以降と Apache Druid 0.18 以降でサポートされています。
接続が成功したことを確認するには、[テスト] をクリックします。トラブルシューティング情報については、データベース接続のテストのドキュメント ページをご覧ください。
Looker は、SELECT 1
クエリを実行して基本的な接続を確認し、クエリテストを行います。カタログとスキーマの組み合わせが存在することや、ユーザーがそのスキーマに必要なアクセス権を持っているかどうかは検証されません。
問題が発生した場合は、接続のテストのドキュメントをご覧ください。
これらの設定を保存するには、[接続] をクリックします。
SQL Runner で接続をテストします。[SQL Runner] に移動して、接続とスキーマを選択してから、データベース テーブルが表示されるかどうかを確認します。
機能のサポート
一部の機能については、Looker でサポートするには、データベース言語が同じ機能に対応している必要があります。
Apache Druid
Apache Druid は、Looker 24.8 の時点で、次の機能をサポートしています。
特徴 | サポート対象 |
---|---|
サポート レベル | サポート対象 |
Looker(Google Cloud コア) | いいえ |
対称集計 | いいえ |
派生テーブル | あり |
永続的な SQL 派生テーブル | いいえ |
永続的なネイティブ派生テーブル | いいえ |
安定したビュー | いいえ |
クエリの強制終了 | いいえ |
SQL ベースのピボット | いいえ |
タイムゾーン | いいえ |
SSL | あり |
Subtotals | いいえ |
JDBC の追加パラメータ | あり |
Case Sensitive | あり |
ロケーション タイプ | あり |
リストのタイプ | いいえ |
パーセンタイル | いいえ |
個別のパーセンタイル | いいえ |
SQL Runner の表示プロセス | いいえ |
SQL Runner の説明テーブル | いいえ |
SQL Runner 表示インデックス | いいえ |
SQL Runner Select 10 | あり |
SQL ランナーの数 | あり |
SQL の説明 | あり |
Oauth 認証情報 | いいえ |
コンテキスト コメント | あり |
接続プーリング | いいえ |
HLL スケッチ | いいえ |
集計認識 | いいえ |
増分PDT | いいえ |
ミリ秒 | あり |
マイクロ秒 | いいえ |
マテリアライズド ビュー | いいえ |
Approximate Count Distinct | いいえ |
Apache Druid 0.13+
Apache Druid 0.13 以降では、Looker 24.8 の時点で、次の機能をサポートしています。
特徴 | サポート対象 |
---|---|
サポート レベル | サポート対象 |
Looker(Google Cloud コア) | いいえ |
対称集計 | いいえ |
派生テーブル | あり |
永続的な SQL 派生テーブル | いいえ |
永続的なネイティブ派生テーブル | いいえ |
安定したビュー | いいえ |
クエリの強制終了 | いいえ |
SQL ベースのピボット | いいえ |
タイムゾーン | あり |
SSL | あり |
Subtotals | いいえ |
JDBC の追加パラメータ | あり |
Case Sensitive | あり |
ロケーション タイプ | いいえ |
リストのタイプ | いいえ |
パーセンタイル | いいえ |
個別のパーセンタイル | いいえ |
SQL Runner の表示プロセス | いいえ |
SQL Runner の説明テーブル | いいえ |
SQL Runner 表示インデックス | いいえ |
SQL Runner Select 10 | あり |
SQL ランナーの数 | あり |
SQL の説明 | あり |
Oauth 認証情報 | いいえ |
コンテキスト コメント | あり |
接続プーリング | いいえ |
HLL スケッチ | いいえ |
集計認識 | いいえ |
増分PDT | いいえ |
ミリ秒 | あり |
マイクロ秒 | いいえ |
マテリアライズド ビュー | いいえ |
Approximate Count Distinct | いいえ |
Apache Druid 0.18+
Apache Druid 0.18 以降では、Looker 24.8 の時点で、次の機能をサポートしています。
特徴 | サポート対象 |
---|---|
サポート レベル | サポート対象 |
Looker(Google Cloud コア) | はい |
対称集計 | いいえ |
派生テーブル | あり |
永続的な SQL 派生テーブル | いいえ |
永続的なネイティブ派生テーブル | いいえ |
安定したビュー | いいえ |
クエリの強制終了 | いいえ |
SQL ベースのピボット | いいえ |
タイムゾーン | あり |
SSL | あり |
Subtotals | いいえ |
JDBC の追加パラメータ | あり |
Case Sensitive | あり |
ロケーション タイプ | あり |
リストのタイプ | いいえ |
パーセンタイル | いいえ |
個別のパーセンタイル | いいえ |
SQL Runner の表示プロセス | いいえ |
SQL Runner の説明テーブル | いいえ |
SQL Runner 表示インデックス | いいえ |
SQL Runner Select 10 | あり |
SQL ランナーの数 | あり |
SQL の説明 | あり |
Oauth 認証情報 | いいえ |
コンテキスト コメント | あり |
接続プーリング | いいえ |
HLL スケッチ | いいえ |
集計認識 | いいえ |
増分PDT | いいえ |
ミリ秒 | あり |
マイクロ秒 | いいえ |
マテリアライズド ビュー | いいえ |
Approximate Count Distinct | いいえ |
次のステップ
データベース接続が完了したら、認証オプションを構成します。