> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Documentação da interface SSH do ClickHouse
# Interface SSH com PTY
export const CloudNotSupportedBadge = () => {
return
Sem suporte no ClickHouse Cloud
;
};
export const ExperimentalBadge = () => {
return ;
};
## Prefácio
O servidor ClickHouse permite conexão direta a si mesmo usando o protocolo SSH. Qualquer cliente é aceito.
Depois de criar um [usuário do banco de dados identificado por uma chave SSH](/pt-BR/resources/support-center/knowledge-base/cloud-services/how-to-connect-to-ch-cloud-using-ssh-keys):
```sql theme={null}
CREATE USER abcuser IDENTIFIED WITH ssh_key BY KEY '' TYPE 'ssh-ed25519';
```
Você pode usar esta chave para se conectar a um servidor ClickHouse. Será aberto um pseudoterminal (PTY) com uma sessão interativa do clickhouse-client.
```bash theme={null}
> ssh -i ~/test_ssh/id_ed25519 abcuser@localhost -p 9022
ClickHouse embedded version 25.1.1.1.
ip-10-1-13-116.us-west-2.compute.internal :) SELECT 1;
SELECT 1
Query id: cdd91b7f-215b-4537-b7df-86d19bf63f64
┌─1─┐
1. │ 1 │
└───┘
1 row in set. Elapsed: 0.002 sec.
```
A execução de comandos via SSH (modo não interativo) também é suportada:
```bash theme={null}
> ssh -i ~/test_ssh/id_ed25519 abcuser@localhost -p 9022 "select 1"
1
```
## Configuração do servidor
Para habilitar o recurso de servidor SSH, você precisa descomentar ou adicionar a seção a seguir ao seu `config.xml`:
```xml theme={null}
9022
path-to-the-key
```
A chave do host é parte essencial do protocolo SSH. A parte pública dessa chave é armazenada no arquivo `~/.ssh/known_hosts`, no lado do cliente, e normalmente é necessária para evitar ataques do tipo man-in-the-middle. Ao se conectar ao servidor pela primeira vez, você verá a mensagem abaixo:
```shell theme={null}
The authenticity of host '[localhost]:9022 ([127.0.0.1]:9022)' can't be established.
RSA key fingerprint is SHA256:3qxVlJKMr/PEKw/hfeg06HAK451Tt0eenhwqQvh58Do.
This key is not known by any other names
Are you sure you want to continue connecting (yes/no/[fingerprint])?
```
Isso, na verdade, significa: "Você deseja salvar a chave pública deste host e continuar a conexão?".
Você pode instruir seu cliente SSH a não verificar o host passando uma opção:
```bash theme={null}
ssh -o "StrictHostKeyChecking no" user@host
```
## Configurando o cliente embutido
Você pode passar opções para um cliente embutido de forma semelhante ao `clickhouse-client` comum, mas com algumas limitações.
Como este é um protocolo SSH, a única forma de passar parâmetros para o host de destino é por meio de variáveis de ambiente.
Por exemplo, é possível definir o `format` desta forma:
```bash theme={null}
> ssh -o SetEnv="format=Pretty" -i ~/test_ssh/id_ed25519 abcuser@localhost -p 9022 "SELECT 1"
┏━━━┓
┃ 1 ┃
┡━━━┩
1. │ 1 │
└───┘
```
É possível alterar qualquer configuração no nível do usuário dessa forma e, além disso, passar a maioria das opções comuns do `clickhouse-client` (exceto as que não fazem sentido nessa configuração.)
Importante:
Caso sejam passados tanto a opção `query` quanto o comando SSH, este último será adicionado à lista de consultas a serem executadas:
```bash theme={null}
ubuntu ip-10-1-13-116@~$ ssh -o SetEnv="format=Pretty query=\"SELECT 2;\"" -i ~/test_ssh/id_ed25519 abcuser@localhost -p 9022 "SELECT 1"
┏━━━┓
┃ 2 ┃
┡━━━┩
1. │ 2 │
└───┘
┏━━━┓
┃ 1 ┃
┡━━━┩
1. │ 1 │
└───┘
```