Obtenha dados de MariaDB em Planilhas Google
Extraia linhas em tempo real do seu banco de dados MariaDB para o Google Sheets e atualize-as quando quiser. Sem uploads de CSV, sem Apps Script, sem copiar e colar. Leva cerca de dez minutos na primeira vez, e o plano gratuito cobre isso.
O resultado final será o que você obterá.
Uma planilha do Google que exibe os resultados em tempo real de uma consulta SQL no seu banco de dados MariaDB, com um botão que busca as linhas mais recentes sempre que os dados forem alterados. Assim:
| A | B | C | D | E | |
|---|---|---|---|---|---|
| 1 | ID do cliente | primeiro nome | sobrenome | país | total |
| 2 | 1042 | Maria | Álvarez | EUA | 1,284.50 |
| 3 | 1043 | Daniel | Okafor | EUA | 612.00 |
| 4 | 1047 | Priya | Nair | EUA | 2,090.75 |
| 5 | 1051 | Thomas | Berg | EUA | 338.20 |
| 6 | 1056 | Lúcia | Ferreira | EUA | 1,455.00 |
| 7 | 1060 | Kenji | Sato | EUA | 874.10 |
| 8 |
Direto do MariaDBO MariaDB armazena seus dados em um servidor gerenciado por você ou sua equipe. Importá-los para o Google Sheets geralmente significa exportar arquivos CSV que ficam desatualizados assim que chegam, ou usar scripts que ninguém quer manter. O Query Streams elimina isso: um pequeno programa auxiliar chamado Agente executa a consulta no local onde seus dados estão armazenados, e um complemento do Google Sheets solicita a ele as linhas desejadas. Somente os resultados são transmitidos por meio de uma conexão criptografada, e o Google Sheets pode ser acessado de qualquer lugar: qualquer navegador, em qualquer dispositivo.
O que você vai precisar
Uma conta do Query Streams
O plano gratuito é suficiente para este guia. Cadastre-se em my.querystreams.com.
O agente está em um computador que consegue acessar o servidor.
Um pequeno programa que roda em segundo plano e consulta o banco de dados quando o Google Sheets solicita. Geralmente é o próprio servidor de banco de dados ou qualquer computador sempre ligado na mesma rede.
Detalhes da sua conexão com o MariaDB
O nome do servidor, o nome do banco de dados e um nome de usuário e senha que permitam a leitura. Se outra pessoa gerencia o banco de dados, esta é a informação que você deve solicitar a ela.
Qual computador receberá o Agente? Qualquer máquina que esteja sempre ligada e que já consiga acessar seu banco de dados MariaDB, geralmente o próprio servidor de banco de dados ou um computador na mesma rede. O Google Sheets pode estar em qualquer lugar.Ele é executado no seu navegador.
Conecte-o em cinco etapas
-
Crie sua conta
Vá para my.querystreams.com e inscreva-se. Escolha o Gratuito É um plano real, não uma versão de teste, e abrange a conexão do seu banco de dados MariaDB e a execução de consultas a partir do Google Sheets.
Instale o Agente em um computador que possa acessar o servidor.



