Todos os produtos
Search

Este produto

    AnalyticDB:Conectar o Power BI ao AnalyticDB for MySQL

    Central de documentação

    AnalyticDB:Conectar o Power BI ao AnalyticDB for MySQL

    Última atualização: Jul 17, 2026

    Conecte o Power BI a um cluster do AnalyticDB for MySQL para visualizar e analisar dados em tempo real.

    Pré-requisitos

    Conectar-se a um endpoint do AnalyticDB for MySQL

    Usar um conector personalizado (recomendado)

    O conector personalizado oferece suporte aos modos de importação e consulta direta, enquanto o conector MySQL integrado suporta apenas o modo de importação. Recomendamos usar o conector personalizado para conectar-se a um cluster do AnalyticDB for MySQL, pois proporciona maior flexibilidade.

    Etapa 1: Instalar o driver ODBC do MySQL

    1. Baixe e instale o Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package MFC.

    2. Baixe e instale a versão 5.1.13 do MySQL ODBC Driver.

    3. Abra o ODBC Data Source Administrator (64 bits). Na guia Drivers, verifique se o driver ODBC do MySQL está listado.

    Etapa 2: Instalar o conector do AnalyticDB for MySQL

    1. Baixe o conector AnalyticDB.MySQL.mez.

    2. Mova o arquivo AnalyticDB.MySQL.mez para a pasta Custom Connectors. Essa pasta fica no diretório de documentos do Power BI, geralmente em [Documents]\Power BI Desktop. Se a pasta Custom Connectors não existir, crie-a.

      Importante

      • [Documents] refere-se ao diretório de documentos da conta de usuário atual. Por exemplo, o diretório padrão da conta Administrator é C:\Users\Administrator\Documents\Power BI Desktop.

      • Cada conta de usuário possui um diretório de documentos separado. O Power BI não carrega conectores do diretório de outro usuário. Portanto, instale e mantenha o conector individualmente para cada conta.

    3. Abra o Power BI e selecione .

      image

    4. Clique em Security. Na seção Data Extensions, selecione (Not Recommended) Allow any extension to load without validation or warning e clique em Add Data Source.

      image

    5. Na caixa de diálogo Change Requires Restart, clique em Add. Em seguida, reinicie o Power BI.

    Etapa 3: Conectar-se ao AnalyticDB for MySQL

    1. Abra o Power BI e clique em Get data from other sources.

      image

    2. Na caixa de diálogo Get Data, selecione AnalyticDB MySQL(Beta)(Custom) e clique em Connect.

      image

    3. Na caixa de diálogo Connecting to a third-party service, clique em Continue.

      image

    4. Na caixa de diálogo AnalyticDB MySQL database, configure os seguintes parâmetros:

      image

      Descrição dos parâmetros:

      Parâmetro

      Obrigatório

      Descrição

      Server

      Sim

      Endpoint e número da porta do cluster AnalyticDB for MySQL. Formato: <endpoint>:<port number>.

      • Endpoint:

        • Se o Power BI estiver instalado em uma instância ECS e tanto a instância ECS quanto o cluster AnalyticDB for MySQL estiverem na mesma VPC, insira o endereço da VPC.

        • Se o Power BI estiver instalado em um servidor local, insira o endpoint público.

      • O número da porta é fixo: 3306.

      Database

      Não

      Nome do banco de dados no cluster AnalyticDB for MySQL.

      Connection timeout in seconds

      Não

      Tempo limite de conexão com o cluster AnalyticDB for MySQL, em segundos (s).

      Read timeout in seconds

      Não

      Tempo limite de leitura, em segundos.

      Write timeout in seconds

      Não

      Tempo limite de gravação, em segundos.

      Don't cache results of forward-only cursors

      Não

      Impede o armazenamento em cache dos resultados de consultas pelo Power BI ao usar cursores somente de avanço.

      Force use of forward-only cursors

      Não

      Força o Power BI a usar cursores somente de avanço durante a execução de consultas.

      Native query

      Não

      Consulta SQL a executar. Se deixado em branco, o Power BI lista todas as tabelas do Navigator no AnalyticDB for MySQL.

      Data connectivity mode

      Sim

      Modo de conectividade de dados. Valores válidos:

      • Import: importa uma cópia dos dados para o Power BI.

      • DirectQuery: conecta-se diretamente à fonte de dados ativa.

    5. Na caixa de diálogo Completed, insira suas credenciais e clique em Connect.

      image

      Descrição dos parâmetros:

      Parâmetro

      Descrição

      User name

      Nome de usuário da conta do banco de dados AnalyticDB for MySQL.

      Password

      Senha da conta do banco de dados AnalyticDB for MySQL.

    6. Na caixa de diálogo Navigator, selecione a tabela de dados desejada, visualize-a e clique em Load.

    7. Após o carregamento dos dados, inicie a análise. Para mais informações, consulte a documentação oficial do Power BI.

      image

    Usar o conector MySQL integrado

    1. Baixe e instale o MySQL Connector.

    2. Abra o Power BI e clique em Get data from other sources.

      image

    3. Selecione MySQL database e clique em Connect.

      Nota

      Se o MySQL Connector não estiver instalado, o Power BI solicitará a instalação.

      image

    4. Na caixa de diálogo MySQL database, configure os parâmetros abaixo e clique em AnalyticDB MySQL.

      image

      Descrição dos parâmetros:

      Parâmetro

      Obrigatório

      Descrição

      Server

      Sim

      Endpoint e número da porta do cluster AnalyticDB for MySQL. Formato: <endpoint>:<port number>.

      • Se o Power BI estiver instalado em uma instância ECS e tanto a instância ECS quanto o cluster AnalyticDB for MySQL estiverem na mesma VPC, insira o endereço da VPC.

      • Se o Power BI estiver instalado em um servidor local, insira o endpoint público.

      Database

      Não

      Nome do banco de dados no cluster AnalyticDB for MySQL.

    5. Na caixa de diálogo MySQL database, clique na guia Database, insira suas credenciais e clique em Connect.

      image

      Descrição dos parâmetros:

      Parâmetro

      Obrigatório

      Descrição

      User name

      Sim

      Nome de usuário da conta do banco de dados AnalyticDB for MySQL.

      Password

      Sim

      Senha da conta do banco de dados AnalyticDB for MySQL.

    6. Na caixa de diálogo Encryption Support, clique em ODBC.

      image

    7. Na caixa de diálogo Navigator, selecione a tabela de dados desejada, visualize-a e clique em Load.

    8. Após o carregamento dos dados, inicie a análise. Para mais informações, consulte a documentação oficial do Power BI.

      image

    Conectar-se a um endpoint Spark JDBC

    Observações de uso

    O Power BI conectado a um endpoint Spark JDBC só permite ler e gravar dados em tabelas que usam o mecanismo de tabela Xuanwu. O mecanismo de tabela Xuanwu_V2 não tem suporte.

    Procedimento

    1. Baixe um driver.

      O Power BI conecta-se a um grupo de recursos interativos do Spark por meio do Microsoft Spark ODBC Driver ou do Simba Spark ODBC Driver. Baixe o driver necessário.

    2. Crie uma source de dados.

      1. Abra o ODBC Data Source Administrator (64 bits). Na guia User DSN, clique em Windows.

      2. Na caixa de diálogo OK, selecione o driver baixado na Etapa 1 e clique em Finish.

      3. Na caixa de diálogo Microsoft Spark ODBC Driver DSN Setup ou Simba Spark ODBC Driver DSN Setup, configure os seguintes parâmetros:

        image

        Parâmetro

        Descrição

        Data source name

        Nome personalizado para a source de dados.

        Description

        Descrição opcional da source de dados.

        Host(s)

        Endpoint do grupo de recursos interativos do Spark. Para obter informações sobre como conseguir o endpoint, consulte Pré-requisitos.

        Port

        Número da porta do grupo de recursos interativos do Spark. Valor fixo: 10000.

        Database

        Nome do banco de dados AnalyticDB for MySQL.

        Mechanism

        Método de autenticação. Este tópico usa User Name and Password como exemplo.

        User name

        Nome de usuário da conta do banco de dados AnalyticDB for MySQL e nome do grupo de recursos interativos do Spark. Use o formato resource_group_name/database_account_name.

        Por exemplo, se o grupo de recursos se chama testjob e a conta do banco de dados é test, insira testjob/test.

        Password

        Senha da conta do banco de dados AnalyticDB for MySQL.

        Thrift transport

        Protocolo de conexão. Selecione SASL.

      4. Clique em SSL Options. Na caixa de diálogo SSL Options, desmarque a caixa de seleção Enable SSL e clique em OK.

        image

      5. Clique em Advanced Options. Na caixa de diálogo Advanced Options, marque a caixa de seleção Get Tables with Query.

        image

      6. Clique em Server Side Properties, desmarque a caixa de seleção Apply properties with queries e clique em OK.

        image

      7. Na caixa de diálogo Microsoft Spark ODBC Driver DSN Setup ou Simba Spark ODBC Driver DSN Setup, clique em Test para verificar a conexão.

        Se a mensagem de resposta contiver SUCCESS, a conexão ODBC com o grupo de recursos interativos do Spark do AnalyticDB for MySQL foi estabelecida com sucesso.

        image

    3. Abra o Power BI e clique em Get data from other sources.

      image

    4. Na caixa de diálogo Get Data, selecione ODBC e clique em Connect.

      image

    5. Na caixa de diálogo From ODBC, selecione o Data Source Name (DSN) criado (por exemplo, adb_test) e clique em OK.

      image

    6. Na caixa de diálogo ODBC driver, clique na guia Windows, selecione Use my current credentials e clique em Connect.

      image

    7. Na caixa de diálogo Navigator, selecione a tabela de dados desejada, visualize-a e clique em Load.

    8. Após o carregamento dos dados, inicie a análise. Para mais informações, consulte a documentação oficial do Power BI.

      image