メインコンテンツまでスキップ
メインコンテンツまでスキップ

Looker

Community Maintained

Lookerは、公式のClickHouseデータソースを介して、ClickHouse Cloudまたはオンプレミス展開に接続できます。

1. 接続詳細を収集する

To connect to ClickHouse with HTTP(S) you need this information:

  • The HOST and PORT: typically, the port is 8443 when using TLS or 8123 when not using TLS.

  • The DATABASE NAME: out of the box, there is a database named default, use the name of the database that you want to connect to.

  • The USERNAME and PASSWORD: out of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select the service that you will connect to and click Connect:

ClickHouse Cloud service connect button

Choose HTTPS, and the details are available in an example curl command.

ClickHouse Cloud HTTPS connection details

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.


以下は、ClickHouseにHTTP(S)で接続するために必要な情報です:

  • HOSTとPORT: 通常、TLSを使用する場合はポートが8443、使用しない場合は8123です。

  • DATABASE NAME: デフォルトでは、defaultという名前のデータベースがあります。接続したいデータベースの名前を使用します。

  • USERNAMEとPASSWORD: デフォルトでは、ユーザー名はdefaultです。使用ケースに適したユーザー名を使用します。

ClickHouse Cloudサービスの詳細は、ClickHouse Cloudコンソールで確認できます。 接続するサービスを選択し、Connectをクリックしてください:

ClickHouse Cloud service connect button

HTTPSを選択すると、詳細はexample curlコマンドで確認できます。

ClickHouse Cloud HTTPS connection details

セルフマネージドのClickHouseを使用している場合は、接続の詳細がClickHouse管理者によって設定されます。

2. ClickHouseデータソースを作成する

Admin -> Database -> Connectionsに移動し、右上の「Add Connection」ボタンをクリックします。

Lookerのデータベース管理インターフェースで新しい接続を追加する

データソースの名前を選択し、ダイアレクトのドロップダウンからClickHouseを選択します。フォームにあなたの資格情報を入力してください。

Looker接続フォームでのClickHouseの資格情報の指定

ClickHouse Cloudを使用している場合や、デプロイメントでSSLが必要な場合は、追加設定でSSLをオンにしてください。

Looker設定でのClickHouse接続のためのSSLを有効にする

最初に接続テストを行い、完了したら、新しいClickHouseデータソースに接続します。

ClickHouseデータソースのテストと接続

これで、LookerプロジェクトにClickHouseデータソースを添付できるようになるはずです。

3. 既知の制限事項

  1. 次のデータ型はデフォルトで文字列として処理されます:
    • Array - JDBCドライバの制限によりシリアル化が期待通りに動作しません
    • Decimal* - モデル内で数値に変更できます
    • LowCardinality(...) - モデル内で適切な型に変更できます
    • Enum8, Enum16
    • UUID
    • Tuple
    • Map
    • JSON
    • Nested
    • FixedString
    • Geo types
      • MultiPolygon
      • Polygon
      • Point
      • Ring
  2. 対称集約機能はサポートされていません
  3. 完全外部結合はまだドライバで実装されていません