Faça login e abra DownloadInstale o Agente em uma máquina que já tenha acesso ao seu banco de dados MariaDB: geralmente o próprio servidor de banco de dados ou qualquer computador sempre ligado na mesma rede. A instalação leva apenas um minuto e, a partir daí, o Agente inicia automaticamente.
Por que um programa pequeno em vez de um driver? O Agente é um único instalador para Windows, Mac ou Linux (cerca de 85 MB no Windows, um pouco mais de 100 MB no Mac e Linux) que funciona silenciosamente em segundo plano. Ele estabelece uma única conexão de saída criptografada com o Query Streams, da mesma forma que um navegador, portanto, você não precisa abrir nenhuma porta de firewall nem configurar uma VPN. Seu banco de dados permanece em sua rede e as linhas são transferidas para onde você estiver, pela internet, se necessário. O único componente do seu lado é o complemento.
A página de download mostra Sua chave de acessoCole o código no Agente quando solicitado e aguarde até que o crachá exiba a mensagem. Conectado a fluxos de consultaEssa é a única coisa que você faz no próprio Agente.
-
Aponte para o seu banco de dados MariaDB.
De volta ao seu navegador, abra Agentes de dados (sob Dados (no menu superior). Seu agente está listado lá. Clique Adicionar conector, escolher MariaDBe preencha os detalhes que você coletou anteriormente:
- Nome da conexão
- Qualquer nome que você reconheça mais tarde, como Banco de Dados de Vendas.
- Hospedar
- O nome do servidor ou endereço IP, como sales-db.company.com.
- Porto
- A porta de rede que o MariaDB utiliza para escutar; deixe-a em 3306, a menos que seu administrador a tenha alterado.
- Banco de dados
- O nome do banco de dados que contém suas tabelas.
- Nome de usuário
- Um login de banco de dados com permissão para leitura dos dados; ele começa preenchido como root, então substitua-o por um login somente leitura.
- Senha
- A senha para acessar esse banco de dados.
Clique em Teste de conexãoQuando lê Conectado, um Captura de esquema A etapa pergunta quais bancos de dados incluir; selecione pelo menos um e clique em SalvarA conexão chega ao seu agente em poucos segundos.
O teste falhou? Geralmente, o problema está no nome do servidor ou em um firewall entre o computador do Agente e o banco de dados. Tente acessar o banco de dados usando as mesmas informações do seu computador com a ferramenta que você usa normalmente; se isso falhar, o Agente também falhará.
-
Adicionar fluxos de consulta ao Google Sheets
Abra qualquer planilha do Google e acesse Extensões → Complementos → Obter complementos, procurar Fluxos de consultae clique InstalarOu instale-o diretamente de Consultar fluxos no Google Workspace MarketplaceO Google pedirá que você permita o complemento; isso é normal.
Depois disso, estará presente em todas as Planilhas Google que você abrir: um ícone do Query Streams no painel lateral à direita, também listado em ExtensõesNão há necessidade de fazer login separadamente. O sistema reconhece a conta do Google que você já utiliza, portanto, o e-mail precisa ser o mesmo cadastrado na sua conta do Query Streams.
-
Puxe sua primeira mesa.
Clique no ícone "Consultar Fluxos" no painel lateral à direita da planilha (ou encontre-o em "Acessar Fluxos"). Extensões). Escolher Fluxo de consulta e selecione a conexão que você acabou de fazer.
Digite a consulta que deseja executar. Esta consulta extrai algumas colunas de uma tabela. clientes mesa:
Exemplo · SQLSELECT customer_id, name, city FROM customers ORDER BY name LIMIT 100;
Sob Folha de Destino Selecione a aba onde as linhas devem ser exibidas e clique em Executar consultaAs linhas aparecem nessa aba em um ou dois segundos. Clique em "Executar consulta" novamente sempre que os dados forem alterados e a aba será atualizada automaticamente.
Não conhece SQL? Em vez disso, crie a consulta no portal Query Streams. Construtor de consultas Exibe suas tabelas e colunas para que você possa apontar e clicar. Nos planos Business, você também pode usar o Nova em linguagem natural ("mostre-me os clientes nos EUA") e ele gera o SQL para você. Salve a consulta e ela estará a um clique de distância no portal e na lista de Consultas Salvas do complemento, a partir do plano Personal Core.
É isso. Seus dados estão na planilha e permanecem atualizados com um clique. Nada saiu da sua rede, exceto as linhas que você solicitou.
Boas próximas jogadas
- Salvar consulta no portal, para que você possa executá-lo novamente com um clique, a partir do Google Sheets ou do Excel.
- Adicionar um filtro como um intervalo de datas, para que a mesma consulta possa responder "este mês" sem precisar editar.
- Compartilhe os resultados Com um colega. Eles veem as fileiras, não suas credenciais.
Perguntas que as pessoas fazem
O banco de dados MariaDB precisa estar no mesmo computador em que uso o Planilhas Google?
Não. Apenas o Agente precisa estar no mesmo local que seu banco de dados MariaDB. O Google Sheets funciona no seu navegador em qualquer dispositivo. Abra o complemento com a mesma conta do Google e suas conexões estarão prontas.
Meus dados são copiados para o Query Streams?
Não. O agente executa a consulta no local onde seus dados estão armazenados e envia apenas as linhas retornadas. Nada é sincronizado ou armazenado nesse meio tempo.
O plano gratuito realmente cobre isso?
Sim. A versão gratuita é um plano permanente, não um período de teste com prazo de validade. Veja exatamente o que está incluído no plano. página de preços.
A planilha atualiza sozinha?
Clique em Executar Consulta novamente sempre que desejar as linhas mais recentes. Para uma planilha que seja atualizada automaticamente, sem que ninguém precise fazer nada, configure uma Automação no portal do Query Streams (Streams → Automação). Ela está disponível em todos os planos.
Guias relacionados
Todos os guias para MariaDB
Não é bem a sua configuração?
- Está usando o MySQL? Selecione o cartão MySQL; os passos são os mesmos → MySQL

