Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

ClickHouse

Looker を ClickHouse データベースに接続して、データを分析し、インタラクティブなダッシュボードを構築します。この接続により、ClickHouse のデータを Looker 内でレポート作成と分析に使用できるようになり、データドリブンな意思決定を直接サポートできます。

このページでは、ネットワークトラフィックの暗号化、ユーザー権限の定義、サポートされている機能の確認など、ClickHouse インスタンスと Looker 接続の設定を行う方法について説明します。Looker は、最新の JDBC ドライバと対称集計のサポートを使用して、ClickHouse バージョン 0.2 以降と ClickHouse 26 以降をサポートしています。

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

Looker アプリケーションとデータベース間のネットワークトラフィックを暗号化することをおすすめします。セキュアなデータベースアクセスを可能にするのドキュメントページに記載されているオプションのいずれかを検討してください。

サーバー側で SSL 暗号化を有効にするには、ClickHouse グローバルサーバー設定のドキュメントをご覧ください。

ユーザーとセキュリティ

まず、ClickHouse サーバーで Looker ユーザーを構成します。ClickHouse データベースユーザーは、SQL（CREATE USER）を使用するか、users ファイルの users.xml セクションを使用して構成できます。ClickHouse のアクセス権に関するドキュメントに沿って、ユーザーアクセスを構成します。次の基本的な例では、users.xml を使用しています。

<!-- Users and ACL. -->
<users>
    <looker>
        <password>CHANGEIT</password>
        <networks incl="networks" />
        <profile>default</profile>
        <quota>default</quota>
    </looker>

    <web>
        <password></password>
        <networks incl="networks" />
        <profile>web</profile>
        <quota>default</quota>
        <allow_databases>
           <database>test</database>
        </allow_databases>
        <allow_dictionaries>
           <dictionary>test</dictionary>
        </allow_dictionaries>
    </web>
</users>

またこのファイル内で、適切なデータベースアクセスを構成します。

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

データベースへの Looker 接続の作成

Looker の [管理者] セクションで [接続] を選択し、[新しい接続] をクリックします。

接続の詳細を入力します。設定の大部分は、ほとんどのデータベース言語に共通するものです。詳細については、Looker をデータベースに接続するのドキュメントページをご覧ください。設定の一部を次に説明します。

言語 : [ClickHouse 26+] または [ClickHouse] を選択します。
ホスト: ClickHouse サーバーの到達可能なホスト名または IP アドレス。
ポート: ClickHouse サービスが HTTP(S) 経由で到達可能なポート。
- デフォルトでは、HTTP 接続は 8123 を使用し、HTTPS 接続は 8443 を使用します。
- ポート 9000 と 9440 は、ClickHouse ネイティブ TCP コマンドラインクライアントによってデフォルトで使用されますが、Looker が ClickHouse に接続するには HTTP(S) ポートを使用する必要があります。
- ClickHouse 管理者が、ClickHouse 構成の http_port または https_port 設定で代替ポートを選択した可能性があります。構成に適した設定については、ClickHouse 管理者にお問い合わせください。
データベース: データベース名（ClickHouse 権限で許可されているデータベースのいずれかである必要があります）。
ユーザー名: データベースのユーザー名。
パスワード: データベースのパスワード。
SSL: チェックすると、SSL/TLS を介して ClickHouse に接続されます。
SSL を確認: （省略可）チェックすると、ClickHouse サーバーに厳密な SSL 証明書とホスト名の検証が適用されます。一般的に信頼されている認証局によって署名された SSL 証明書を使用している場合にのみ、[SSL を確認] を選択します。自己署名 SSL 証明書を使用している場合は、この設定をオフのままにします。
その他の JDBC パラメータ: （省略可）JDBC 文字列の追加パラメータ。Looker でサポートされているパラメータのリストについては、このページのサポートされている JDBC パラメータのセクションをご覧ください。

接続が成功したことを確認するには、[接続設定] ページの下部にある [ステータスの詳細] セクションの [接続をテスト] ボタンをクリックします。

Looker に [接続可能] と表示されたら、[接続] を押して接続を作成します。

これで、データベース接続が Looker の [接続] [管理] ページのリストに追加されます。

サポートされている JDBC パラメータ

ClickHouse の場合、Looker は接続の [**その他の JDBC パラメータ**] フィールドで次の JDBC パラメータをサポートしています。これらのパラメータについては、データベースのドキュメントをご覧ください。

ClickHouse 26+ パラメータ

async_insert
autoCommit
compress
compress_algorithm
compress_level
connect_timeout
connection_timeout
continueBatchOnError
createDatabaseIfNotExist
custom_settings
database
databaseTerm
externalDatabase
fetchSize
format
jdbcCompliant
keep_alive_timeout
max_buffer_size
max_execution_time
max_result_bytes
max_result_rows
max_threads
namedParameter
query_timeout
receive_timeout
result_overflow_mode
retry
session_check
session_id
session_timeout
session_timezone
socket_timeout
ssl
sslmode
transactionSupport
use_server_time_zone
use_time_zone
wait_for_async_insert
wrapperObject

ClickHouse（レガシー）パラメータ

beta.row_binary_for_simple_insert
compress
connection_timeout
continueBatchOnError
createDatabaseIfNotExist
custom_http_headers
custom_http_params
default_query_settings
disable_frameworks_detection
jdbc_ignore_unsupported_values
jdbc_resultset_auto_close
jdbc_sql_parser
jdbc_use_max_result_rows
jdbcCompliance
max_execution_time
password
session_timezone
socket_timeout
typeMappings
use_server_time_zone
use_time_zone
user
wrapperObject

機能のサポート

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

ClickHouse 26+ の機能サポート

ClickHouse 26+ は、Looker 26.20 の時点で、次の機能をサポートしています。

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

ClickHouse の機能サポート

ClickHouse は、Looker 26.20 の時点で、次の機能をサポートしています。

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

次のステップ

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

ClickHouse コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。