> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Luzmo é uma plataforma de analytics embutida com integração nativa com o ClickHouse, desenvolvida especificamente para aplicações de software e SaaS.
# Integrando o Luzmo ao ClickHouse
export const CommunityMaintainedBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
Para se conectar ao ClickHouse, acesse a **página Connections**, selecione **New Connection** e, em seguida, escolha o ClickHouse no modal **New Connection**.
Será solicitado que você informe um **host**, **nome de usuário** e **senha**:
* **Host**: este é o host em que seu banco de dados ClickHouse está exposto. Observe que apenas `https` é aceito aqui para transferir dados com segurança pelo wire. A estrutura esperada da URL do host é: `https://url-to-clickhouse-db:port/database`
Por padrão, o plugin se conectará ao banco de dados 'default' e à porta 443. Ao informar um banco de dados após a '/', você pode configurar a qual banco de dados se conectar.
* **Username**: o nome de usuário que será usado para se conectar ao seu cluster ClickHouse.
* **Password**: a senha para se conectar ao seu cluster ClickHouse
Consulte os exemplos em nossa documentação para desenvolvedores para saber como [criar uma conexão com o ClickHouse](https://developer.luzmo.com/api/createAccount?exampleSection=AccountCreateClickhouseRequestBody) por meio da nossa API.
Depois de conectar o ClickHouse, você pode adicionar datasets conforme explicado [aqui](https://academy.luzmo.com/article/ldx3iltg). Você pode selecionar um ou mais datasets disponíveis no ClickHouse e [vinculá-los](https://academy.luzmo.com/article/gkrx48x5) no Luzmo para garantir que possam ser usados juntos em um dashboard. Confira também este artigo sobre [Como preparar seus dados para analytics](https://academy.luzmo.com/article/u492qov0).
Para saber como adicionar datasets usando nossa API, consulte [este exemplo em nossa documentação para desenvolvedores](https://developer.luzmo.com/api/createDataprovider?exampleSection=DataproviderCreateClickhouseRequestBody).
Agora você pode usar seus datasets para criar dashboards bonitos (embutidos) ou até mesmo viabilizar um analista de dados com IA ([Luzmo IQ](https://luzmo.com/iq)) capaz de responder às perguntas dos seus clientes.
## Notas de uso
1. O conector ClickHouse do Luzmo usa a interface da API HTTP (normalmente executada na porta 8123) para se conectar.
2. Se você usar tabelas com o mecanismo de tabela `Distributed`, alguns gráficos do Luzmo poderão falhar quando `distributed_product_mode` estiver definido como `deny`. No entanto, isso só deve ocorrer se você vincular a tabela com outra tabela e usar esse vínculo em um gráfico. Nesse caso, defina `distributed_product_mode` como outra opção que faça sentido no seu cluster ClickHouse. Se estiver usando ClickHouse Cloud, você pode ignorar essa configuração com segurança.
3. Para garantir que, por exemplo, somente o aplicativo Luzmo possa acessar sua instância do ClickHouse, é altamente recomendável **incluir na lista de permissões** a [faixa de endereços IP estáticos do Luzmo](https://academy.luzmo.com/article/u9on8gbm). Também recomendamos usar um usuário técnico somente leitura.
4. Atualmente, o conector ClickHouse oferece suporte aos seguintes tipos de dados:
| Tipo do ClickHouse | Tipo do Luzmo |
| ------------------ | ------------- |
| UInt | numeric |
| Int | numeric |
| Float | numeric |
| Decimal | numeric |
| Date | datetime |
| DateTime | datetime |
| String | hierarchy |
| Enum | hierarchy |
| FixedString | hierarchy |
| UUID | hierarchy |
| Bool | hierarchy |