Conectando o Embeddable ao ClickHouse - ClickHouse Documentation

Parâmetro(s)	Descrição
`HOST` and `PORT`	Normalmente, a porta é 8443 ao usar TLS ou 8123 quando não se usa TLS.
`DATABASE NAME`	Por padrão, há um banco de dados chamado `default`; use o nome do banco de dados ao qual você deseja se conectar.
`USERNAME` and `PASSWORD`	Por padrão, o nome de usuário é `default`. Use o nome de usuário apropriado para o seu caso de uso.

Parâmetro(s)

Descrição

HOST and PORT

Normalmente, a porta é 8443 ao usar TLS ou 8123 quando não se usa TLS.

DATABASE NAME

Por padrão, há um banco de dados chamado default; use o nome do banco de dados ao qual você deseja se conectar.

USERNAME and PASSWORD

Por padrão, o nome de usuário é default. Use o nome de usuário apropriado para o seu caso de uso.

Crie um tipo de conexão do ClickHouse

Adicione uma conexão de banco de dados usando a API Embeddable. Essa conexão é usada para se conectar ao seu serviço ClickHouse. Você pode adicionar uma conexão com a seguinte chamada de API:

Query

// por razões de segurança, isso *nunca* deve ser chamado do lado do cliente
fetch('https://api.embeddable.com/api/v1/connections', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Accept: 'application/json',
    Authorization: `Bearer ${apiKey}` /* mantenha sua API Key segura */,
  },
  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 }

O item acima representa uma ação CREATE, mas todas as operações CRUD estão disponíveis.A apiKey pode ser encontrada clicando em “Publish” em um dos seus dashboards no Embeddable.O name é um nome exclusivo para identificar esta conexão.

Por padrão, seus Modelos de Dados procurarão uma conexão chamada “default”, mas você pode fornecer aos seus modelos diferentes nomes de data_source para permitir conectar diferentes modelos de dados a diferentes conexões (basta especificar o nome de data_source no modelo)

O type informa ao Embeddable qual driver usar

Aqui, o ideal é usar clickhouse, mas você pode conectar várias fontes de dados diferentes a um workspace do Embeddable, então também pode usar outras, como: postgres, bigquery, mongodb, etc.

As credentials são um objeto JavaScript que contém as credenciais necessárias esperadas pelo driver

Elas são criptografadas com segurança e usadas apenas para recuperar exatamente os dados que você descreveu nos seus modelos de dados. O Embeddable recomenda fortemente que você crie um usuário do banco de dados com acesso somente leitura para cada conexão (o Embeddable apenas lerá do seu banco de dados, nunca gravará).

Para oferecer suporte à conexão com diferentes bancos de dados para prod, qa, test etc. (ou para oferecer suporte a diferentes bancos de dados para diferentes clientes), você pode atribuir cada conexão a um ambiente (consulte a API de Environments).