Conectando o Embeddable ao ClickHouse - ClickHouse Documentation

No Embeddable, você define Modelos de Dados e Componentes em código (armazenado no seu próprio repositório de código) e usa nosso SDK para disponibilizá-los à sua equipe no poderoso builder no-code do Embeddable. O resultado final é a capacidade de oferecer análises rápidas e interativas voltadas para o cliente diretamente no seu produto; projetadas pela sua equipe de produto; desenvolvidas pela sua equipe de engenharia; mantidas pelas suas equipes de atendimento ao cliente e de dados. Exatamente como deve ser. A segurança em nível de linha integrada garante que cada usuário veja apenas os dados que tem permissão para ver. E dois níveis de cache totalmente configuráveis significam que você pode oferecer análises rápidas, em tempo real e em escala.

1. Reúna suas informações de conexão

Para se conectar ao ClickHouse via HTTP(S), você precisa das seguintes informações:

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.

Os detalhes do seu serviço do ClickHouse Cloud estão disponíveis no console do ClickHouse Cloud. Selecione um serviço e clique em Connect: Escolha HTTPS. Os detalhes de conexão são exibidos em um comando curl de exemplo. Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.

2. 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).

​1. Reúna suas informações de conexão

​2. Crie um tipo de conexão do ClickHouse

1. Reúna suas informações de conexão

2. Crie um tipo de conexão do ClickHouse