Executar SQL no Google Sheets sem JDBC do Apps Script

Planilhas Google · SQL sem Apps Script

Executar SQL em Planilhas Google sem escrever JDBC em Apps Script

O serviço JDBC do Apps Script funciona, e esta página mostra a versão completa: o código, o limite de seis minutos, os intervalos de IP e a senha no script. Em seguida, mostra o outro método: um pequeno agente próximo ao seu banco de dados executa o SQL, e um complemento do Google Sheets importa as linhas para a sua planilha. Sem JavaScript, sem alterações no firewall, e o plano gratuito cobre tudo isso.

Cerca de 15 minutos Somente SQL, sem JavaScript A senha permanece na sua rede. MySQL, PostgreSQL, SQL Server e muito mais

Se você ainda quiser usar o JDBC do Apps Script, aqui está a versão honesta.

do Google Serviço JDBC Conecta o Apps Script ao MySQL, Google Cloud SQL para MySQL, PostgreSQL, Microsoft SQL Server e Oracle. O menor script funcional que preenche uma planilha tem a seguinte aparência:

função carregarClientes() {
  constante adereços = Serviço de propriedades.obterPropriedadesDoScript();          // Mantenha a senha fora do código
  constante conexão = Jdbc.obterConexão('jdbc:mysql://db.example.com:3306/sales'adereços.obterPropriedade('DB_USER'), adereços.obterPropriedade('DB_PASS'));
  constante rs = conexão.criarDeclaração().executarQuery('SELECT customer_id, name, city FROM customers LIMIT 1000');
  constante linhas = [];
  enquanto (rs.próximo()) linhas.empurrar([rs.obterString(1), rs.obterString(2), rs.obterString(3)]); rs.fechar(); conexão.fechar();
  constante folha = Aplicativo de planilha.obterPlanilhaAtiva().obterPlanilhaPorNome('Clientes'); folha.clearContents(); folha.obterIntervalo(1, 1, linhas.comprimento, 3).definirValores(linhas); }

O exemplo utiliza MySQL. Para os outros mecanismos de busca, apenas a string de conexão muda: jdbc:postgresql://, jdbc:sqlserver:// e jdbc:oracle:thin:@ seguem o mesmo formato, e o Cloud SQL usa jdbc:google:mysql://Antes de executar esse processo, seu banco de dados precisa aceitar conexões dos servidores do Google. O Google publica os intervalos de endereços como um catálogo online. Arquivo JSON que você adiciona ao firewall do seu banco de dados e mantém atualizado, e o banco de dados deve escutar na porta 1025 ou superior. Os limites que se tornam relevantes na prática vêm do Google. página de cotas:

O exemplo acima esconde duas coisas. Os próprios exemplos do Google passam o nome de usuário e a senha como strings simples no código, e a maioria dos scripts por aí copia isso; o truque das propriedades do script os mantém fora do código-fonte, mas qualquer pessoa que possa editar o script ainda pode lê-los. E cada linha precisa caber na memória do script e terminar dentro dos seis minutos, então uma consulta lenta ou uma tabela grande significa dividir o trabalho manualmente. Se sua tabela for pequena, seu banco de dados já estiver acessível pela internet e um único desenvolvedor for responsável pelo script, o JDBC funciona bem. O restante desta página é para todos os outros.

O que você vai acabar recebendo em vez disso.

Uma planilha do Google que armazena o resultado de uma consulta SQL em seu banco de dados, com um Executar consulta Botão no painel lateral que exibe as linhas mais recentes sempre que você quiser. Assim:

Vendas Salvo no Drive

ArquivoEditarVisualizarInserirFormatarDadosFerramentasExtensõesAjuda

	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

+ clientes Folha1 Ao vivo do seu banco de dados

A diferença está em onde a consulta é executada. Com JDBC, os servidores do Google abrem uma conexão com seu banco de dados, então seu firewall precisa permitir o acesso e o script precisa armazenar a senha. Com o Query Streams, um pequeno programa chamado Agente é executado em um computador que já tem acesso ao banco de dados, faz uma única conexão de saída com o Query Streams e executa o SQL lá. O complemento do Google Sheets solicita as linhas e somente as linhas são transmitidas. Nada é aberto no seu firewall e a senha nunca sai do Agente.

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.

Seus próprios detalhes de conexão

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.

Configure em quatro etapas

1. Crie sua conta

   Vá para my.querystreams.com e faça login com a conta do Google que você usa para o Planilhas. Escolha a Gratuito É um plano real, não um teste, e abrange duas conexões e consultas SQL ad-hoc a partir do Google Sheets.

2. 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: 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.

   Guias completos, se você quiser: Janelas, Mac, Linux.

3. Adicione sua conexão com o banco de dados.

   No portal aberto Dados → Agentes de Dados, clique Adicionar conector No seu Agente, escolha o tipo de banco de dados e preencha o host, a porta, o banco de dados e um login somente leitura. Clique em Teste de conexão, então SalvarA conexão é estabelecida com o Agente em poucos segundos. Cada banco de dados possui seu próprio passo a passo com os campos exatos: MySQL, PostgreSQL, SQL Server, OráculoO Cloud SQL, o Amazon RDS e os bancos de dados do Azure se conectam da mesma forma; o agente só precisa conseguir acessá-los.

   Sem lista de permissões de IP. O agente se conecta ao seu banco de dados de dentro da sua rede e realiza consultas de fluxos de saída via HTTPS. Não há lista de endereços do Google para adicionar ao firewall nem nada com que se preocupar.

4. Execute o SQL a partir do Google Sheets

   Abra sua planilha e Instale o complemento Query Streams. Se você ainda não fez isso, baixe o Google Workspace Marketplace. Ele reconhece a conta do Google com a qual você já está conectado; não é necessário fazer login separadamente. No painel lateral, clique em Fluxo de consultaSelecione sua conexão e cole o mesmo comando SELECT que você teria inserido no script:

   Exemplo · SQL

   SELECIONAR ID do cliente, nome, cidade
   DE clientes
   ORDEM POR nome
   LIMITE 1000;

   Selecione a aba abaixo Folha de Destino e clique em Executar consultaAs linhas ficam abaixo dos cabeçalhos das colunas. Clique. Executar consulta Novamente, sempre que desejar os dados mais recentes. Para que a planilha seja atualizada automaticamente, salve a consulta no Construtor de Consultas e configure um Automação, que o executa em intervalos que variam de cinco minutos a semanalmente.

Lado a lado, apenas o que se mantém de pé.

O que os planos permitem

O SQL ad-hoc do complemento Google Sheets está disponível em todos os planos, inclusive no gratuito. O plano gratuito inclui duas conexões e uma franquia mensal de dados de 5 MB para resultados, suficiente para uma tabela como a acima, atualizada várias vezes ao dia. A execução de consultas salvas no Construtor de Consultas do complemento está disponível a partir do plano Personal Core; consultas compartilhadas por um colega são executadas em todos os planos. Consulte a página de preços. para as verbas previstas no plano.

Perguntas que as pessoas fazem

Guias relacionados

• Como conectar o MySQL ao Google Sheets
• Como conectar o PostgreSQL ao Google Sheets
• Como conectar o SQL Server ao Google Sheets
• Sincronizar MySQL com o Google Sheets de acordo com uma programação
• Instale o complemento do Google Sheets
• Power Query para Google Sheets