AnalyticDB:Conectar o FineBI ao AnalyticDB for MySQL

Pré-requisitos

• Verifique se sua versão do FineBI é compatível com o AnalyticDB for MySQL. Para obter mais informações, consulte Visão geral de compatibilidade.

• Instale o driver JDBC do MySQL.

• Instale o FineBI 5.0 ou posterior com suporte a dados em tempo real, necessário para conexão direta ao 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, utilize 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.

Configurar um banco de dados MySQL externo

1. Abra o FineBI.

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

3. Clique em Next, selecione o banco de dados e clique 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, e não as do banco de dados do 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 onde os metadados do FineBI são armazenados. Também é possível criar um novo banco de dados. Por exemplo, ao criar um banco de dados chamado finedb, o FineBI executa automaticamente a instrução create database finedb; após a conexão com o 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 automaticamente a URL de conexão.

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

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

Conectar 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 do AnalyticDB for MySQL.

   

   Parâmetro	Descrição
   Data connection name	Insira um nome descritivo para facilitar a identificação da conexão de dados.
   Driver	Selecione com.mysql.jdbc.Driver.
   Database Name	Nome do banco de dados no cluster do AnalyticDB for MySQL.
   MySQL	Endpoint público ou da VPC do cluster do AnalyticDB for MySQL. Encontre as informações de endpoint e porta 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 usada para conectar ao cluster do AnalyticDB for MySQL. Pode ser um dos seguintes tipos: Conta privilegiada. Conta padrão.
   Password	Senha do nome de usuário especificado.

3. Após configurar os parâmetros, clique em Test Connection. Se o teste for bem-sucedido, clique 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 configurada do AnalyticDB for MySQL, escolha um tipo de tabela e adicione conjuntos de dados ao sistema de tomada de decisão para análises subsequentes e uso em painéis.

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

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

   • Self-service datasets: Processe dados de tabelas existentes ou conjuntos de dados SQL para criar novos conjuntos de dados.

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

   

Exemplo

A análise de cesta de mercado identifica associações entre produtos com base nos dados de consumo dos usuários. Este exemplo demonstra como criar uma tabela, importar dados e usar o FineBI com o AnalyticDB for MySQL para construir o painel de análise de cesta de mercado

1. Baixe os dados de amostra do 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 temporal como chave de partição. Para obter mais informações, consulte Design de esquema de tabela.

   2. Nos dados de demo_sales, os valores da coluna document_id têm distribuição aleatória e são usados 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ção de dados, defina o ciclo de vida como 100.

   3. Use a seguinte instrução para criar 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 criar 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 Usar o Kettle para importar dados.

   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 de autoatendimento 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 de autoatendimento. Ao selecionar os campos, escolha AnalyticDB_connection_demo_sales para selecionar todos os campos da tabela demo_sales no AnalyticDB for MySQL.

5. Siga a documentação do FineBI para adicionar dados e criar 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 configuro agora?

   Solução:

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

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

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

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

   Solução:

   1. Verifique a versão e a codificação do banco de dados. Para obter mais informações, consulte Configurar um banco de dados externo. O FineBI oferece suporte ao 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, e 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 nenhum resultado, o valor calculado para essa linha pode ser nulo. Se uma coluna inteira não retornar 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 visualizar ou salvar dados.

   Solução:

   1. Verifique se alguma função foi aplicada a uma coluna com tipo de dados incompatível, o que pode gerar 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 numérica, conforme mostrado na figura a seguir, o erro provavelmente tem origem no AnalyticDB for MySQL. Forneça esse número (ID do 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, o problema provavelmente está no FineBI. Para solução de problemas, consulte a documentação do FineBI: Problemas de uso do BI.