Como usar KV do Cloudflare na prática

Como usar KV do Cloudflare na prática: Armazenamento de Dados na Borda

No desenvolvimento de aplicações modernas, a velocidade e a baixa latência são cruciais. Com a ascensão da computação de borda, o armazenamento de dados próximo ao usuário final tornou-se um diferencial competitivo. É nesse cenário que o Cloudflare Workers KV (Key-Value) se destaca. Mas, afinal, como usar KV do Cloudflare na prática para impulsionar seus projetos?

Neste artigo, vamos explorar o que é o Cloudflare KV, seus principais casos de uso, e, mais importante, mergulhar em exemplos práticos de como configurá-lo e interagir com ele através de Cloudflare Workers. Se você é um desenvolvedor buscando otimizar o desempenho de suas aplicações serverless, você está no lugar certo para aprender Como usar KV do Cloudflare na prática.

O que é Cloudflare Workers KV?

Cloudflare Workers KV é um armazenamento de dados distribuído globalmente, projetado para ser extremamente rápido e simples. Como um banco de dados NoSQL do tipo chave-valor, ele permite que você armazene pequenas porções de dados (valores) acessíveis por uma chave única. A principal vantagem é que esses dados são replicados na rede global da Cloudflare, o que significa que eles estão sempre próximos de seus usuários, resultando em latência mínima.

É uma ferramenta poderosa para aplicações que precisam de acesso rápido a dados que não mudam com extrema frequência ou que não exigem a complexidade de um banco de dados relacional completo. Entender isso é o primeiro passo para aprender Como usar KV do Cloudflare na prática de forma eficaz.

Por Que Usar Cloudflare KV?

Existem várias razões para considerar o uso do KV em seus projetos:

• Latência Ultra Baixa: Os dados são armazenados na borda da rede da Cloudflare, muito próximos dos seus usuários.
• Escalabilidade Global: Projetado para escalar automaticamente para atender às suas necessidades, sem gerenciamento de infraestrutura.
• Simplicidade: Modelo de dados chave-valor é fácil de entender e usar.
• Custo-Benefício: Geralmente mais acessível para casos de uso específicos do que soluções de banco de dados tradicionais.
• Integração Perfeita: Funciona nativamente com Cloudflare Workers.

Casos de Uso Comuns para o KV

Antes de mergulharmos em Como usar KV do Cloudflare na prática, vejamos alguns cenários onde ele brilha:

• Flags de Recursos: Ativar ou desativar funcionalidades para usuários ou grupos específicos.
• Configurações A/B Testing: Armazenar diferentes variantes de configuração para testes.
• Caching de Conteúdo Dinâmico: Armazenar respostas de API ou HTML pré-renderizado por curtos períodos.
• Preferências do Usuário: Guardar configurações simples de usuário para personalização.
• Contadores Simples: Implementar limites de taxa ou contadores de visualização de forma distribuída.

Como usar KV do Cloudflare na prática: Configuração Inicial

Para começar a usar o KV, você precisará de uma conta Cloudflare e um Worker. Siga estes passos iniciais:

1. Criar um Namespace KV

No painel da Cloudflare, vá para a seção “Workers” e depois “KV”. Clique em “Create a Namespace” e dê um nome descritivo, por exemplo, MEU_APP_CONFIGS. Este namespace é como uma “tabela” ou “bucket” onde suas chaves e valores serão armazenados.

2. Vincular o KV ao seu Worker

Após criar o namespace, você precisa vinculá-lo ao seu Cloudflare Worker. Edite seu Worker (ou crie um novo) e, nas configurações, vá para “Settings” > “KV Namespace Bindings”. Adicione uma nova ligação, escolhendo o namespace que você criou e um nome de variável para ele, por exemplo, CONFIGS. Este nome de variável será como você acessará o KV dentro do seu código Worker.

Interagindo com KV via Cloudflare Workers

Agora que o setup básico está feito, vamos ver Como usar KV do Cloudflare na prática com exemplos de código JavaScript para Workers.

Escrita de Dados (put)

Para armazenar um valor, usamos o método put(). Ele aceita a chave, o valor e, opcionalmente, um objeto de opções (como TTL - Time-To-Live).

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  const url = new URL(request.url)
  const path = url.pathname

  if (path === '/set-config') {
    const value = 'Hello Cloudflare KV!'
    await CONFIGS.put('welcome_message', value, { expirationTtl: 60 }) // Expira em 60 segundos
    return new Response('Configuração salva com sucesso!', { status: 200 })
  }

  return new Response('Rota não encontrada.', { status: 404 })
}

Neste exemplo, CONFIGS é o nome da variável que vinculamos ao nosso namespace KV. O valor é salvo com um TTL, o que significa que ele será automaticamente removido após 60 segundos.

Leitura de Dados (get)

Para recuperar um valor, usamos o método get(), passando a chave. Você pode especificar o tipo de dado esperado ('text', 'json', 'arrayBuffer', 'stream').

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  const url = new URL(request.url)
  const path = url.pathname

  if (path === '/get-config') {
    const message = await CONFIGS.get('welcome_message')
    if (message) {
      return new Response(`Mensagem do KV: ${message}`, { status: 200 })
    } else {
      return new Response('Mensagem não encontrada no KV.', { status: 404 })
    }
  }

  return new Response('Rota não encontrada.', { status: 404 })
}

Excluir Dados (delete)

Para remover uma chave e seu valor correspondente, use o método delete().

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  const url = new URL(request.url)
  const path = url.pathname

  if (path === '/delete-config') {
    await CONFIGS.delete('welcome_message')
    return new Response('Configuração excluída com sucesso!', { status: 200 })
  }

  return new Response('Rota não encontrada.', { status: 404 })
}

Listagem de Chaves (list)

Se você precisa listar todas as chaves em um namespace (ou um subconjunto usando prefixos), o método list() é útil.

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  const url = new URL(request.url)
  const path = url.pathname

  if (path === '/list-keys') {
    const list = await CONFIGS.list()
    return new Response(JSON.stringify(list.keys), {
      headers: { 'Content-Type': 'application/json' },
      status: 200
    })
  }

  return new Response('Rota não encontrada.', { status: 404 })
}

Este método retorna um objeto contendo um array de chaves e um cursor para paginação, caso existam muitas chaves.

Considerações e Boas Práticas

Ao aprender Como usar KV do Cloudflare na prática, é importante ter em mente algumas considerações:

• Consistência Eventual: Alterações podem levar um curto período para se propagarem globalmente. Não é adequado para dados que exigem consistência forte e imediata.
• Tamanho do Valor: Cada valor pode ter até 25 MB. Para dados maiores, considere outras soluções como o Cloudflare R2.
• TTL é seu amigo: Use TTLs para gerenciar a expiração de dados e evitar o acúmulo de informações desnecessárias.
• Gerenciamento de Chaves: Pense em uma estratégia clara para nomear suas chaves, talvez usando prefixos para categorizá-las.

Conclusão

Dominar Como usar KV do Cloudflare na prática abre um leque de possibilidades para construir aplicações rápidas e escaláveis na borda da rede. Sua simplicidade e desempenho o tornam uma excelente escolha para uma vasta gama de casos de uso que exigem acesso rápido a dados distribuídos. Ao integrar o KV em seus Cloudflare Workers, você pode otimizar a experiência do usuário e reduzir a carga em seus bancos de dados primários.

Agora que você tem uma base sólida de Como usar KV do Cloudflare na prática, é hora de experimentar! Crie seu próprio namespace, desenvolva um Worker e veja a magia acontecer. As possibilidades são vastas e o desempenho, impressionante. Experimente hoje mesmo!