> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Embeddable es un kit de herramientas para desarrolladores que permite crear experiencias de analítica rápidas, interactivas y totalmente personalizadas directamente en tu aplicación.
# Conectar Embeddable con ClickHouse
export const CommunityMaintainedBadge = () => {
return ;
};
En [Embeddable](https://embeddable.com/) defines [Modelos de datos](https://docs.embeddable.com/data-modeling/introduction) y [Componentes](https://docs.embeddable.com/development/introduction) mediante código (almacenado en tu propio repositorio de código) y utilizas nuestro **SDK** para ponerlos a disposición de tu equipo en el potente **constructor no-code** de Embeddable.
El resultado final es que puedes ofrecer analíticas rápidas e interactivas orientadas al cliente directamente en tu producto; diseñadas por tu equipo de producto; desarrolladas por tu equipo de ingeniería; y mantenidas por tus equipos de atención al cliente y de datos. Exactamente como debe ser.
La seguridad integrada a nivel de fila garantiza que cada usuario solo vea exactamente los datos que tiene permiso para ver. Además, dos niveles de caché totalmente configurables te permiten ofrecer analíticas rápidas y en tiempo real a gran escala.
## 1. Reúne los datos de conexión
Para conectarse a ClickHouse con HTTP(S), necesita esta información:
| Parámetro(s) | Descripción |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT` | Normalmente, el puerto es 8443 cuando se usa TLS o 8123 cuando no se usa TLS. |
| `DATABASE NAME` | De forma predeterminada, existe una base de datos llamada `default`; use el nombre de la base de datos a la que desea conectarse. |
| `USERNAME` and `PASSWORD` | De forma predeterminada, el nombre de usuario es `default`. Use el nombre de usuario adecuado para su caso de uso. |
Los detalles de su servicio de ClickHouse Cloud están disponibles en la consola de ClickHouse Cloud.
Seleccione un servicio y haga clic en **Connect**:
Elija **HTTPS**. Los detalles de conexión se muestran en un comando `curl` de ejemplo.
Si usa ClickHouse autogestionado, los detalles de conexión los establece su administrador de ClickHouse.
## 2. Crear un tipo de conexión de ClickHouse
Añada una conexión a la base de datos mediante la Embeddable API. Esta conexión se utiliza para conectarse a su servicio de ClickHouse. Puede añadir una conexión mediante la siguiente llamada a la API:
```javascript title="Query" theme={null}
// por razones de seguridad, esto *nunca* debe llamarse desde el lado del cliente
fetch('https://api.embeddable.com/api/v1/connections', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Accept: 'application/json',
Authorization: `Bearer ${apiKey}` /* mantén tu API key segura */,
},
body: JSON.stringify({
name: 'my-clickhouse-db',
type: 'clickhouse',
credentials: {
host: 'my.clickhouse.host',
user: 'clickhouse_user',
port: 8443,
password: '*****',
},
}),
});
```
```text title="Response" theme={null}
Status 201 { errorMessage: null }
```
Lo anterior representa una acción `CREATE`, pero están disponibles todas las operaciones `CRUD`.
La `apiKey` se puede encontrar haciendo clic en "**Publish**" en uno de tus dashboards de Embeddable.
El `name` es un nombre único para identificar esta conexión.
* De forma predeterminada, tus modelos de datos buscarán una conexión llamada "default", pero puedes proporcionar a tus modelos distintos nombres de `data_source` para permitir que diferentes modelos de datos se conecten a distintas conexiones (solo tienes que especificar el nombre de data\_source en el modelo)
El `type` le indica a Embeddable qué driver debe usar
* Aquí querrás usar `clickhouse`, pero puedes conectar varias fuentes de datos diferentes a un mismo espacio de trabajo de Embeddable, por lo que también podrías usar otras como: `postgres`, `bigquery`, `mongodb`, etc.
Las `credentials` son un objeto de JavaScript que contiene las credenciales necesarias que espera el driver
* Estas se cifran de forma segura y solo se usan para recuperar exactamente los datos que has descrito en tus modelos de datos.
Embeddable te recomienda encarecidamente que crees un usuario de base de datos de solo lectura para cada conexión (Embeddable solo leerá de tu base de datos, no escribirá en ella).
Para permitir la conexión a diferentes bases de datos para prod, qa, test, etc. (o para usar diferentes bases de datos para distintos clientes), puedes asignar cada conexión a un entorno (consulta la [API de Environments](https://docs.embeddable.com/data/environments)).