O SurrealDB Earth é um serviço gerenciado de banco de dados serverless da SurrealDB, executado na rede Cloudflare. Ele mantém os dados persistentes, adiciona computação conforme a demanda e reduz a computação a zero quando fica ocioso. Oferece SurrealQL, transações e live queries, com limitações próprias. Documentação oficial.
O SurrealDB Earth oferece uma alternativa: um serviço gerenciado de SurrealDB que executa na rede Cloudflare, aumenta a capacidade conforme a demanda e reduz o uso de computação a zero quando fica ocioso. O serviço mantém SurrealQL, transações e live queries, com restrições específicas documentadas. Documentação do Earth.
O que a Cloudflare faz nessa arquitetura
O Earth é um produto da SurrealDB construído sobre a infraestrutura da Cloudflare. A documentação organiza seu funcionamento em três partes: computação distribuída pela rede, um log de commits por instância e armazenamento de objetos em uma única localização.
Cada sessão de cliente é atendida por uma unidade de computação. Quando as unidades atuais ficam ocupadas, o serviço inicia outras. As transações seguem uma ordem única de commit por instância, e a confirmação ocorre depois de persistir o commit em armazenamento durável.
Essa separação permite substituir computação sem depender de dados exclusivos de um único processo. Se uma unidade falha, outra pode atender as sessões e ler os dados do armazenamento. Arquitetura documentada.
Consultas distribuídas, dados em uma localização
O processamento recebe conexões por pontos da rede próximos aos clientes, mas os dados de uma instância permanecem em uma localização. Essa distinção ajuda a interpretar a promessa de execução global: ela não significa uma cópia integral dos dados em cada cidade onde existe presença da Cloudflare.
Para uma aplicação com usuários em vários países, a entrada pela rede distribuída pode ser útil. A latência final, porém, depende da consulta, dos dados acessados, dos caches e dos caminhos até o armazenamento. O comportamento precisa ser medido com a distribuição real dos usuários. Como o Earth funciona.
O banco dorme e acorda com a demanda
Depois da última requisição, uma instância ociosa deixa de usar computação. A próxima requisição a desperta. A página comercial informa inicialização a frio em aproximadamente 300 ms; a documentação ressalta que a primeira requisição após o período ocioso pode levar mais tempo.
Isso favorece ferramentas internas, aplicações com tráfego irregular e agentes que trabalham em intervalos. Para cargas contínuas ou requisitos rigorosos de latência, a comparação com capacidade dedicada precisa considerar o custo total e a experiência nas primeiras requisições. Apresentação do Earth, critérios de uso.
Como uma aplicação se conecta
O Earth aceita Studio, SDKs, CLI e HTTP usando o endereço da instância. Para clientes que enviam muitas consultas, a documentação recomenda WebSocket: uma sequência de requisições HTTP repete trabalho de roteamento e autenticação.
Também existem conexões TCP para clientes PostgreSQL e MySQL, com TLS obrigatório. O cliente precisa identificar a instância no nome TLS do servidor ou no usuário no formato indicado pela documentação. Nesse acesso SQL do Earth, a autenticação utiliza usuários definidos no nível do database.
Durante a expansão de capacidade, uma nova requisição pode receber HTTP 503. Para esse caso documentado, o trabalho ainda não começou e pode ser reenviado com atraso progressivo. Essa regra não deve ser estendida automaticamente a qualquer timeout: quando o resultado de uma escrita é desconhecido, a aplicação precisa de uma estratégia própria para evitar duplicação. Conexões e respostas de indisponibilidade.
O que ainda não está disponível
A documentação consultada em 3 de novembro de 2026 lista quatro restrições relevantes:
| Recurso | Situação no Earth |
|---|---|
| Change feeds | Indisponíveis; SHOW CHANGES retorna erro. |
| Surrealism/extensões WebAssembly | Não podem ser carregadas ou chamadas. |
| Funções JavaScript embutidas | Desativadas; a capacidade de scripting não pode ser habilitada. |
| Índices vetoriais DiskANN | Indisponíveis; HNSW é a alternativa suportada. |
Live queries continuam disponíveis. Portanto, notificações de atualização em tempo real e change feeds precisam ser avaliados como recursos diferentes. Um sistema que depende de histórico de mudanças não deve presumir que live queries substituem esse mecanismo. Limitações atuais.
Quanto custa no lançamento
A tabela oficial consultada em 3 de novembro de 2026 apresenta estas franquias mensais:
| Medida | Free | Pro |
|---|---|---|
| Mensalidade | US$ 0 | US$ 15 por conta, preço de lançamento |
| Requisições | 3 milhões | 10 milhões |
| Armazenamento | 10 GB | 25 GB |
| Horas ativas de database | 100 | 1.000 |
| Databases | Até 100 | Até 100 |
Os databases compartilham a franquia da conta. No Pro, a tabela informa excedentes de US$ 0,65 por milhão de requisições, US$ 0,25 por GB-mês e US$ 0,05 por hora ativa. No Free, atingir um limite pausa o serviço e preserva os dados. O Pro também tem limites máximos publicados: 1 bilhão de requisições, 1 TB de armazenamento e 100 escritas por segundo. Preços e limites podem mudar. Tabela oficial de preços.
“Escalar a zero” reduz a computação ociosa; armazenamento e outras métricas continuam fazendo parte da conta. Uma plataforma com muitos databases precisa observar o consumo agregado de horas ativas, além do volume de consultas.
Como interpretar os bilhões de linhas por segundo
A página de benchmarks relata varredura de cinco bilhões de linhas distribuída por aproximadamente seis mil unidades chamadas Earth Cells. O fornecedor informa mais de 3,1 bilhões de linhas por segundo no melhor segundo e pico de mais de 18,9 bilhões em uma janela de 100 ms, para linhas de aproximadamente 120 bytes.
Esses valores descrevem um teste distribuído de varredura. Não representam bilhões de requisições SQL independentes, capacidade garantida por database ou franquia de um plano comercial. Cenário e métricas do benchmark.
O Earth merece avaliação quando a ociosidade, a distribuição dos clientes e a separação entre databases pesam na arquitetura. A escolha depende de confrontar essas vantagens com as funções disponíveis, os limites do plano e a carga real da aplicação.
Perguntas frequentes sobre o SurrealDB Earth
O SurrealDB Earth é gratuito?
Existe plano Free com franquias de requisições, armazenamento e horas ativas. Ao atingir um limite, o serviço pausa e preserva os dados. Valores e limites neste artigo foram conferidos em 3 de novembro de 2026. Preços oficiais.
O Earth replica todos os dados globalmente?
A documentação informa armazenamento da instância em uma única localização e acesso por computação distribuída na rede Cloudflare. Consultas de várias regiões não significam uma cópia completa dos dados em cada região. Arquitetura.
O Earth suporta busca vetorial e tempo real?
Sim, com índices HNSW e live queries. Na documentação consultada, DiskANN e change feeds ainda não estão disponíveis. Recursos e limitações.
Última checagem das fontes: 3 de novembro de 2026.
Continue a leitura
SurrealDB 4: SQL, novo executor e o que muda para quem cria aplicações
SurrealDB 4 e Earth: o que a combinação muda para SaaS e agentes de IA
