Todos os produtos
Search
Central de documentação

Quick BI:Criar uma fonte de dados do Dataphin

Última atualização: Aug 20, 2026

Crie uma fonte de dados do Dataphin para conectar o Quick BI ao Dataphin e permitir consultas e análises de dados.

Pré-requisitos

  • Você criou uma fonte de dados do Dataphin.

  • Você vinculou a fonte de dados do Dataphin a um aplicativo.

Procedimento

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

  2. Para adicionar uma fonte de dados:

    1. Acesse a página de criação de fonte de dados por meio de um entry for creating data sources.

    2. Selecione a fonte de dados do Dataphin.image

  3. Na caixa de diálogo Configure Connection, defina os parâmetros a seguir.

    Use uma JDBC connection ou uma Dataphin service data source.

    1. Se selecionar JDBC connection como método de conexão, configure os seguintes parâmetros.

      Nota
      • O Dataphin oferece uma configuração para desabilitar varreduras completas de tabela. Se essa opção estiver ativada e nenhum filtro de partição for aplicado, as consultas falharão. Para resolver esse problema, adicione uma condição de filtro ao campo de partição ou desative a configuração Forbid full table scan na página Platform Management > Coding Standards no console do Dataphin.

      • Para obter mais informações sobre como se conectar ao Dataphin por meio de uma conexão JDBC, consulte Connect to Dataphin by using a JDBC connection.

      Parameter

      Description

      Display name

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

      Insira um nome descritivo. O nome não pode conter caracteres especiais nem espaços no início ou no final.

      Connection method

      Conexão JDBC.

      Dataphin domain name

      URL JDBC da fonte de dados do Dataphin. Para obter a URL, faça logon no Dataphin console, acesse a página da fonte de dados e localize o public_URL na coluna JDBC URL. Exemplo: xxxxxxxxxxxxxxxxxxxxx.alicloudapi.com

      Port

      Número da porta da fonte de dados do Dataphin.

      Project name/Database

      Escopo padrão para consultas. Insira o nome em inglês de um projeto do Dataphin, o nome em inglês de um bloco de dados ou um código de fonte de dados, conforme sua necessidade de negócio:

      • Para usar tabelas físicas do Dataphin, insira o nome do projeto do Dataphin.

      • Para usar tabelas lógicas do Dataphin, insira o nome do bloco de dados do Dataphin. O nome deve ter o prefixo LD_.

      • Para usar tabelas de uma fonte de dados gerenciada pelo Dataphin, insira o código da fonte de dados configurado no Dataphin. O código deve ter o prefixo ds_.

      Após definir esse escopo, você ainda poderá usar tabelas de outros projetos, blocos de dados ou fontes de dados como datasets, criando um dataset SQL. Ao criar o dataset, especifique o prefixo correspondente ao projeto, bloco de dados ou fonte de dados.

      Schema

      Nome do schema de destino. Este parâmetro é opcional.

      • Não é necessário especificar este parâmetro ao utilizar uma tabela física ou lógica do Dataphin.

      • Também não é necessário especificar este parâmetro se o tipo de fonte de dados for uma tabela que não suporta schemas, como MySQL.

      • Se o tipo de fonte de dados for uma tabela que suporta schemas, como Oracle, este parâmetro é opcional. Caso especifique um schema, os dados serão consultados nesse schema. Se nenhum schema for especificado, os dados serão consultados no schema padrão do banco de dados.

      Execution project

      Projeto utilizado para executar instruções SQL de consulta. O projeto e seu mecanismo de computação vinculado devem ter permissões de leitura na tabela consultada. Este parâmetro:

      • É opcional se o escopo da consulta for um projeto do Dataphin. Se deixado em branco, o projeto definido como escopo padrão de consulta será usado como projeto de execução SQL.

      • É obrigatório quando o escopo da consulta é um bloco de dados do Dataphin.

      • Não é necessário quando o escopo da consulta é uma fonte de dados do Dataphin.

      Tenant ID

      ID do tenant a ser consultado.

      AccessKey type

      Selecione uma AccessKey no nível da plataforma ou de usuário pessoal para a conexão.

      AccessKey ID

      • Se selecionar Dataphin Platform no parâmetro AccessKey type, insira o AccessKey ID da plataforma. Entre em contato com a equipe de O&M do Dataphin para obter esse ID.

      • Se selecionar Personal User no parâmetro AccessKey type, insira seu AccessKey ID pessoal. Você encontra esse ID na página Personal Center > AccessKey.

      AccessKey Secret

      Segredo da AccessKey correspondente ao AccessKey ID.

      Proxied user

      Obrigatório ao usar uma AccessKey da plataforma. Usuário representado para estabelecer a conexão e acessar o Dataphin.

      Account type

      Ao usar uma AccessKey da plataforma, especifique o tipo de conta. Valores válidos: USER_ID (ID exclusivo dentro do Dataphin), account_name (nome de usuário do Dataphin) e SOURCE_USER_ID (ID do usuário no sistema de origem).

      Engine type

      Os mecanismos suportados são MaxCompute, Hive, MySQL, Oracle, AnalyticDB PostgreSQL, Apache Doris e StarRocks.

      SSL

      Se a fonte de dados de destino tiver SSL configurado, marque esta caixa de seleção para ativar conexões criptografadas por SSL.

      VPC data source

      Marque a caixa de seleção VPC data source e configure os parâmetros a seguir.

      Nota
      • A conexão do Quick BI a uma implantação independente do Dataphin via VPC só é possível se o gateway for um gateway da Alibaba Cloud.

      • Ao marcar a caixa de seleção VPC data source, defina o parâmetro Database Address como um endereço do Server Load Balancer (SLB).

      • Purchaser AccessId: AccessKey ID da conta proprietária da instância do Server Load Balancer (SLB). Essa conta precisa ter permissões de leitura na instância. Faça logon no RAM console para obter o AccessKey ID. Para mais informações, consulte View the AccessKey information of a RAM user.

      • Purchaser AccessKey: Segredo da AccessKey correspondente ao AccessKey ID. Faça logon no RAM console para obter o segredo da AccessKey. Para mais informações, consulte View the AccessKey information of a RAM user.

      • Instance ID: ID da instância do Server Load Balancer (SLB). Faça logon no Server Load Balancer console e obtenha o ID da instância na lista de instâncias.

      • Region: Região onde a instância está localizada. Para obter a região, faça logon no Server Load Balancer console e verifique o canto superior esquerdo da página Instance Management.

      Initial SQL

      Instruções SQL a serem executadas imediatamente após o estabelecimento da conexão.

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

    2. Se selecionar Dataphin service data source como método de conexão, configure os parâmetros abaixo.

      Parameter

      Description

      Display name

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

      Insira um nome descritivo. O nome não pode conter caracteres especiais nem espaços no início ou no final.

      Connection method

      Fonte de dados de serviço do Dataphin.

      Ao selecionar esta opção, crie manualmente uma fonte de dados no Dataphin e configure uma AppKey e uma AppSecret.

      Database address

      URL JDBC da fonte de dados do Dataphin. Se estiver usando uma fonte de dados VPC, insira o endereço do Server Load Balancer (SLB).

      Para obter a URL, faça logon no Dataphin console, acesse a página da fonte de dados e localize o public_URL na coluna JDBC URL. Exemplo: xxxxxxxxxxxxxxxxxxxxx.alicloudapi.com.

      Data source name

      Nome personalizado da fonte de dados no Dataphin.

      Para obter o nome, faça logon no Dataphin console e acesse a página Data Service Overview > Dataphin Data Source Service para localizar o Data Source Name.

      Schema

      Opcional. Nome do schema de destino.

      • Para tabelas lógicas, refere-se ao schema da tabela lógica, correspondendo a um bloco de negócios no Dataphin.

      • Para tabelas físicas, refere-se ao schema da tabela física, correspondendo a um projeto no Dataphin.

      AppKey

      AppKey do aplicativo na fonte de dados do Dataphin.

      Para obter a AppKey, faça logon no Dataphin console e acesse a página Platform Management > Application Management para localizar a AppKey.

      AppSecret

      AppSecret do aplicativo na fonte de dados do Dataphin.

      Para obter a AppSecret, faça logon no Dataphin console e acesse a página Platform Management > Application Management para localizar a AppSecret.

      Engine type

      MaxCompute e Hive são suportados.

      VPC data source

      Marque esta caixa de seleção para configurar uma fonte de dados VPC.

      Nota

      A conexão do Quick BI a uma implantação independente do Dataphin via VPC só é possível se o gateway for um gateway da Alibaba Cloud. Ao selecionar esta opção, defina Database Address como o endereço do Server Load Balancer (SLB) e configure os parâmetros a seguir.

      Creator AccessId

      Faça logon no RAM console para obter o AccessKey ID. Para mais informações, consulte View the AccessKey information of a RAM user.

      Creator AccessKey

      Faça logon no RAM console para obter o AccessKey Secret. Para mais informações, consulte View the AccessKey information of a RAM user.

      API Gateway group ID

      • Acesse o console do API Gateway.

      • Clique em Group Management na página de detalhes de um grupo de API aberta para obter o ID do grupo.

      Region

      Siga as instruções anteriores para acessar o API Gateway console e obter a região na página de detalhes do grupo para APIs abertas.

      Importante
      • Ao se conectar ao Dataphin na nuvem pública, a conexão só pode ser feita pela internet.

      • Ao se conectar a uma implantação independente do Dataphin:

        • Se o gateway do Dataphin for privado (incluindo Lingyang), a conexão só pode ser feita pela internet.

        • Se o gateway do Dataphin for um gateway da Alibaba Cloud, a conexão pode ser feita pela internet ou via VPC.

  4. Clique em Test Connection para verificar a conexão.image

  5. Após o teste de conexão bem-sucedido, clique em OK para criar a fonte de dados.

Próximas etapas

Depois de criar a fonte de dados, crie datasets e comece a analisar os dados.