Todos os produtos
Search
Central de documentação

MaxCompute:Conectar o Yonghong BI ao MaxCompute

Última atualização: Jun 26, 2026

Conecte o Yonghong BI ao MaxCompute para analisar e visualizar dados dos seus projetos do MaxCompute. Este tópico orienta você durante o processo de conexão e a análise de dados.

Informações básicas

O Yonghong Desktop é uma ferramenta de business intelligence (BI) para análise de dados em ambiente desktop. Instale-o em sua máquina local e utilize-o imediatamente, sem implantações complexas. Ele oferece recursos integrados, ágeis e eficientes para governança de dados, análise visual e análise profunda com IA, simplificando a análise e a visualização de dados para todos os usuários. Para obter mais informações sobre o Yonghong BI, consulte Yonghong.

Pré-requisitos

Antes de começar, verifique se você possui os seguintes itens:

  • Um projeto do MaxCompute existente.

    Para saber mais sobre como criar um projeto do MaxCompute, consulte Criar um projeto do MaxCompute.

  • Um AccessKey ID e um AccessKey Secret com acesso ao projeto do MaxCompute.

    Acesse a página AccessKey Management para obter um AccessKey ID e um AccessKey Secret.

  • Uma instalação do Yonghong Desktop (v9.2.2), que inclui um MaxCompute Connector integrado.

    Para obter mais informações sobre como instalar e iniciar o Yonghong Desktop, consulte Instalar o Yonghong Desktop.

    O exemplo neste tópico utiliza o Yonghong Desktop v9.2.2, que possui um driver JDBC do MaxCompute integrado.

  • Caso o driver JDBC do MaxCompute integrado no Yonghong Desktop não consiga se conectar ao seu projeto do MaxCompute, baixe o driver JDBC do MaxCompute (v3.2.8 ou posterior) que inclui o pacote jar-with-dependencies.

    Este tópico usa o driver JDBC do MaxCompute v3.2.9 como exemplo. Para saber mais sobre como adicionar um driver, consulte Adicionar um driver personalizado.

Etapa 1: Conectar o Yonghong BI ao MaxCompute

  1. Inicie o Yonghong Desktop.

  2. No painel de navegação à esquerda, clique em Create Connection.

  3. Na página Create Connection, clique em image.png e selecione MaxCompute.

  4. Na página Database, configure os seguintes parâmetros.

    Parâmetro

    Descrição

    Connect to data source

    Tipo da fonte de dados de destino. Defina este parâmetro como MaxCompute.

    driver

    Driver usado para conectar-se ao projeto do MaxCompute. Há suporte aos seguintes tipos:

    • Driver padrão: O valor é com.aliyun.odps.jdbc.OdpsDriver. Na maioria dos casos, não é necessário alterar esse valor.

    • Driver personalizado: Se o driver padrão falhar na conexão com o projeto do MaxCompute, selecione um driver personalizado. Para obter informações sobre como adicionar um driver personalizado, consulte Adicionar um driver personalizado.

    URL

    URL de conexão para o projeto do MaxCompute. Use o formato jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}], omitindo os sinais de maior e menor (<>).

    • <MaxCompute_endpoint>: Obrigatório. O endpoint da região onde seu projeto do MaxCompute está localizado.

      Para obter uma lista de endpoints, consulte Endpoints.

    • <MaxCompute_project_name>: Obrigatório. Nome do projeto do MaxCompute de destino.

      Trata-se do nome do seu projeto do MaxCompute, não de um workspace. Faça login no MaxCompute console, alterne a região no canto superior esquerdo e localize o nome do projeto na página Projects.

    • interactiveMode: Opcional. Especifica se o recurso Query Acceleration deve ser ativado.

      Para ativar o Query Acceleration, anexe &interactiveMode=true à URL. Para obter mais informações, consulte Query Acceleration.

    Server login

    O valor padrão é Username and password. Não é necessário alterar esse valor.

    username

    AccessKey ID com acesso ao projeto do MaxCompute.

    Acesse a página AccessKey Management para obter um AccessKey ID.

    password

    AccessKey Secret correspondente ao AccessKey ID.

    Acesse a página AccessKey Management para obter um AccessKey Secret.

  5. Na parte inferior da página Database, clique em Test Connection. Após a conclusão bem-sucedida do teste, salve a conexão de dados.

    Na caixa de diálogo exibida, insira MaxCompute como nome do arquivo e clique em OK para salvar. Uma entrada de fonte de dados MaxCompute aparecerá sob o nó Demo Data_zhCN no painel de navegação à direita.

Etapa 2: Consultar e analisar dados

Após criar a conexão de dados, consulte e analise os dados no projeto do MaxCompute. É possível executar as operações listadas abaixo. Para instruções detalhadas, consulte a Ajuda do Yonghong.

  • Visualizar todas as tabelas

    Depois de salvar a conexão de dados, o Yonghong Desktop carrega automaticamente as informações das tabelas do projeto do MaxCompute.

  • Visualizar o esquema de uma tabela

    No painel de navegação à esquerda da interface do Yonghong Desktop, clique em Create Dataset e selecione MaxCompute como fonte de dados. Em seguida, execute um script SQL personalizado para visualizar o esquema da tabela na aba MetaData e salve o conjunto de dados.

    Na lista de tabelas, selecione a tabela bank_data_pt, insira uma instrução SQL como select * from bank_data_pt where age=35 e clique em Refresh Data para carregar os dados. Na aba metadata, visualize campos como job (tipo de trabalho), marital (estado civil), education (nível de escolaridade), housing (se o cliente possui hipoteca), loan (se o cliente possui empréstimo), contact (método de contato), duration e poutcome (resultado da campanha de marketing anterior). Após confirmar que o esquema está correto, clique no ícone de salvar para armazenar o conjunto de dados.

  • Visualizar dados da tabela

    No painel de navegação à esquerda da interface do Yonghong Desktop, clique em Create Dataset e selecione MaxCompute como fonte de dados. Execute um script SQL personalizado para visualizar os dados da tabela na aba Data Details e salve o conjunto de dados.

    Selecione a opção Custom SQL, insira uma instrução de consulta como select * from bank_data_pt where age=35 na área de entrada SQL e clique em Refresh Data. Visualize o resultado da consulta na seção Data Details à direita. Clique no ícone de salvar na barra de ferramentas superior para salvar o conjunto de dados.

  • Visualizar e analisar dados

    No painel de navegação à esquerda da interface do Yonghong Desktop, clique em Create Dashboard, crie um relatório, selecione um tipo de gráfico e configure os parâmetros para analisar os dados conforme suas necessidades de negócios.

    Os seguintes modelos de tema de relatório estão disponíveis: Default Theme, Classic Blue, Macaron e Moonlight Blue. Na página de edição, arraste campos da seção de configuração de campos de dados à direita para as seções columns e rows. Por exemplo, arraste Total number of employees_Sum para a seção de colunas e Education Level para a seção de linhas para gerar o gráfico.

Adicionar um driver personalizado

O Yonghong Desktop inclui um driver JDBC do MaxCompute integrado. Caso esse driver falhe na conexão com seu projeto do MaxCompute, siga estas etapas para adicionar um driver personalizado.

  1. Inicie o Yonghong Desktop.

  2. No canto superior esquerdo, clique no ícone 驱动管理, insira um nome para o driver do MaxCompute, faça upload do arquivo JAR do driver JDBC do MaxCompute baixado, como odps-jdbc-3.2.9-jar-with-dependencies.jar, e clique em OK para adicionar o driver.