Apache Druid

ネットワークトラフィックの暗号化

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 の基本セキュリティを使用するようにクラスタが構成されていない場合は、任意の文字列を指定できます。

  • Schema: スキーマが指定されない場合に使用されるデフォルトのスキーマ。スキーマの入力は省略できます。

  • その他の 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
いいえ

次のステップ

データベース接続が完了したら、認証オプションを構成します。