Client Cloudflare D1 per Mac
Raggiungi i database D1 del tuo account Cloudflare da un’unica connessione, interrogali nel dialetto SQLite tramite l’API di Cloudflare e gestisci tabelle, indici e trigger nella scheda Structure.
Funziona su MacIl driver viene scaricato la prima volta che scegli Cloudflare D1
A colpo d’occhio
- Linguaggio di query
- SQL
- Driver
- Scaricato al primo utilizzo
- Connetti tramite
- API del servizio
- iPhone e iPad
- Non si apre
Connetti con un token API
Una connessione D1 richiede tre valori: nome o UUID del database, ID dell’account Cloudflare e un token API. Il token va nel campo API Token ed è conservato nel portachiavi di macOS. Non ci sono host, porta, impostazioni SSL o tunnel SSH perché ogni richiesta raggiunge l’API di Cloudflare tramite HTTPS.
Crea il token dal modello Custom token con il permesso Account > D1 > Edit e copialo quando Cloudflare lo mostra, perché viene mostrato una sola volta. Quel token raggiunge ogni database D1 dell’account, non solo quello a cui ti connetti.
Importare un URL d1://account-id/database-name compila account e database; il token non viene mai inserito nell’URL, quindi incollalo in seguito.
Passa tra database ed esegui query
Il selettore di database nella barra degli strumenti elenca i database D1 dell’account e permette di passare tra essi senza riconnettersi. Crea ed elimina anche database. Ogni scheda rimane sul database su cui è stata aperta.
Le query usano il dialetto SQLite. EXPLAIN QUERY PLAN viene rappresentato come diagramma e le modifiche alle righe restano nella griglia fino al salvataggio, con Preview SQL che mostra prima le istruzioni.
Scrivi ogni istruzione in modo che sia autonoma: un’impostazione PRAGMA o una tabella temporanea creata da un’istruzione scompare alla successiva e ogni istruzione viene confermata all’esecuzione, senza possibilità di rollback. Quando Cloudflare limita una richiesta, l’errore indica il tempo di attesa richiesto prima di riprovare.
Tabelle, indici e trigger
La scheda Structure crea ed elimina tabelle, aggiunge ed elimina colonne e crea ed elimina indici, inclusi indici parziali con una condizione WHERE; Preview SQL mostra il DDL prima di salvare. La scheda Triggers crea, modifica ed elimina trigger e le tabelle possono essere rinominate dalla barra laterale.
Riordinare colonne o modificare una chiave esterna richiede la ricostruzione della tabella. Su D1, TablePro scrive lo script di ricostruzione e te lo consegna da eseguire, perché ogni istruzione è una richiesta separata e nessuna transazione può racchiudere la ricostruzione.
Sposta i dati
TablePro non offre importazione per D1. Carica un file SQL con wrangler d1 execute e l’opzione --file, poi esplora il risultato qui. Export scrive una tabella D1 o il risultato di una query in CSV, JSON, SQL, XLSX, Markdown, HTML e XML.
iPhone e iPad
L’app per iPhone e iPad non ha un driver Cloudflare D1. Le connessioni Cloudflare D1 sincronizzate da un Mac compaiono nell’elenco, ma non si aprono.
Limiti
- Ogni istruzione è una richiesta HTTP separata: lo stato della sessione non viene mantenuto e le transazioni non sono supportate.
Domande su Cloudflare D1
TablePro usa la Sessions API di D1?
No. Ogni istruzione viene inviata come richiesta autonoma, senza sessione né bookmark, quindi nulla viene mantenuto tra un’istruzione e la successiva, nella stessa scheda o tra schede.
Devo installare Wrangler?
Non per esplorare, interrogare o modificare: TablePro comunica direttamente con l’API di Cloudflare. Wrangler serve solo per caricare un file SQL, poiché TablePro non offre importazione per D1.
Scarica TablePro
Richiede macOS 13 Ventura o successivo