连接 Embeddable 和 ClickHouse
在 Embeddable 中,您在代码中定义 数据模型 和 组件(存储在您自己的代码库中),并使用我们的 SDK 将这些内容提供给您的团队,在强大的 Embeddable 无代码构建器 中使用。
最终的结果是能够在您的产品中直接提供快速、交互式的面向客户的分析;由您的产品团队设计;由您的工程团队构建;由您的客户和数据团队维护。正是应该如此。
内置的行级安全性意味着每个用户只能看到他们被允许查看的数据。而两个级别的完全可配置缓存意味着您可以在规模上提供快速、实时的分析。
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 仪表板上的 "发布" 来找到。
name
是唯一标识此连接的名称。
- 默认情况下,您的数据模型将查找名为 "default" 的连接,但您可以为您的模型提供不同的
data_source
名称,以支持将不同的数据模型连接到不同的连接(只需在模型中指定数据源名称)
type
告诉 Embeddable 使用哪个驱动程序
- 这里您将想要使用
clickhouse
,但您可以将多个不同的数据源连接到一个 Embeddable 工作区,因此您可能会使用其他数据源,比如:postgres
、bigquery
、mongodb
等。
credentials
是一个 JavaScript 对象,包含驱动程序所期望的必要凭据
- 这些凭据经过安全加密,仅用于检索您在数据模型中描述的确切数据。 Embeddable 强烈建议您为每个连接创建一个只读数据库用户(Embeddable 仅会从您的数据库读取,而不会写入)。
为了支持连接到用于生产、QA、测试等的不同数据库(或支持不同客户使用不同数据库),您可以将每个连接分配给一个环境(请参阅 Environments API)。