Conectar
Copie a URL de conexão da página do banco de dados no dashboard. Ela tem este formato, com o usuáriosquarecloud e o banco squarecloud já criados para você:
ssl-mode=REQUIRED, ou VERIFY_CA com o .pem de Conexão → Certificado SSL/TLS como CA para também verificar o servidor.
O servidor aceita só a autenticação caching_sha2_password. Drivers antigos que não a têm, como o pacote mysql do npm, não conseguem fazer login: use o mysql2 no Node.js ou um conector atual.
- Node.js
- Python
- mysql CLI
'%'.
ORMs e ferramentas GUI (Prisma, MySQL Workbench, DBeaver, HeidiSQL) estão em erros de conexão com banco de dados.
Conexões
Cada banco de dados aceita até 256 conexões simultâneas; passando disso, as novas falham comToo many connections. Crie um pool por processo na inicialização e reutilize-o, dimensionado para que todas as aplicações, workers e shards juntos fiquem abaixo do limite. A aba Insights mostra quem está com as conexões abertas.
Seu usuário e permissões
O usuáriosquarecloud@'%' tem todos os privilégios, com GRANT OPTION, exceto os administrativos. Você pode criar bancos de dados, usuários e grants, rotinas, triggers e eventos, e mudar variáveis globais com SET GLOBAL e SET PERSIST.
O que os privilégios administrativos permitiriam não está disponível:
- arquivos no lado do servidor:
LOAD DATA INFILEeSELECT ... INTO OUTFILE; FLUSH PRIVILEGES, que respondeERROR 1227. Ele não é necessário:GRANT,CREATE USEReALTER USERvalem na hora;SHOW ENGINE INNODB STATUS;- replicação.
Importar um dump
Dumps feitos em outro servidor costumam trazerDEFINER=root@localhost (ou outra conta administrativa) em views, rotinas, triggers e eventos. A importação falha com ERROR 1227 (42000): Access denied; you need (at least one of) the ... privilege(s). Remova essas cláusulas antes de importar, ou troque-as pelo seu próprio usuário:
Configuração
- Sem binary log. Replicação, change data capture (Debezium e similares) e recuperação point-in-time não estão disponíveis.
- Buffer pool: o
innodb_buffer_pool_sizemantém o padrão do MySQL, de 128 MB; ele não cresce com a RAM do banco. Você pode aumentá-lo dentro da RAM que alocou, deixando espaço para as conexões e para o próprio servidor (cerca de metade da RAM é um começo seguro):Um valor persistido se perde quando o banco é restaurado de um snapshot ou atualizado: defina-o de novo depois. max_allowed_packeté 64 MB, a maior instrução ou linha que o servidor aceita.- O resto da configuração do servidor é igual em todos os bancos.
Consultas lentas
A aba Insights lista as instruções por tempo médio (qualquer instrução com uma execução de 100 ms ou mais). Para o slow query log bruto, ative-o: ele é gravado na tabelamysql.slow_log com o mesmo limite de 100 ms, nunca expira e usa o armazenamento do banco, então esvazie-o quando terminar:
Snapshots
Um snapshot do MySQL contém seus schemas, rotinas, triggers, eventos e usuários, exportados em uma única transação: consistente para tabelas InnoDB, sem garantia para MyISAM. Além dos casos gerais, ele falha quando umLOCK TABLES seu o bloqueia por mais de 5 minutos. A exportação é texto SQL puro, então um banco perto dos 10 GB de armazenamento pode não caber em um snapshot.
Erros comuns
Depois de uma parada forçada, o MySQL roda a recuperação de falhas no próximo início, o que demora mais em bancos grandes: aguarde até ela terminar.

