Todos os produtos
Search
Central de documentação

ApsaraDB for ClickHouse:Adicionar uma fonte de dados do ApsaraDB for ClickHouse

Última atualização: Jul 20, 2026

Conecte o Quick BI à sua fonte de dados do ApsaraDB for ClickHouse pela Internet ou por uma VPC para realizar visualização de dados e análises multidimensionais.

Pré-requisitos

  • Você possui um cluster do ApsaraDB for ClickHouse ativo. Para mais informações, consulte Crie um cluster.

  • Uma conta de banco de dados e senha foram criadas. Para mais informações, consulte Crie uma conta.

  • A versão do cluster é 20,3 ou 22,8.

  • O endereço IP do Quick BI foi adicionado à lista de permissões do ApsaraDB for ClickHouse. Para mais informações, consulte Configure uma whitelist.

    Nota

    Caso não saiba os endereços IP do Quick BI, siga as etapas na seção Procedimento para acessar o painel Create Data Source. Os endereços IP necessários estão listados na parte inferior do painel, em Before you connect, add the following whitelist entries.

  • Se a instância do Quick BI e o cluster do ApsaraDB for ClickHouse estiverem em VPCs diferentes, solicite um endpoint público para o cluster. Para mais informações, consulte Solicite e libere um endpoint público.

Limitações

  • Somente administradores e desenvolvedores do workspace podem adicionar fontes de dados.

  • Fontes de dados do ClickHouse só podem ser criadas em workspaces de grupo do Quick BI Professional e Quick BI Advanced.

Procedimento

  1. Acesse o console do Quick BI.

  2. Na barra de navegação superior, clique em Workbench.

  3. No painel de navegação à esquerda, clique em Data Source.

  4. Na página Data Source, clique em New Data Source.

  5. No painel Create Data Source, localize a seção Databases e clique em ClickHouse.

  6. Na página Add ClickHouse Data Source, configure os parâmetros de acordo com o tipo de rede.

    Internet

    Parâmetro

    Descrição

    source

    Selecione Alibaba Cloud.

    Display name

    Nome de exibição da fonte de dados na lista de fontes.

    O nome pode conter letras, dígitos, sublinhados (_) e hifens (-).

    Database address

    Endpoint público do cluster do ApsaraDB for ClickHouse.

    Port number

    Número da porta do cluster do ApsaraDB for ClickHouse. O padrão é 8123.

    Database

    Nome do banco de dados no cluster do ApsaraDB for ClickHouse.

    Username

    Nome de usuário da conta do banco de dados do cluster do ApsaraDB for ClickHouse.

    Password

    Senha da conta do banco de dados.

    Time Zone

    Fuso horário do banco de dados do ApsaraDB for ClickHouse.

    SSL

    Caso a fonte de dados utilize SSL, ative a opção SSL para proteger a transmissão de dados.

    VPC Data Source

    Ao conectar-se à fonte de dados pela Internet, esta chave fica desativada por padrão.

    Initialize SQL

    Ative esta opção para definir instruções SQL executadas após o estabelecimento da conexão.

    Apenas instruções SET são permitidas. Separe múltiplas instruções com ponto e vírgula (;).

    Enable File Upload

    Após ativar esta chave, o upload de arquivos estará disponível.

    VPC

    Parâmetro

    Descrição

    source

    Selecione Alibaba Cloud.

    Display name

    Nome de exibição da fonte de dados na lista de fontes.

    O nome pode conter letras, dígitos, sublinhados (_) e hifens (-).

    Database address

    Endpoint interno do cluster do ApsaraDB for ClickHouse.

    Port number

    Número da porta do cluster do ApsaraDB for ClickHouse.

    Database

    Nome do banco de dados no cluster do ApsaraDB for ClickHouse.

    Username

    Nome de usuário da conta do banco de dados do cluster do ApsaraDB for ClickHouse.

    Password

    Senha da conta do banco de dados.

    Time Zone

    Fuso horário do banco de dados do ApsaraDB for ClickHouse.

    VPC Data Source

    Ative a chave VPC Data Source e configure os seguintes parâmetros:

    • AccessKey ID: AccessKey ID da conta Alibaba Cloud usada para adquirir o cluster. Para mais informações, consulte Obtenha um par de AccessKey.

    • AccessKey Secret: AccessKey secret da conta Alibaba Cloud usada para adquirir o cluster. Para mais informações, consulte Obtenha um par de AccessKey.

    • Instance ID: ID do cluster do ApsaraDB for ClickHouse.

    • Region: Região onde o cluster do ApsaraDB for ClickHouse está localizado.

    Initialize SQL

    Ative esta opção para definir instruções SQL executadas após o estabelecimento da conexão.

    Apenas instruções SET são permitidas. Separe múltiplas instruções com ponto e vírgula (;).

    Enable File Upload

    Após ativar esta chave, o upload de arquivos estará disponível.

  7. Clique em Test Connection para verificar a conexão.

  8. Se o teste de conexão for bem-sucedido, clique em OK.

    Após a criação, a fonte de dados aparecerá na lista My Data Sources.

Próximos passos

Após criar a fonte de dados, crie conjuntos de dados e analise as informações.