MaxCompute:Conectar o Metabase ao MaxCompute

Notas sobre a versão

• O driver do Metabase está atualmente em Preview e seus recursos estão em desenvolvimento ativo.

• Este driver é baseado no Metabase v0.50. Caso encontre problemas de incompatibilidade ou outras questões, entre em contato conosco pelo seu grupo dedicado do DingTalk ou pela Comunidade de Desenvolvedores do MaxCompute (ID do grupo no DingTalk: 11782920).

Pré-requisitos

• Instale o Java Development Kit (JDK) 11 ou uma versão posterior. Baixe-o no site oficial do JDK.

• Crie um projeto do MaxCompute. Para mais informações, consulte Criar um projeto do MaxCompute.

• Obtenha a versão mais recente do driver JDBC do MaxCompute, odps-jdbc-jar-with-dependencies.jar. Baixe o arquivo em odps-jdbc.

  Nota

  A versão do driver JDBC do MaxCompute deve ser v3.7.0 ou superior.

Etapa 1: Iniciar o Metabase

1. Baixe o arquivo JAR do Metabase e o driver do MaxCompute para Metabase.

   • Clique em Metabase para baixar o arquivo metabase.jar mais recente.

   • Clique em Driver do MaxCompute para Metabase para baixar o arquivo do driver maxcompute.metabase-driver.jar.

2. Crie um diretório, por exemplo metabase_mc_dir, e mova o arquivo metabase.jar para ele.

3. No diretório metabase_mc_dir, crie um subdiretório chamado plugins. Mova os arquivos maxcompute.metabase-driver.jar e odps-jdbc-jar-with-dependencies.jar para o diretório plugins.

4. Inicie o Metabase.

   Acesse o diretório metabase_mc_dir e execute o comando java -jar metabase.jar para iniciar o Metabase.

   Uma inicialização bem-sucedida exibe mensagens semelhantes às seguintes:

   024-08-29 16:17:53,745 INFO metabase.task :: Task scheduler started
   2024-08-29 16:17:53,746 INFO metabase.core :: Metabase Initialization COMPLETE in 27.7 s
   2024-08-29 16:17:53,764 INFO task.refresh-slack-channel-user-cache :: Slack is not configured, not refreshing slack user/channel cache.

   Se ocorrer um conflito de porta durante a inicialização, altere a porta padrão (3000) definindo a variável de ambiente MB_JETTY_PORT. Em seguida, reinicie o Metabase. Para obter detalhes, consulte Personalizar o servidor web Jetty do Metabase.

   Após iniciar o Metabase com êxito, abra um navegador e acesse http://localhost:<port>, onde port é o número da sua porta, para abrir a tela de configuração do Metabase.

Etapa 2: Conectar o Metabase ao MaxCompute

1. Na tela de configuração do Metabase, siga as instruções na tela para a configuração inicial. Ao chegar na etapa Add your data, utilize o método abaixo para adicionar um banco de dados do MaxCompute:

   Nota

   • Também é possível selecionar I'll add my data later na seção Add your data. Após concluir a configuração, adicione um banco de dados do MaxCompute seguindo as instruções em Adicionar e gerenciar bancos de dados.

   • Para mais informações sobre o processo de configuração do Metabase, consulte setting-up-metabase.

   1. Na seção Add your data, pesquise e selecione MaxCompute.

   2. Configure os parâmetros de conexão conforme descrito abaixo:

      Parâmetro	Descrição
      Display name	Obrigatório. Nome de exibição da conexão com o banco de dados no Metabase.
      Project	Obrigatório. Nome do projeto do MaxCompute a ser acessado.
      Endpoint	Obrigatório. Endpoint de conexão para o serviço do MaxCompute. Configure o endpoint com base na região e no tipo de rede do seu projeto do MaxCompute. Para obter uma lista de endpoints, consulte Endpoints.
      AccessKey ID	Obrigatório. AccessKey ID da sua conta Alibaba Cloud ou usuário RAM. Obtenha essa informação na página AccessKey Management.
      AccessKey secret	Obrigatório. AccessKey secret correspondente ao seu AccessKey ID.
      timezone	Opcional. Fuso horário que afeta a exibição de valores baseados em tempo no Metabase. O padrão é Asia/Shanghai. Para obter uma lista de fusos horários válidos, consulte Lista de fusos horários.

   3. Clique em Connect to Database.

2. No painel de navegação do Metabase, clique em Browse > Our data.

3. Na página Databases, clique no nome de exibição do seu banco de dados do MaxCompute para visualizar suas tabelas.

Etapa 3: Consultar e analisar dados

Após adicionar o banco de dados do MaxCompute, consulte e analise seus dados no Metabase. Para obter orientações detalhadas sobre essas operações, consulte a documentação do Metabase.

• Visualize todas as tabelas

  Na página Databases, visualize todas as tabelas do projeto do MaxCompute. Ao abrir um banco de dados, as tabelas aparecem como uma grade de cartões.

• Visualize o schema de uma tabela

  Na página Databases, clique no ícone ao lado de uma tabela e selecione a aba Fields in this table para visualizar seu schema.

• Visualize dados da tabela

  Na página Databases, clique no nome de uma tabela para visualizar seus dados.

  Como alternativa, clique no botão Query no canto superior direito. Na área Actions, clique em SQL query, selecione seu banco de dados e escreva código SQL para visualizar e salvar dados da tabela.

• Visualize e analise dados

  Após executar uma consulta SQL personalizada, crie um painel para analisar os dados. Para mais informações, consulte Painel do Metabase.