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

EmbeddableをClickHouseに接続する

Community Maintained

Embeddableでは、コード内でデータモデルとコンポーネントを定義し（自分自身のコードリポジトリに保存）、私たちのSDKを使用して、強力なEmbeddableノーコードビルダー内でチームにそれらを提供します。

最終的な結果は、製品内で迅速かつインタラクティブな顧客向け分析を提供できることです。これは、あなたのプロダクトチームによって設計され、エンジニアリングチームによって構築され、顧客対応チームとデータチームによって維持されます。正にあるべき姿です。

組み込まれた行レベルセキュリティにより、ユーザーは自身が見ることを許可されたデータのみを正確に確認できます。さらに、2つの完全に構成可能なキャッシュレベルによって、スケールにおいて迅速なリアルタイム分析を提供できます。

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:

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

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

ClickHouseにHTTP(S)で接続するには、次の情報が必要です：

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

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

  • USERNAMEとPASSWORD: デフォルトでは、ユーザー名はdefaultです。ご利用のケースに適したユーザー名を使用してください。

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

HTTPSを選択すると、詳細が例のcurlコマンドで提供されます。

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

2. ClickHouse接続タイプを作成する​

Embeddable APIを使用してデータベース接続を追加します。この接続はClickHouseサービスに接続するために使用されます。次のAPI呼び出しを使用して接続を追加できます。

上記はCREATEアクションを表しますが、すべてのCRUD操作が利用可能です。

apiKeyは、Embeddableダッシュボードの1つで「公開」をクリックすることで見つけることができます。

nameは、この接続を識別するための一意の名前です。

  • デフォルトではデータモデルは「default」という接続を探しますが、異なる接続に異なるデータモデルを接続するために、別のdata_source名をモデルに指定できます（モデル内でdata_source名を指定するだけです）。

typeは、Embeddableにどのドライバーを使用するかを伝えます。

  • ここではclickhouseを使用したいですが、Embeddableのワークスペースに異なるデータソースを複数接続できるので、他にもpostgres、bigquery、mongodbなどを使用できます。

credentialsは、ドライバーが必要とする資格情報を含むJavaScriptオブジェクトです。

  • これらは安全に暗号化され、データモデルで記述されたデータのみを取得するために使用されます。Embeddableは、各接続に対して読み取り専用のデータベースユーザーを作成することを強く推奨します（Embeddableはデータベースから読み取るだけで、書き込むことはありません）。

本番環境、QA、テストなどの異なるデータベースへの接続をサポートするために（または異なる顧客のために異なるデータベースをサポートするために）、各接続を環境に割り当てることができます（Environments APIを参照してください）。