Pular para o conteúdo principal
Uma instância MySQL gerenciada que só aceita conexões TLS, com um usuário que gerencia os próprios bancos de dados, usuários, rotinas e eventos. O que vale para todos os engines (limites, snapshots, Insights) está na visão geral de Bancos de dados.

Conectar

Copie a URL de conexão da página do banco de dados no dashboard. Ela tem este formato, com o usuário squarecloud e o banco squarecloud já criados para você:
O MySQL exige SSL/TLS; não é preciso certificado do cliente. Use 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.
O servidor não resolve nomes de host: ao criar usuários, a parte do host é um endereço IP ou '%'. 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 com Too 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ário squarecloud@'%' 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 INFILE e SELECT ... INTO OUTFILE;
  • FLUSH PRIVILEGES, que responde ERROR 1227. Ele não é necessário: GRANT, CREATE USER e ALTER USER valem na hora;
  • SHOW ENGINE INNODB STATUS;
  • replicação.

Importar um dump

Dumps feitos em outro servidor costumam trazer DEFINER=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_size manté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 tabela mysql.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 um LOCK 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.

Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão: a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com 4,9/5 em 402 avaliações no Google e Trustpilot.