O Apache Superset é uma plataforma gratuita e de código aberto para exploração e visualização de dados, compatível com MySQL, PostgreSQL e outros mecanismos de banco de dados que suportam Java Database Connectivity (JDBC). Este guia orienta você na conexão do Superset a um cluster AnalyticDB for MySQL e na execução da sua primeira consulta no SQL Lab.
Pré-requisitos
Antes de começar, verifique se você possui:
O Superset 4.1.1 ou posterior instalado. Consulte o Quickstart para obter instruções de instalação.
O endereço IP do servidor Superset adicionado à lista de permissões de endereços IP do seu cluster AnalyticDB for MySQL. Consulte Listas de permissões de endereços IP.
Conectar o Superset ao AnalyticDB for MySQL
Etapa 1: Reunir os detalhes da conexão
Reúna as seguintes informações antes de configurar a conexão no Superset:
|
Parâmetro |
Descrição |
|
HOST |
O endpoint do seu cluster AnalyticDB for MySQL. Utilize o endpoint interno se o Superset estiver executando em uma instância Elastic Compute Service (ECS) na mesma VPC do cluster. Utilize o endpoint público se o Superset estiver executando em um servidor local. |
|
PORT |
|
|
DATABASE NAME |
O nome do banco de dados no cluster |
|
USERNAME |
O nome da conta do banco de dados |
|
PASSWORD |
A senha da conta do banco de dados |
|
DISPLAY NAME |
Um nome de exibição para esta conexão no Superset |
Etapa 2: Instalar o driver MySQL (apenas para instalações via Python)
Ignore esta etapa se você instalou o Superset com docker, pois o driver MySQL já está incluído na imagem docker.
Caso tenha instalado o Superset com Python, instale o driver MySQL manualmente. Para opções de drivers e comandos de instalação, consulte Connecting to Databases.
Etapa 3: Adicionar a conexão do banco de dados
Abra a interface web do Superset. No canto superior direito, escolha SQL > Database Connections.
Na página Databases, clique em +DATABASE no canto superior direito.
Na caixa de diálogo Connect a database, selecione MySQL como source de dados.
Insira os detalhes de conexão reunidos na Etapa 1 e clique em CONNECT.
Etapa 4: Ativar permissões do SQL Lab
Na coluna Actions, clique no ícone
ao lado da sua nova conexão.Acesse a aba ADVANCED e clique em SQL Lab.
Selecione as operações de banco de dados a serem permitidas. Para este exemplo, selecione Allow DDL and DML e clique em FINISH.
Etapa 5: Executar uma consulta no SQL Lab
Na barra de navegação superior, escolha SQL > SQL Labs.
-
No painel à esquerda, configure os seguintes parâmetros:
Parâmetro
Descrição
DATABASE
A conexão criada na Etapa 3
SCHEMA
O banco de dados onde você deseja executar SQL
SEE TABLE SCHEMA
A tabela que você deseja consultar
No editor de código à direita, insira e execute sua instrução SQL.
Após a execução da consulta, os resultados aparecem abaixo do editor. Seu cluster AnalyticDB for MySQL agora está conectado e pronto para uso com o Superset.