Embeddable을 ClickHouse에 연결하기 - ClickHouse Documentation

매개변수	설명
`HOST` and `PORT`	일반적으로 TLS를 사용하는 경우 포트는 8443, TLS를 사용하지 않는 경우 8123입니다.
`DATABASE NAME`	기본적으로 `default`라는 이름의 데이터베이스가 제공되며, 연결할 데이터베이스 이름을 사용하십시오.
`USERNAME` and `PASSWORD`	기본 사용자 이름은 `default`입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오.

매개변수

설명

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 작업을 사용할 수 있습니다.apiKey는 Embeddable 대시보드 중 하나에서 “Publish”를 클릭하면 확인할 수 있습니다.name은 이 연결을 식별하는 고유한 이름입니다.

기본적으로 데이터 모델은 “default”라는 연결을 찾습니다. 하지만 서로 다른 데이터 모델을 서로 다른 연결에 연결할 수 있도록 모델에 다른 data_source 이름을 지정할 수 있습니다(모델에서 data_source 이름만 지정하면 됩니다).

type은 Embeddable에서 어떤 드라이버를 사용할지 지정합니다

여기서는 clickhouse를 사용하면 되지만, 하나의 Embeddable 워크스페이스에 여러 데이터 소스를 연결할 수 있으므로 postgres, bigquery, mongodb 등 다른 유형도 사용할 수 있습니다.

credentials는 드라이버에 필요한 자격 증명을 포함하는 JavaScript 객체입니다

이 정보는 안전하게 암호화되며, 데이터 모델에 정의한 데이터를 정확히 가져오는 데만 사용됩니다. Embeddable은 각 연결마다 읽기 전용 데이터베이스 사용자를 생성할 것을 강력히 권장합니다(Embeddable은 데이터베이스에서 읽기만 하며, 쓰기는 하지 않습니다).

prod, qa, test 등 여러 환경의 서로 다른 데이터베이스에 연결해야 하거나(또는 고객별로 서로 다른 데이터베이스를 지원해야 하는 경우), 각 연결을 환경에 할당할 수 있습니다(Environments API 참조).