Turso & Astro

Turso è un database basato su libSQL, una fork di SQLite. È ottimizzato per query a bassa latenza, rendendolo adatto ad applicazioni globali.

Inizializzare Turso in Astro

Prerequisiti

La Turso CLI installata, con accesso eseguito
Un Database Turso con uno schema
L’URL del tuo Database
Un token di accesso

Configura le variabili di ambiente

Ottieni l’URL del tuo database usando il comando seguente:

turso db show <database-name> --url

Crea un token di autorizzazione per il database:

turso db tokens create <database-name>

Aggiungi l’output dei due comandi nel tuo file .env nella cartella root del tuo progetto. Se il file non esiste, crealo.

TURSO_DATABASE_URL=libsql://...
TURSO_AUTH_TOKEN=

Installa il Client di LibSQL

Installa la libreria @libsql/client per connettere Turso ad Astro:

npm install @libsql/client

pnpm add @libsql/client

yarn add @libsql/client

Inizializzare un nuovo client

Crea un file turso.ts nella cartella src e richiama createClient, passando le variabili TURSO_DATABASE_URL e TURSO_AUTH_TOKEN:

import { createClient } from "@libsql/client/web";

export const turso = createClient({
  url: import.meta.env.TURSO_DATABASE_URL,
  authToken: import.meta.env.TURSO_AUTH_TOKEN,
});

Esegui query sul Database

Per accedere delle informazioni sul tuo database, importa turso e esegui una query SQL dentro qualunque compoennte .astro.

L’esempio seguente ottiene tutti i posts dalla tua tabella, mostrando a schermo una lista di titoli in un componente <BlogIndex />:

---
import { turso } from '../../turso'

const { rows } = await turso.execute('SELECT * FROM posts')
---

<ul>
  {rows.map((post) => (
    <li>{post.title}</li>
  ))}
</ul>

Placeholders SQL

Il metodo execute() può prendere un oggetto per passare variaibli alla dichiariazione SQL, come uno slug, o un’impaginazione.

L’esempio seguente ottiene un valore singolo dalla tabella posts WHERE lo slug è un valore ottenuto da Astro.params, a questo punto mostra a schermo il titolo del post.

---
import { turso } from '../../turso'

const { slug } = Astro.params

const { rows } = await turso.execute({
  sql: 'SELECT * FROM posts WHERE slug = ?',
  args: [slug!]
})
---

<h1>{rows[0].title}</h1>