Conectar o ProbeDeck ao ClickHouse

O ProbeDeck é um cliente para iOS e iPadOS que permite verificar a integridade de um servidor ClickHouse, inspecionar as tabelas system e executar SQL. Ele se conecta à interface HTTP do ClickHouse pela rede do dispositivo ou por um bastion SSH; não requer um servidor de retransmissão.

• Instale o ProbeDeck pela App Store.
• Use iOS ou iPadOS 17.0 ou posterior.
• Permita que o dispositivo acesse o endpoint HTTP ou HTTPS do ClickHouse pela rede, por VPN ou por um bastion SSH.
• Crie um usuário do ClickHouse com acesso aos bancos de dados que deseja consultar.
• Conceda ao usuário acesso SELECT às tabelas system relevantes para monitoramento.

Algumas seções de monitoramento dependem de tabelas de log opcionais ou de tabelas system mais recentes. Por exemplo, system.server_settings, que o ProbeDeck usa para obter o limite de memória configurado, requer o ClickHouse 23.3 ou posterior. O ProbeDeck marca uma seção afetada como limitada quando sua fonte não está disponível.

1. O ProbeDeck envia solicitações SQL ao endpoint HTTP(S) do ClickHouse.
2. Ele lê dados de monitoramento das tabelas system usando o usuário configurado do ClickHouse.
3. O aplicativo exibe os resultados das consultas e as visualizações de monitoramento no dispositivo. Um bastion SSH pode encaminhar a mesma conexão HTTP(S) quando não há uma rota direta do dispositivo até o endpoint.

Obtenha os detalhes de conexão do serviço

No console do ClickHouse Cloud, abra seu serviço, selecione Connect e escolha HTTPS.

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.

Adicione a conexão no ProbeDeck

1. Na tela Connections, toque em +.
2. Insira um nome para a conexão e o host sem https://.
3. Defina Port como 8443 e ative TLS.
4. Insira o nome de usuário e a senha do banco de dados exibidos na caixa de diálogo Connect. O nome do banco de dados é opcional.
5. Toque em Test Connection. Após uma verificação bem-sucedida, o ProbeDeck exibe a versão do servidor e o tempo de ida e volta.
6. Toque em Save.

O ProbeDeck autentica solicitações SQL ao endpoint do serviço usando essas credenciais do banco de dados. O ClickHouse Cloud usa chaves no nível da organização, disponíveis na página API Keys, para a Cloud API e os endpoints da Query API. O fluxo de conexão SQL do ProbeDeck não usa essas chaves.

Ative o Túnel SSH no formulário de conexão e informe:

1. O host do bastion e a porta SSH (22 por padrão).
2. O nome de usuário SSH.
3. Uma senha SSH ou uma chave privada.

O ProbeDeck abre um canal SSH direct-tcpip do bastion para o host do ClickHouse e a porta HTTP(S) na seção Servidor. Na primeira conexão, compare a impressão digital SHA-256 da chave de host do bastion com um valor fornecido pelo administrador do servidor antes de aceitá-la.

O ProbeDeck envia o nome de usuário e a senha do banco de dados nos cabeçalhos da requisição X-ClickHouse-User e X-ClickHouse-Key. Ele não inclui credenciais na URL.

Para usar TLS mútuo, ative TLS Client Certificate e importe um arquivo PKCS#12 (.p12) que contenha o certificado do cliente e a chave privada. Em seguida, informe a frase secreta.

Quando um endpoint auto-hospedado apresenta um certificado autossinado ou emitido por uma CA privada, o ProbeDeck exibe sua impressão digital SHA-256, emissor, assunto e período de validade. Compare a impressão digital com o valor fornecido pelo administrador do servidor antes de aceitá-lo. O ProbeDeck vincula a decisão àquela conexão; uma alteração no certificado interrompe a conexão até que você a revise.

O ProbeDeck armazena os segredos de conexão e o material de chave importado no Keychain do iOS do dispositivo.

Abra a conexão salva e selecione Monitor. O dashboard resume as seguintes fontes:

Clique em consultas em execução para ordenar as consultas ativas por tempo decorrido e verificar o uso de memória e as linhas lidas.

Este exemplo usa o conjunto de dados de preços de imóveis do Reino Unido. Carregue o conjunto de dados em uk_price_paid e, em seguida:

1. Abra a conexão e selecione Data.
2. Abra o Editor SQL.
3. Execute esta consulta limitada e somente leitura:

SELECT
    town,
    count() AS sales,
    round(avg(price)) AS average_price
FROM uk_price_paid
GROUP BY town
ORDER BY sales DESC
LIMIT 10

O resultado deve conter dez cidades com suas respectivas quantidades de transações e preços médios.

• O ProbeDeck é executado no iOS e no iPadOS 17.0 ou posterior.
• Usuários da versão gratuita podem salvar uma conexão por vez. Excluí-la libera a vaga; o ProbeDeck Pro permite salvar conexões ilimitadas.
• Compatível com a interface HTTP(S) do ClickHouse, mas não com o protocolo nativo.
• O ProbeDeck carrega resultados SQL em páginas de 200 linhas e limita cada solicitação a 10.000 linhas. Use uma cláusula WHERE seletiva e LIMIT para tabelas grandes.
• A visibilidade do monitoramento depende das permissões do usuário do ClickHouse e das tabelas de log opcionais.
• O dispositivo precisa ter uma rota até o endpoint pela rede, por uma VPN ou pelo túnel SSH integrado.
• monitoramento e SQL somente leitura não exigem compra no aplicativo. KILL QUERY, KILL MUTATION, instruções de gravação e DDL e outras ações operacionais exigem o ProbeDeck Pro.

• Consulte o site do ProbeDeck para ver detalhes específicos do produto.
• Consulte a documentação da interface HTTP do ClickHouse para obter informações sobre a configuração do servidor.