Client Turso e libSQL per Mac

Scegli Turso nell’elenco dei tipi di connessione e lascia Connection Mode su Remote (Turso). Incolla l’URL HTTPS del database, che termina con .turso.io, e inserisci un token nel campo API Token, conservato nel portachiavi di macOS. La dashboard di Turso mostra entrambi, così come turso db show my-db --url e turso db tokens create my-db.

Un URL libsql:// viene convertito in HTTPS e importarlo crea una connessione remota. Non ci sono campi per host, porta o database perché l’URL identifica un database. La connessione è cifrata quando l’URL usa HTTPS anziché HTTP non cifrato e non è disponibile un tunnel SSH.

libSQL usa la sintassi di SQLite, quindi navigazione, diagrammi EXPLAIN QUERY PLAN, modifiche in attesa con Preview SQL ed esportazione si comportano come in SQLite.

Una connessione remota non esegue transazioni. Ogni istruzione è una richiesta HTTP separata e viene confermata autonomamente, mentre BEGIN fallisce con “Transactions are not supported in this mode”. Le operazioni transazionali richiedono un file libSQL locale, descritto nella sezione libSQL.

La modalità remota non carica estensioni SQLite: un database Turso esegue quelle incluse nella compilazione del server. Quando Turso limita una connessione, l’errore indica quanti secondi attendere prima di riprovare.

La scheda Structure crea tabelle, aggiunge ed elimina colonne e indici e crea, modifica ed elimina trigger. Le tabelle, ma non le viste, possono essere rinominate dalla barra laterale.

Per riordinare colonne o modificare una chiave esterna su un database remoto, TablePro scrive lo script di ricostruzione che puoi leggere ed eseguire. Non può eseguirlo al tuo posto perché la ricostruzione richiederebbe una transazione tra richieste HTTP separate.

TablePro non offre importazione per Turso o libSQL; carica i dati con la CLI di Turso o un’importazione sul tuo server sqld. Per estrarli, esporta una tabella o il risultato di una query in CSV, JSON, SQL, XLSX, Markdown, HTML e XML.

L’app per iPhone e iPad non ha un driver Turso. Le connessioni Turso sincronizzate da un Mac compaiono nell’elenco, ma non si aprono.

Scaricato al primo utilizzoiPhone e iPad: Non si apre

Scegli libSQL per un server sqld gestito da te o un file su questo Mac. In modalità Remote raggiunge qualsiasi sqld che offra l’endpoint pipeline Hrana v2, incluso uno in esecuzione sul Mac, che ascolta sulla porta 8080 per impostazione predefinita. Lascia vuoto il token per un server avviato senza --auth-jwt-key-file oppure fornisci un JWT corrispondente alla chiave del server.

La modalità Local File apre un file libSQL con il motore SQLite incluso nel driver e crea un percorso non ancora esistente, cartelle comprese. Un file locale esegue transazioni, carica estensioni SQLite dall’elenco Extensions della connessione ed esegue la ricostruzione per riordinare colonne o modificare chiavi esterne dopo la tua conferma.

Le istruzioni comprese solo da libSQL, come ALTER TABLE … ALTER COLUMN, falliscono su un file locale perché vengono ricevute dal motore SQLite. I file libSQL cifrati non si aprono. Non aprire mai un file che un’app in esecuzione sta sincronizzando come replica incorporata di Turso: l’accesso simultaneo da due programmi può danneggiarlo.

Backup Dump e Restore Dump eseguono sqlite3 su un file libSQL locale.

Guida alla configurazione di libSQL (inglese)↗