Skip to main content
Esta página descreve as diferentes formas de se conectar aos seus serviços do ClickHouse no BYOC. Você pode escolher entre balanceadores de carga públicos, balanceadores de carga privados ou endpoints do PrivateLink/Private Service Connect, com base nos seus requisitos de segurança e rede.

​
Balanceador de carga público

Um balanceador de carga público fornece acesso aos seus serviços ClickHouse pela internet. Esta é a configuração padrão ao usar uma VPC dedicada gerenciada pela ClickHouse.

​
Visão geral

  • Acesso: Acessível pela internet pública
  • Caso de uso: Adequado para aplicações e usuários que precisam se conectar a partir de diferentes locais ou redes
  • Segurança: Protegido por criptografia TLS e filtragem por IP (recomendado)

​
Conexão via balanceador de carga público

Para se conectar ao seu serviço do ClickHouse usando o endpoint público:
  1. Obtenha o endpoint do seu serviço no ClickHouse Cloud console. O endpoint é exibido na seção “Connect” do seu serviço.
Por exemplo:

​
Filtragem por IP

A filtragem por IP (IP Access List) é altamente recomendada ao usar um balanceador de carga público para restringir o acesso a endereços IP ou intervalos CIDR autorizados. Para informações detalhadas sobre a filtragem por IP, consulte a documentação da IP Access List.

​
Balanceador de carga privado

Um balanceador de carga privado fornece acesso interno aos seus serviços ClickHouse, acessível apenas a partir das redes conectadas a ele (por exemplo, VPCs com peering). Essa é a configuração padrão ao usar uma VPC gerenciada pelo cliente.

​
Visão geral

  • Acesso: Acessível somente de dentro da sua infraestrutura de rede privada
  • Caso de uso: Ideal para aplicações executadas no mesmo ambiente de nuvem ou conectadas por VPC peering
  • Segurança: O tráfego permanece dentro da sua rede privada, sem exposição à internet pública

​
Conectando via balanceador de carga privado

Para se conectar usando o endpoint privado:
  1. Habilite o balanceador de carga privado (caso ainda não esteja habilitado). Entre em contato com o suporte do ClickHouse se precisar habilitar um balanceador de carga privado para sua implantação.
  2. Garanta a conectividade de rede:
    • Para VPC peering: conclua a configuração de VPC peering (consulte Configuração de rede privada)
    • Para outras redes privadas: garanta que o roteamento esteja configurado para alcançar a VPC do BYOC
  3. Obtenha seu endpoint privado: O endpoint privado está disponível no console do ClickHouse Cloud, na seção “Connect” do seu serviço. O endpoint privado segue o mesmo formato do endpoint público, mas com o sufixo -private adicionado à parte do ID do serviço. Por exemplo:
    • Endpoint público: sb9jmrq2ne.asf3kcggao.ap-southeast-1.aws.clickhouse-byoc.com
    • Endpoint privado: sb9jmrq2ne-private.asf3kcggao.ap-southeast-1.aws.clickhouse-byoc.com

​
Filtragem por IP

Embora os balanceadores de carga privados restrinjam o acesso apenas a redes internas, ainda é possível configurar a filtragem por IP para ter um controle ainda mais granular sobre quais origens dentro da sua rede privada podem se conectar. A filtragem por IP para balanceadores de carga privados usa o mesmo mecanismo de configuração dos balanceadores de carga públicos: defina os endereços IP ou intervalos CIDR permitidos, e o ClickHouse Cloud aplicará essas regras adequadamente a cada tipo de endpoint. A plataforma distingue automaticamente entre intervalos CIDR públicos e privados e os atribui aos endpoints de balanceador de carga correspondentes. Consulte a documentação da IP Access List.

​
Configuração do Security Group

Para implantações na AWS, o security group do balanceador de carga privado controla quais redes podem acessar o endpoint. Por padrão, somente o tráfego originado dentro da VPC do BYOC é permitido. Para mais detalhes, consulte a configuração do Security Group do balanceador de carga privado. O AWS PrivateLink e o GCP Private Service Connect oferecem a opção de conectividade mais segura, permitindo acessar serviços do ClickHouse de forma privada, sem VPC peering nem gateways de internet.

​
Visão geral

  • Acesso: Conectividade privada por meio do serviço gerenciado do provedor de Cloud
  • Isolamento de rede: O tráfego nunca passa pela internet pública
  • Caso de uso: Implantações Enterprise que exigem segurança máxima e isolamento de rede
  • Benefícios:
    • Não requer VPC peering
    • Arquitetura de rede simplificada
    • Postura de segurança e conformidade aprimorada
Conclua a configuração do PrivateLink ou do Private Service Connect (consulte Configuração de rede privada). Depois de concluir a configuração, você poderá se conectar ao seu serviço ClickHouse usando um formato de endpoint específico do PrivateLink. O endpoint do PrivateLink inclui um subdomínio vpce para indicar que o tráfego é roteado por meio do endpoint da VPC. A resolução de DNS na sua VPC roteia automaticamente o tráfego por meio do endpoint do PrivateLink. O formato do endpoint do PrivateLink é semelhante ao do endpoint público, mas inclui um subdomínio vpce entre o subdomínio do serviço e o subdomínio da infraestrutura BYOC. Por exemplo:
  • Endpoint público: h5ju65kv87.mhp0y4dmph.us-west-2.aws.clickhouse-byoc.com
  • Endpoint do PrivateLink: h5ju65kv87.vpce.mhp0y4dmph.us-west-2.aws.clickhouse-byoc.com

​
Lista de permissões de Endpoint ID

Para usar o PrivateLink ou o Private Service Connect, o Endpoint ID da conexão do cliente deve ser explicitamente permitido para cada serviço do ClickHouse. Entre em contato com o suporte do ClickHouse e informe seus Endpoint IDs para que eles possam ser adicionados à lista de permissões do serviço. Para instruções detalhadas de configuração, consulte o guia de configuração de rede privada.

​
Escolhendo o método de conexão adequado

​
Solução de problemas de conexão

Se você estiver enfrentando problemas de conexão:
  1. Verifique se o endpoint está acessível: Certifique-se de que está usando o endpoint correto (público ou privado)
  2. Verifique os filtros de IP: Para balanceadores de carga públicos, confirme se o seu endereço IP está na lista de permissões
  3. Verifique a conectividade de rede: Para conexões privadas, certifique-se de que o VPC peering ou o PrivateLink esteja configurado corretamente
  4. Verifique os Security Groups: Para balanceadores de carga privados, confirme se as regras do security group permitem tráfego da sua rede de origem
  5. Verifique os Security Groups: Para PrivateLink ou Private Service Connect, confirme se o Endpoint ID foi adicionado à lista de permissões do serviço ClickHouse
  6. Revise a autenticação: Certifique-se de que está usando as credenciais corretas (username e password)
  7. Entre em contato com o suporte: Se os problemas persistirem, entre em contato com o suporte do ClickHouse
Última modificação em 10 de junho de 2026