> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtenha os detalhes de conexão do Cloud

> Saiba como encontrar o hostname, a porta e as credenciais do seu serviço do ClickHouse Cloud para se conectar por clientes externos, CLIs e aplicativos.

export const e_1 = undefined

export const e_0 = undefined

<a href="/get-started/quickstarts/home" onClick={(e_0) => { e_0.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</a>

<div className="mt-2 flex flex-wrap gap-2">
  <Badge size="lg" color="blue">Analytics em tempo real</Badge>
  <Badge size="lg" color="blue">Armazenamento de dados</Badge>
  <Badge size="lg" color="blue">Observabilidade</Badge>
  <Badge size="lg" color="blue">AI/ML</Badge>
  <Badge size="lg" color="orange">Cloud</Badge>
</div>

<div id="prerequisites">
  ## Pré-requisitos
</div>

To successfully follow this guide, you'll need the following:

* A running ClickHouse Cloud service. If you don't have one yet, complete the [ClickHouse Cloud quick start](/get-started/setup/cloud) first.

Você também deve ter concluído o [Início rápido do ClickHouse Cloud](/pt-BR/get-started/setup/cloud), pois precisará de um serviço existente do ClickHouse Cloud para obter os detalhes da conexão.

<div id="what-youll-build">
  ## O que você vai criar
</div>

Neste guia de início rápido, você aprenderá a localizar os detalhes de conexão do seu serviço ClickHouse Cloud — o hostname, os números de porta, o nome de usuário e a senha necessários para se conectar a partir de qualquer cliente externo, ferramenta de CLI ou aplicativo.
Ao final, você saberá onde encontrar esses detalhes no ClickHouse Cloud console e como verificar a conectividade usando um comando `curl` simples, ficando pronto para se conectar com ferramentas como `clickhouse-local`, `clickhouse-client` ou qualquer driver do ClickHouse.

<Steps titleSize="h3">
  <Step title="Abra o ClickHouse Cloud console" id="open-the-cloud-console">
    Acesse o [ClickHouse Cloud console](https://console.clickhouse.cloud/) e entre na sua conta.

    No dashboard principal, localize o serviço ao qual você quer se conectar. Se o serviço estiver inativo, clique nele e aguarde até que volte a ficar ativo antes de prosseguir — ele precisará estar em execução para que você verifique a conectividade em uma etapa posterior.
  </Step>

  <Step title="Encontre seus detalhes de conexão" id="find-your-connection-details">
    Clique no seu serviço para abrir a página de detalhes e, em seguida, clique no botão **Connect** na barra lateral esquerda:

    <img className="block dark:hidden w-2/3 mx-auto" src="https://mintcdn.com/private-7c7dfe99-detect-table-modification/bx6sZ_fx0ABo_aFe/images/get-started/quickstarts/connect-light.webp?fit=max&auto=format&n=bx6sZ_fx0ABo_aFe&q=85&s=20d401a22a74aeee0c437095fab139ad" alt="Botão Connect no ClickHouse Cloud console (modo claro)" width="1050" height="964" data-path="images/get-started/quickstarts/connect-light.webp" />

    <img className="hidden dark:block w-2/3 mx-auto" src="https://mintcdn.com/private-7c7dfe99-detect-table-modification/bx6sZ_fx0ABo_aFe/images/get-started/quickstarts/connect-dark.webp?fit=max&auto=format&n=bx6sZ_fx0ABo_aFe&q=85&s=44f74a745e73ff9afc27b5ca076b0f2c" alt="Botão Connect no ClickHouse Cloud console (modo escuro)" width="1034" height="960" data-path="images/get-started/quickstarts/connect-dark.webp" />

    Na primeira vez que você clicar nesse botão, verá uma caixa de diálogo com suas credenciais:

    | Detalhe             | Descrição                                   |
    | ------------------- | ------------------------------------------- |
    | **Nome de usuário** | Seu nome de usuário (normalmente `default`) |
    | **Senha**           | A senha gerada para o seu serviço           |

    Também há um menu suspenso com exemplos de strings de conexão pré-formatadas para diferentes protocolos e interfaces (por exemplo, `clickhouse-client`, HTTPS, JDBC etc.), que você pode copiar diretamente.

    <Warning>
      Baixe o arquivo de credenciais ou copie sua senha e armazene-a em um local seguro. Depois que você fechar essa caixa de diálogo, não será mais possível visualizar a senha.
    </Warning>

    Você também encontrará o **hostname** do seu serviço na página de detalhes do serviço (por exemplo, `abc123.us-east-1.aws.clickhouse.cloud`). Copie-o junto com suas credenciais — você precisará de ambos nas etapas restantes e nos próximos guias de início rápido.

    <Note>
      Se você perdeu sua senha, pode redefini-la na aba **Settings** do seu serviço no ClickHouse Cloud console.
    </Note>
  </Step>

  <Step title="Entenda os protocolos de conexão" id="understand-the-connection-protocols">
    O ClickHouse Cloud expõe dois protocolos de rede principais, cada um em sua própria porta:

    * **Native protocol (port 9440)** - Um protocolo binário usado por `clickhouse-client`, `clickhouse-local` e pela maioria dos drivers específicos de linguagem. É a opção mais rápida e oferece suporte a todos os recursos do ClickHouse. TLS é obrigatório no Cloud.
    * **HTTPS protocol (port 8443)** - Uma interface baseada em HTTP útil para clientes REST, `curl`, ferramentas baseadas na web e drivers que preferem HTTP. Também requer TLS no Cloud.

    Ambos os protocolos exigem criptografia TLS ao se conectar ao ClickHouse Cloud — não é possível se conectar em plaintext. A maioria das ferramentas lida com isso automaticamente quando você especifica a porta correta, mas, dependendo do cliente, talvez seja necessário passar a flag `--secure` ou definir `ssl=true`.

    Na maioria dos guias de início rápido e fluxos de trabalho de CLI desta série, você usará o **native protocol na porta 9440**.
  </Step>

  <Step title="Salve seus detalhes de conexão para reutilização" id="save-your-connection-details-for-reuse">
    Você usará esses detalhes de conexão com frequência nos guias de início rápido. Para evitar digitá-los novamente sempre, você pode exportá-los como variáveis de ambiente na sua sessão de terminal:

    ```bash theme={null}
    export CLICKHOUSE_HOST=YOUR_HOST.clickhouse.cloud
    export CLICKHOUSE_USER=default
    export CLICKHOUSE_PASSWORD=YOUR_PASSWORD
    ```

    Substitua os valores pelo seu hostname, nome de usuário e senha reais.
    Se você for se conectar ao seu serviço Cloud usando `clickhouse-client` ou `clickhouse-local`, obtenha o hostname selecionando 'Native' no menu suspenso ao lado de "Connect with:".
    Copie o hostname exibido após `--host` no exemplo de conexão mostrado.

    <Warning>
      Essas variáveis de ambiente persistem apenas durante a sessão atual do terminal. Não armazene senhas em arquivos de perfil do shell (`.bashrc`, `.zshrc`) nem faça commit delas no controle de versão.
    </Warning>
  </Step>
</Steps>

<div id="next-steps">
  ## Próximos passos
</div>

Agora você tem todos os detalhes de conexão necessários para se conectar ao seu serviço do ClickHouse Cloud usando qualquer ferramenta externa. O hostname, a porta, o nome de usuário e a senha que você encontrou aqui serão usados ao longo do restante desta série de guias de início rápido.

Confira a seguir estes guias de início rápido:

* [Inserir dados usando clickhouse-client](/pt-BR/get-started/quickstarts/insert-data-using-clickhouse-client)
* [Criar sua primeira tabela MergeTree](/pt-BR/get-started/quickstarts/create-your-first-mergetree-table)

Ou consulte a documentação de referência para se aprofundar:

* [Interface nativa (TCP)](/pt-BR/concepts/features/interfaces/tcp)
* [Interface HTTP](/pt-BR/concepts/features/interfaces/http)

<Frame caption="Check out the ClickHouse academy for on-demand and live training">
  <a href="https://learn.clickhouse.com/" target="_blank">
    <img src="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/academy.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=e0e4eec168afb603fb3c92ff4ea7dc56" alt="ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level" width="560" noZoom data-path="images/academy.webp" />
  </a>
</Frame>

<div className="mt-8">
  <a href="/get-started/quickstarts/home" onClick={(e_1) => { e_1.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</a>
</div>