埋め込み可能をClickHouseに接続する

埋め込み可能では、コード内でデータモデルとコンポーネントを定義し（自身のコードリポジトリに保存）、私たちのSDKを使用して、強力な埋め込み可能ノーコードビルダーにチームのためにこれらを利用可能にします。

最終的な結果は、商品チームが設計し、エンジニアリングチームが構築し、顧客対応チームおよびデータチームによって維持される形で直接商品内で高速でインタラクティブな顧客向け分析を提供する能力です。まさにそれが求められる方法です。

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

1. 接続詳細を収集する

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

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

HTTPSを選択すると、詳細は例のcurlコマンドに表示されます。

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

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

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

apiKeyは、あなたの埋め込み可能ダッシュボードの1つで「公開」をクリックすることで見つけることができます。

nameはこの接続を識別するためのユニークな名前です。

デフォルトでは、データモデルは「default」と呼ばれる接続を探しますが、異なる接続に異なるdata_source名を指定することで、異なるデータモデルを異なる接続に接続できます（モデル内でdata_source名を単に指定してください）。

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

ここではclickhouseを使用したいですが、1つの埋め込み可能なワークスペースに複数の異なるデータソースを接続できるので、他のソース（例えば：postgres、bigquery、mongodbなど）を使用することもできます。

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

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

本番、QA、テストなどの異なるデータベースに接続することをサポートするために（または異なる顧客のために異なるデータベースをサポートするために）、各接続に環境を割り当てることができます（[環境API](https://www.notion.so/Environments-API-497169036b5148b38f7936aa75e62949?pvs=21）を参照してください）。