Consultando com D1 SQL na borda
Use o Cloudflare D1, um banco de dados SQLite sem servidor, para executar consultas relacionais a partir de seus Workers na borda.
Consultando com D1 SQL na borda é uma aula grátis de Edge Computing with Cloudflare Workers & Deno no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Edge Computing with Cloudflare Workers & Deno, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Edge Computing with Cloudflare Workers & Deno inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
What is D1?
Cloudflare D1 is a serverless SQL database built on SQLite. It brings relational queries to the edge, complementing key-value (KV) and Durable Objects.
KV vs D1
When to use which:
- KV: simple key-value, eventual consistency
- D1: structured data, joins, transactions, SQL
Creating a Database
Create a D1 database from the CLI, then bind it to your Worker.
wrangler d1 create my-dbBinding D1
Add the binding to wrangler.toml so the database appears on the env object.
# wrangler.toml
[[d1_databases]]
binding = 'DB'
database_name = 'my-db'
database_id = 'xxxx'Creating a Schema
Define tables with standard SQL, executed via the CLI or a migration file.
CREATE TABLE users (
id INTEGER PRIMARY KEY,
email TEXT NOT NULL UNIQUE
);Prepared Statements
Query D1 from your Worker using prepared statements with bound parameters to prevent SQL injection.
const row = await env.DB
.prepare('SELECT * FROM users WHERE id = ?')
.bind(userId)
.first();Reading Multiple Rows
Use .all() to fetch every matching row as an array of objects.
const { results } = await env.DB
.prepare('SELECT email FROM users LIMIT 10')
.all();Writing Data
Inserts and updates use the same prepared-statement API with .run().
await env.DB
.prepare('INSERT INTO users (email) VALUES (?)')
.bind('a@b.com')
.run();Batching Statements
Run several statements atomically in a single round trip with batch, reducing latency.
await env.DB.batch([
env.DB.prepare('INSERT INTO users (email) VALUES (?)').bind('x@y.com'),
env.DB.prepare('INSERT INTO users (email) VALUES (?)').bind('p@q.com')
]);Consistency & Replication
D1 offers strong consistency on its primary, with read replication for low-latency reads near users. Plan writes around the primary location.
When to Choose D1
Pick D1 when you need relational structure, transactions, and SQL at the edge; pick KV for fast simple lookups and Durable Objects for coordinated state.
Quick Check
Test your D1 knowledge.
Recap
You learned to create and bind a D1 database, define schemas, run safe parameterized queries, batch statements, and choose D1 over KV or Durable Objects when you need relational data at the edge.
Aprenda Edge Computing with Cloudflare Workers & Deno com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 12
- Aulas
- 47
Perguntas Frequentes
A aula “Consultando com D1 SQL na borda” é grátis?
Sim — o texto completo de “Consultando com D1 SQL na borda” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Edge Computing with Cloudflare Workers & Deno, atualize para CoddyKit PRO. O curso de Edge Computing with Cloudflare Workers & Deno inclui 4 aulas no total.
O que vou aprender em “Consultando com D1 SQL na borda”?
Use o Cloudflare D1, um banco de dados SQLite sem servidor, para executar consultas relacionais a partir de seus Workers na borda. Você pratica Edge Computing with Cloudflare Workers & Deno com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Edge Computing with Cloudflare Workers & Deno?
Nenhuma experiência prévia é necessária. Edge Computing with Cloudflare Workers & Deno no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Consultando com D1 SQL na borda”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Edge Computing with Cloudflare Workers & Deno?
Sim. Cada aula de Edge Computing with Cloudflare Workers & Deno inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Armazenamento Cloudflare KV
- Objetos Duráveis explicados
- Integração do Deno com armazenamento na borda
- Consultando com D1 SQL na borda