> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> O Amazon QuickSight oferece inteligência de negócios (BI) unificada para organizações orientadas por dados.
# QuickSight
export const ClickHouseSupportedBadge = () => {
return
Suportado pelo ClickHouse
;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
O QuickSight pode se conectar a uma instalação on-premise do ClickHouse (23.11+) pela interface MySQL, usando a fonte de dados oficial do MySQL e o modo Direct Query.
## Configuração do servidor ClickHouse on-premise
Consulte [a documentação oficial](/pt-BR/concepts/features/interfaces/mysql) para saber como configurar um servidor ClickHouse com a interface MySQL habilitada.
Além de adicionar uma entrada ao `config.xml` do servidor
```xml theme={null}
9004
```
também é *obrigatório* usar [criptografia de senha Double SHA1](/pt-BR/concepts/features/configuration/settings/settings-users#user-namepassword) para o usuário que usará a interface MySQL.
Gerando uma senha aleatória criptografada com Double SHA1 no shell:
```shell theme={null}
PASSWORD=$(base64 < /dev/urandom | head -c16); echo "$PASSWORD"; echo -n "$PASSWORD" | sha1sum | tr -d '-' | xxd -r -p | sha1sum | tr -d '-'
```
A saída deve ser semelhante ao exemplo abaixo:
```text theme={null}
LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4
```
A primeira linha é a senha gerada, e a segunda é o hash que podemos usar para configurar o ClickHouse.
Aqui está um exemplo de configuração para `mysql_user` que usa o hash gerado:
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
fbc958cc745a82188a51f30de69eebfc67c40ee4
::/0
default
default
```
Substitua a entrada `password_double_sha1_hex` pelo hash Double SHA1 gerado por você.
O QuickSight exige várias configurações adicionais no perfil do usuário MySQL.
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
1
1
1
```
No entanto, recomenda-se atribuí-lo a um perfil diferente, que seu usuário MySQL possa usar, em vez do perfil padrão.
Por fim, configure o servidor ClickHouse para ouvir no(s) endereço(s) IP desejado(s).
Em `config.xml`, descomente o trecho a seguir para ouvir em todos os endereços:
```bash theme={null}
::
```
Se você tiver o binário `mysql` disponível, poderá testar a conexão pela linha de comando.
Usando o nome de usuário de exemplo (`mysql_user`) e a senha (`LZOQYnqQN4L/T6L0`) mencionados acima, o comando seria:
```bash theme={null}
mysql --protocol tcp -h localhost -u mysql_user -P 9004 --password=LZOQYnqQN4L/T6L0
```
```response theme={null}
mysql> show databases;
+--------------------+
| name |
+--------------------+
| INFORMATION_SCHEMA |
| default |
| information_schema |
| system |
+--------------------+
4 rows in set (0.00 sec)
Read 4 rows, 603.00 B in 0.00156 sec., 2564 rows/sec., 377.48 KiB/sec.
```
## Conectando o QuickSight ao ClickHouse
Antes de tudo, acesse [https://quicksight.aws.amazon.com](https://quicksight.aws.amazon.com), vá até Datasets e clique em "New dataset":
Procure o conector oficial MySQL incluído no QuickSight (chamado simplesmente de **MySQL**):
Informe os detalhes da conexão. Observe que a porta da interface MySQL é 9004 por padrão,
e ela pode ser diferente dependendo da configuração do seu servidor.
Agora, você tem duas opções para buscar os dados do ClickHouse. Primeiro, pode selecionar uma tabela da lista:
Como alternativa, você pode especificar um SQL personalizado para buscar seus dados:
Ao clicar em "Edit/Preview data", você poderá ver a estrutura da tabela analisada ou ajustar seu SQL personalizado, caso tenha decidido acessar os dados dessa forma:
Certifique-se de que o modo "Direct Query" esteja selecionado no canto inferior esquerdo da UI:
Agora você pode prosseguir com a publicação do seu conjunto de dados e a criação de uma nova visualização!
## Limitações conhecidas
* A importação do SPICE não funciona como esperado; use o modo Direct Query. Veja [#58553](https://github.com/ClickHouse/ClickHouse/issues/58553).