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 DruidApache 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.16 の時点で次の機能がサポートされています。

機能 サポート対象
サポート レベル
サポート対象
Looker(Google Cloud コア)
×
対称集計
×
派生テーブル
永続的な SQL 派生テーブル
×
永続的なネイティブ派生テーブル
×
安定したビュー
×
クエリの強制終了
×
SQL ベースのピボット
×
タイムゾーン
×
SSL
Subtotals
×
JDBC の追加パラメータ
大文字と小文字を区別
ロケーション タイプ
リストのタイプ
×
パーセンタイル
×
個別のパーセンタイル
×
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.16 の時点で次の機能がサポートされています。

機能 サポート対象
サポート レベル
サポート対象
Looker(Google Cloud コア)
×
対称集計
×
派生テーブル
永続的な SQL 派生テーブル
×
永続的なネイティブ派生テーブル
×
安定したビュー
×
クエリの強制終了
×
SQL ベースのピボット
×
タイムゾーン
SSL
Subtotals
×
JDBC の追加パラメータ
大文字と小文字を区別
ロケーション タイプ
×
リストのタイプ
×
パーセンタイル
×
個別のパーセンタイル
×
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.16 の時点で次の機能がサポートされています。

機能 サポート対象
サポート レベル
サポート対象
Looker(Google Cloud コア)
対称集計
×
派生テーブル
永続的な SQL 派生テーブル
×
永続的なネイティブ派生テーブル
×
安定したビュー
×
クエリの強制終了
×
SQL ベースのピボット
×
タイムゾーン
SSL
Subtotals
×
JDBC の追加パラメータ
大文字と小文字を区別
ロケーション タイプ
リストのタイプ
×
パーセンタイル
×
個別のパーセンタイル
×
SQL Runner の表示プロセス
×
SQL Runner の説明テーブル
×
SQL Runner 表示インデックス
×
SQL Runner Select 10
SQL ランナーの数
SQL の説明
Oauth 認証情報
×
コンテキスト コメント
接続プーリング
×
HLL スケッチ
×
集計認識
×
増分PDT
×
ミリ秒
マイクロ秒
×
マテリアライズド ビュー
×
Approximate Count Distinct
×

次のステップ

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