Todos os produtos
Search
Central de documentação

Quick BI:Adicionar uma fonte de dados ClickHouse

Última atualização: Jun 27, 2026

Ao adicionar uma fonte de dados ClickHouse para conectar o banco de dados ClickHouse ao Quick BI, é possível analisar e visualizar dados no console do Quick BI. O Quick BI acessa o ClickHouse pela Internet ou por uma Virtual Private Cloud (VPC). Este tópico descreve como adicionar uma fonte de dados ClickHouse criada pelo usuário em um workspace de grupo.

Pré-requisitos

  • A rede deve atender aos seguintes requisitos:

    • Se a conexão entre o Quick BI e o banco de dados ClickHouse for via Internet, adicione os endereços IP do Quick BI à lista de permissões do banco de dados. Para mais informações, consulte Adicionar regras de grupo de segurança.

    • Se a conexão for via rede interna, garanta a conectividade entre o Quick BI e a fonte de dados ClickHouse criada pelo usuário por um dos métodos abaixo:

      • Se o banco de dados ClickHouse estiver implantado em uma instância do Elastic Compute Service (ECS), use uma VPC para acessar a fonte de dados.

      • Implante um jump server e acesse o banco de dados por um túnel SSH.

  • Obtenha o nome de usuário e a senha do banco de dados ClickHouse criado pelo usuário.

Limites

  • Somente administradores de workspace e da organização podem adicionar fontes de dados.

  • As edições Quick BI Pro e Professional Edition oferecem suporte a fontes de dados ClickHouse.

  • Versões compatíveis: 20,3, 22,8 e 23,8.

Procedimento

  1. Faça login no console do Quick BI.

  2. Siga as etapas da figura a seguir para adicionar uma fonte de dados ClickHouse.

    1. Acesse a página Create Data Source pelo ponto de entrada para criação de fonte de dados.

    2. Na aba User-created Data Source, selecione a fonte de dados ClickHouse.image

  3. Na caixa de diálogo Configure Connection, defina as configurações conforme seu cenário de negócios.image

    Nome

    Descrição

    Display Name

    Nome da fonte de dados exibido na lista. Não pode conter caracteres especiais nem começar ou terminar com espaços.

    Database Address

    Endereço de implantação do banco de dados ClickHouse (IP ou nome de domínio).

    Port

    Porta do endereço onde o banco de dados ClickHouse está implantado. Valor padrão: 8123.

    Database

    Nome do banco de dados ClickHouse definido durante a implantação.

    Username e Password

    Credenciais de acesso ao banco de dados ClickHouse.

    Time Zone

    Fuso horário da implantação do banco de dados ClickHouse.

    Versão do banco de dados

    Selecione a versão do banco de dados ClickHouse.

    Para versões 23,8 ou posteriores, selecione 23,8. Para versões anteriores a 23,8, selecione 22,8.

    SSL

    Se a fonte de dados de destino tiver SSL configurado, selecione o protocolo de segurança SSL para proteger os dados.

    VPC Data Source

    Se o banco de dados ClickHouse estiver implantado em uma instância ECS da Alibaba Cloud com rede Alibaba Cloud VPC, selecione VPC Data Source e configure os parâmetros a seguir:

    • Buyer's AccessId: AccessKey ID do usuário que adquiriu a instância.

      Para mais informações, consulte Obter um par de AccessKey.

      Nota

      Certifique-se de que o AccessKey ID tenha permissão de leitura na instância de destino. Se possuir permissão de gravação, o sistema adiciona automaticamente a lista de permissões. Caso contrário, adicione-a manualmente. Para mais informações, consulte Criar uma política de acesso personalizada.

    • Buyer's AccessKey: AccessKey Secret do usuário que adquiriu a instância.

      Para mais informações, consulte Obter um par de AccessKey.

    • Instance ID: ID da instância ECS. Faça login no console do ECS e obtenha o ID da instância na aba Instances.

      Para mais informações, consulte Visualizar informações da instância.

    • Region: Região onde a instância ECS está localizada.

      Para mais informações, consulte Visualizar informações da instância.

    SSH

    Ao selecionar SSH, configure os seguintes parâmetros:

    É possível implantar um jump server e conectar-se ao banco de dados por um túnel SSH. Para obter as informações do jump server, entre em contato com a equipe de O&M ou administradores de sistema.

    • SSH Host: Insira o endereço IP do jump server.

    • SSH Username: Nome de usuário para login no jump server.

    • SSH Password: Senha correspondente ao nome de usuário de login no jump server.

    • SSH Port: Porta do jump server. Valor padrão: 22.

    Para mais informações, consulte Conectar-se a uma instância Linux usando senha.

    Nota

    O endereço SSH deve ser um IP público. Endereços IP internos não são suportados.

    Initialize SQL

    Ao ativar este recurso, configure a instrução SQL executada após a conexão com a fonte de dados.

    Instrução SQL executada após a inicialização de cada conexão com a fonte de dados. Apenas instruções SET são permitidas, separadas por ponto e vírgula.

    Enable File Upload Entry

    Ative este recurso para habilitar o upload de arquivos.

  • Clique em Test Connection para testar a conectividade da fonte de dados.

    image

  • Após o teste bem-sucedido, clique em OK para adicionar a fonte de dados.

Próximos passos

Depois de adicionar a fonte de dados, crie um conjunto de dados e analise as informações.