AnalyticDB:Conectar o FineBI ao AnalyticDB for MySQL

Pré-requisitos

• Verifique se a sua versão do FineBI é compatível com o AnalyticDB for MySQL. Para obter mais informações, consulte Compatibility overview.

• O driver JDBC do MySQL está instalado.

• Instale o FineBI 5.0 ou uma versão posterior com suporte a dados em tempo real, requisito necessário para conexão direta com o mecanismo do AnalyticDB for MySQL. Para obter mais informações, consulte Dados em tempo real (conexão direta).

• Se esta for a primeira instalação do FineBI, você precisará de um servidor MySQL, como o ApsaraDB RDS for MySQL, para armazenar os metadados do FineBI. Para obter mais informações, consulte Conexão de dados MySQL.

• Para conectar-se a um cluster do AnalyticDB for MySQL pela internet, solicite um endpoint público.

Configure um banco de dados MySQL externo

1. Abra o FineBI.

2. Clique em no endereço do servidor e siga as instruções para configure as Account Settings.

3. Clique em em Next, selecione o banco de dados e clique em em Configure Database na seção External Database.

4. Na página External Database Configuration, configure os parâmetros conforme solicitado.

   Nota

   Insira as informações de conexão do banco de dados MySQL que armazena os metadados do FineBI, não as do banco de dados AnalyticDB for MySQL.

   Parâmetro	Descrição
   Database Type	Selecione Data Preparation.
   Real-time Data	Selecione com.mysql.jdbc.Driver.
   Database Name	Nome do banco de dados para armazenamento dos metadados do FineBI. Você também pode crie um novo banco de dados. Por exemplo, ao criar um banco chamado finedb, o FineBI executa automaticamente a instrução create database finedb; após conectar-se ao servidor MySQL.
   Host	Endereço do servidor MySQL.
   Port	Número da porta do servidor MySQL. O padrão é 3306.
   Database Account	Nome de usuário da conta criada no servidor MySQL.
   Password	Senha do nome de usuário especificado.
   URL	O sistema gera a URL de conexão automaticamente.

5. Após configure os parâmetros, clique em em Enable New Database para iniciar a importação dos metadados do FineBI.

6. Depois que os metadados forem importados, clique em em Logon para fazer login no servidor MySQL.

Conectar-se ao AnalyticDB for MySQL

1. Abra o FineBI. No painel de navegação à esquerda, escolha Add Table > Database Connections > All.

   

2. Na página de conexão do banco de dados, insira as informações de conexão do banco de dados AnalyticDB for MySQL.

   

   Parâmetro	Descrição
   Data connection name	Nome descritivo para identificar esta conexão de dados.
   Driver	Selecione com.mysql.jdbc.Driver.
   Database Name	Nome do banco de dados no cluster AnalyticDB for MySQL.
   MySQL	Endpoint público ou da VPC do cluster AnalyticDB for MySQL. As informações de endpoint e porta estão disponíveis na seção Network Information, na página Cluster Information. Para obter mais informações, consulte Endpoints.
   Port	Número da porta. O padrão é 3306.
   Database Account	Conta para conexão com o cluster AnalyticDB for MySQL. Tipos de conta suportados: Conta privilegiada. Conta padrão.
   Password	Senha do nome de usuário especificado.

3. Após configure os parâmetros, clique em em Test Connection. Se o teste for bem-sucedido, clique em em Save no canto superior direito da página.

Adicionar uma tabela

1. No painel de navegação à esquerda, escolha Prepare data > System Management > {value, select, driver {Driver} booster {Performance Acceleration} application {Application} agent {Agent} other {{value}} }. Selecione a conexão do AnalyticDB for MySQL configurada anteriormente, escolha um tipo de tabela e adicione conjuntos de dados ao sistema de decisão para análises subsequentes e uso em painéis.

   • Tabela de banco de dados: Adicione tabelas diretamente do banco de dados AnalyticDB for MySQL.

   • Conjuntos de dados SQL: Gere conjuntos de dados para análise executando instruções SQL.

   • Conjuntos de dados self-service: Processe dados de tabelas existentes ou de conjuntos de dados SQL para crie novos conjuntos.

2. Após selecione os campos da tabela base, execute operações como filtragem, agrupamento e agregação, adição de colunas e mesclagem.

   

Exemplo

A análise de cesta de mercado identifica associações entre produtos ao estudar os dados de consumo dos usuários. Este exemplo demonstra a criação de uma tabela, a importação de dados e o uso do FineBI com o AnalyticDB for MySQL para construir o painel de análise de cesta de mercado

1. Baixe os dados de amostra demo_sales.

