将 Embeddable 连接到 ClickHouse - ClickHouse Documentation

Parameter(s)	Description
`HOST` and `PORT`	通常，使用 TLS 时端口为 8443；不使用 TLS 时端口为 8123。
`DATABASE NAME`	默认情况下，存在一个名为 `default` 的数据库。请使用你要连接的数据库名称。
`USERNAME` and `PASSWORD`	默认情况下，用户名为 `default`。请根据你的使用场景使用相应的用户名。

Parameter(s)

Description

HOST and PORT

通常，使用 TLS 时端口为 8443；不使用 TLS 时端口为 8123。

DATABASE NAME

默认情况下，存在一个名为 default 的数据库。请使用你要连接的数据库名称。

USERNAME and PASSWORD

默认情况下，用户名为 default。请根据你的使用场景使用相应的用户名。

创建 ClickHouse 连接类型

你可以使用 Embeddable API 添加数据库连接。该连接用于连接到你的 ClickHouse 服务。你可以通过以下 API 调用添加连接：

Query

// 出于安全原因，此操作*绝对不能*从客户端调用
fetch('https://api.embeddable.com/api/v1/connections', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Accept: 'application/json',
    Authorization: `Bearer ${apiKey}` /* 请妥善保管您的 API Key */,
  },
  body: JSON.stringify({
    name: 'my-clickhouse-db',
    type: 'clickhouse',
    credentials: {
      host: 'my.clickhouse.host',
      user: 'clickhouse_user',
      port: 8443,
      password: '*****',
    },
  }),
});

Response

Status 201 { errorMessage: null }

上述内容表示一个 CREATE 操作，但所有 CRUD 操作都可用。点击某个 Embeddable 仪表盘上的 “Publish”，即可找到 apiKey。name 是用于标识此连接的唯一名称。

默认情况下，你的数据模型会查找名为 “default” 的连接，但你也可以为模型提供不同的 data_source 名称，以支持将不同的数据模型连接到不同的连接 (只需在模型中指定 data_source 名称) 。

type 用于告诉 Embeddable 应使用哪个驱动程序

这里应使用 clickhouse，但你也可以将多个不同的数据源连接到同一个 Embeddable 工作区，因此也可以使用其他类型，例如：postgres、bigquery、mongodb 等。

credentials 是一个 JavaScript 对象，包含驱动程序所需的凭据

这些信息会被安全加密，并且仅用于检索你在数据模型中定义的数据。 Embeddable 强烈建议你为每个连接创建一个只读数据库用户 (Embeddable 只会从你的数据库中读取，不会写入) 。

为了支持连接到用于 prod、qa、test 等环境的不同数据库 (或为不同客户使用不同的数据库) ，你可以将每个连接分配给一个环境 (参见 Environments API) 。