Aller au contenu

Une licence ajoute les fonctions payantes et finance la prochaine version de TablePro. Acheter une licenceUne licence pour aider TablePro

Client Cloudflare D1 pour Mac

Accédez aux bases D1 de votre compte Cloudflare depuis une seule connexion, interrogez-les en dialecte SQLite via l’API Cloudflare et gérez leurs tables, index et déclencheurs dans l’onglet Structure.

Fonctionne sur MacLe pilote se télécharge la première fois que vous choisissez Cloudflare D1

En bref

Langage de requête
SQL
Pilote
Téléchargé à la première utilisation
Connexion via
L’API du service
iPhone et iPad
Ne s’ouvre pas

Connectez-vous avec un jeton API

Une connexion D1 prend trois valeurs : le nom ou l’UUID de la base, votre ID de compte Cloudflare et un jeton API. Le jeton va dans le champ Jeton API et reste dans le Trousseau macOS. Il n’y a ni hôte, ni port, ni réglage SSL, ni tunnel SSH, car chaque requête va à l’API Cloudflare via HTTPS.

Créez le jeton depuis le modèle de jeton personnalisé avec l’autorisation Compte > D1 > Modifier, puis copiez-le lorsque Cloudflare l’affiche, car il n’apparaît qu’une fois. Ce jeton donne accès à toutes les bases D1 du compte, pas seulement à celle que vous connectez.

L’import d’une URL d1://account-id/database-name remplit le compte et la base ; le jeton n’est jamais transmis dans l’URL, collez-le donc ensuite.

Changez de base et interrogez

Le sélecteur de bases dans la barre d’outils liste les bases D1 du compte et permet d’en changer sans reconnexion. Il crée et supprime aussi des bases. Chaque onglet conserve la base avec laquelle il a été ouvert.

Les requêtes utilisent le dialecte SQLite. EXPLAIN QUERY PLAN est représenté en diagramme et les modifications de lignes attendent dans la grille jusqu’à l’enregistrement ; l’Aperçu SQL montre d’abord les instructions.

Écrivez chaque instruction pour qu’elle soit autonome : un réglage PRAGMA ou une table temporaire créés par une instruction disparaissent à la suivante, et chaque instruction est validée à son exécution, sans possibilité d’annulation. Lorsque Cloudflare limite le débit d’une requête, l’erreur indique l’attente demandée avant une nouvelle tentative.

Tables, index et déclencheurs

L’onglet Structure crée et supprime des tables, ajoute et supprime des colonnes, crée et supprime des index, y compris partiels avec condition WHERE ; l’Aperçu SQL montre le DDL avant l’enregistrement. L’onglet Déclencheurs crée, modifie et supprime les déclencheurs, et les tables se renomment depuis la barre latérale.

Réordonner les colonnes ou changer une clé étrangère nécessite de reconstruire la table. Sur D1, TablePro écrit le script de reconstruction et vous le remet pour exécution, car chaque instruction est une requête distincte et aucune transaction ne peut englober toute la reconstruction.

Transférez des données

TablePro ne propose pas d’import pour D1. Chargez un fichier SQL avec wrangler d1 execute et son option --file, puis parcourez le résultat ici. Exporter écrit une table D1 ou un résultat de requête en CSV, JSON, SQL, XLSX, Markdown, HTML et XML.

iPhone et iPad

L’app iPhone et iPad n’a pas de pilote Cloudflare D1. Les connexions Cloudflare D1 synchronisées depuis un Mac apparaissent dans sa liste, mais ne s’ouvrent pas.

Limites

  • Chaque instruction est une requête HTTP distincte : aucun état de session ne persiste et les transactions ne sont pas prises en charge.

Questions sur Cloudflare D1

TablePro utilise-t-il l’API Sessions de D1 ?

Non. Chaque instruction part comme une requête distincte, sans session ni marqueur ; rien ne persiste donc d’une instruction à l’autre, dans un onglet ou entre onglets.

Dois-je installer Wrangler ?

Pas pour parcourir, interroger ou modifier : TablePro communique directement avec l’API Cloudflare. Wrangler n’est nécessaire que pour charger un fichier SQL, puisque TablePro ne propose pas d’import pour D1.

Obtenir TablePro

L’app Mac se télécharge et s’utilise gratuitement. Un forfait Starter ou Équipe ajoute des fonctions facultatives.
Télécharger pour Mac

Nécessite macOS 13 Ventura ou version ultérieure