2. Crie uma tabela no AnalyticDB for MySQL.

   1. Escolha uma coluna com dados distribuídos uniformemente como chave de distribuição e uma coluna baseada em tempo como chave de partição. Para obter mais informações, consulte Table schema design.

   2. Com base nos dados de demo_sales, os valores na coluna document_id são distribuídos aleatoriamente e utilizados em operações JOIN para análise. Portanto, use document_id como chave de distribuição. Utilize a coluna date como chave de partição. Como não haverá mais importações de dados, defina o ciclo de vida como 100.

   3. Use a seguinte instrução para crie a tabela:

      CREATE TABLE `demo_sales` (
       `date` DATE,
       `city` VARCHAR,
       `document_id` VARCHAR,
       `store_name` VARCHAR,
       `product_category` VARCHAR,
       `product_name` VARCHAR,
       `province` VARCHAR,
       `cost` DOUBLE,
       `gross_profit` DOUBLE,
       `quantity` BIGINT,
       `sales` DOUBLE
      )
      DISTRIBUTED BY HASH(`document_id`)
      PARTITION BY VALUE(`date`) LIFECYCLE 100
      INDEX_ALL='Y' STORAGE_POLICY='COLD' COMMENT='Overall Product Sales Table'

3. Após crie a tabela, use o Kettle para importar o arquivo Excel baixado para o AnalyticDB for MySQL.

   1. Para obter mais informações sobre como usar o Kettle, consulte Use Kettle to import data.

   2. Quando a importação for concluída, execute SELECT COUNT(*) FROM demo_sales;. O resultado mostrará 40.514 linhas de dados.

4. Crie um conjunto de dados self-service no FineBI.

   1. No painel de navegação, escolha Pending Configuration > Data Link. Primeiro, adicione um pacote de negócios e nomeie-o como adb.

   2. No pacote de negócios, crie um novo conjunto de dados self-service. Ao selecione os campos, escolha AnalyticDB_connection_demo_sales para selecione todos os campos da tabela demo_sales no AnalyticDB for MySQL.

5. Siga a documentação do FineBI para adicionar dados e crie o painel. Para obter mais informações, consulte Análise de cesta de mercado.

Perguntas frequentes

1. Não selecionei um banco de dados externo durante a inicialização. Como configure agora?

   Solução:

   1. No sistema de decisão de dados, escolha . Na aba Regular, clique em em Pending Configuration.

   2. Insira as informações de conexão do banco de dados para configure-o como banco de dados externo.

   3. Após concluir a configuração, clique em em Enable New Database.

2. Configurei um banco de dados MySQL externo, mas a importação de dados falhou.

   Solução:

   1. Verifique a versão e a codificação do banco de dados. Para obter mais informações, consulte Configure um banco de dados externo. O FineBI suporta MySQL 5.x.

   2. Verifique se o banco de dados MySQL externo usa o conjunto de caracteres utf8 (– UTF-8 Unicode) ou crie um novo banco de dados com codificação utf8: create database finedb character set utf8).

3. Configurei o AnalyticDB for MySQL como banco de dados externo e a conexão falhou.

   Solução: O FineBI requer uma instância MySQL padrão para armazenamento de metadados, não um cluster do AnalyticDB for MySQL.

4. As opções Extract Data e Real-time Data estão ausentes na aba Data Preparation.

   Solução: A versão disponível no site oficial do FineBI não inclui o mecanismo de conexão direta. Entre em contato com o suporte técnico do FineBI para obter uma versão que inclua esse mecanismo. Para obter mais informações, consulte Solução.

5. Os dados não estão sincronizados entre o banco de dados e o FineBI.

   Solução: Para obter mais informações, consulte Dados não sincronizados entre o banco de dados e o BI.

6. Nenhum resultado é retornado após a atualização dos dados.

   Solução: Se uma única linha não retornar resultado, o valor calculado para essa linha pode ser nulo. Caso uma coluna inteira não retorne resultados após a aplicação de uma função, a função pode ser incompatível com o AnalyticDB for MySQL. Entre em contato com o suporte técnico do AnalyticDB for MySQL para obter assistência.

7. Falha ao visualize ou salve dados.

   Solução:

   1. Verifique se alguma função foi aplicada a uma coluna com tipo de dado incompatível, o que pode resultar em valores inválidos após a conversão. Por exemplo, aplicar uma função de valor absoluto, como ABS(), a uma coluna de string como 'City' causa erro porque a string não pode ser convertida em um número válido.

   2. Se os detalhes do erro incluírem uma longa sequência de números, conforme mostrado na figura abaixo, o erro provavelmente tem origem no AnalyticDB for MySQL. Forneça esse número, que corresponde a um ID de processo, ao suporte técnico do AnalyticDB for MySQL para investigação adicional.

   3. Se os detalhes do erro contiverem apenas um código de erro, a falha provavelmente vem do FineBI. Para solução de problemas, consulte a documentação do FineBI: Problemas de uso do BI.