Apache Druid

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`

接続の設定

  1. Looker の [Admin] セクションで [Connections] を選択し、[Add Connection] をクリックします。

  2. 各フィールドを次のように指定します。

    • 名前: 接続の名前。
    • Dialect: Apache Druid、Apache Druid 0.13 以降、または Apache Druid 0.18 以降。
    • ホスト: クラスタの DNS または IPブローカー。これは broker/runtime.properties ファイルにあります。
    • ポート: ブローカーのポート。デフォルトのポートは、8082 です。クラスタが SSL で保護されている場合、デフォルトのポートは 8182 です。
    • データベース: データベースの名前。デフォルトは druid です。
    • Username: Apache Druid クラスタが Druid Basic Security を使用するように構成されている場合、データベースのユーザー名。含まれていない場合は、任意の文字列を指定できます。
    • パスワード: ユーザーのパスワード。Druid Basic セキュリティを使用するようにクラスタが構成されていない場合は、任意の文字列を指定できます。
    • スキーマ: スキーマが指定されていない場合に使用されるデフォルトのスキーマ。スキーマの入力は任意です。

    • その他のパラメータ: セミコロンで区切られた Avatica JDBC パラメータ。

      • これらのプロパティは、接続プロパティとして設定できます。
        • useApproximateCountDistinct
        • useApproximateTopN
        • useFallback
        • sqlTimeZone

      例: none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

    • PDT とデータグループのメンテナンス スケジュール: Looker でデータグループと永続的な派生テーブルをいつチェックするかを示す cron 式。この設定の詳細については、PDT とデータグループのメンテナンス スケジュールのドキュメントをご覧ください。

    • SSL: Apache Druid クラスタが Druid TLS を使用するように構成されているかどうかを確認します。

    • Verify SSL: ホスト名の厳密な検証を強制するにはチェックボックスをオンにします。

    • 最大接続数: デフォルトは 25 です。

    • Connection Pool Timeout: デフォルトは 120 秒です。

    • SQL Runner のプリキャッシュ: SQL Runner でテーブル情報をプリロードせず、テーブルが選択されている場合にのみテーブル情報を読み込みないようにするには、このオプションをオフにします。この設定の詳細については、SQL Runner プリキャッシュのドキュメントをご覧ください。

    • データベースのタイムゾーン: データベースのタイムゾーン。Apache Druid 0.13 以降と Apache Druid 0.18 以降でサポートされています。

  1. [Test Settings Settings] をクリックして接続を確認します。

    Looker は SELECT 1 クエリを実行して基本的な接続を確認し、クエリテストを行います。カタログとスキーマの組み合わせが存在することや、ユーザーがそのスキーマに対して必要なアクセス権を持っていることが検証されるわけではありません。

    問題が発生した場合は、接続のテストのドキュメントをご覧ください。

  2. [接続を追加] をクリックして、設定を保存します。

  3. SQL Runner で接続をテストします。SQL Runner に移動し、接続とスキーマを選択して、データベース テーブルを表示できるかどうかを確認します。

機能のサポート

一部の機能については、Lookerでサポートするには、データベースダイアレクトが同じ機能に対応している必要があります。

Looker の最新リリースでは、Apache Druid は次の Looker 機能をサポートしています。

Looker の最新リリースでは、Apache Druid 0.13 以降が次の Looker 機能をサポートしています。

Looker の最新リリースでは、Apache Druid 0.18 以降が次の Looker 機能をサポートしています。

次のステップ

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