Ir para o conteúdo

Usa TablePro todo dia? Uma licença adiciona recursos pagos e financia a próxima versão. Compre uma licençaCompre uma licença

Cliente de Cloudflare D1 para Mac

Acesse os bancos D1 da sua conta Cloudflare por uma conexão, consulte-os no dialeto de SQLite pela API da Cloudflare e gerencie tabelas, índices e triggers na aba Structure.

Funciona em MacO driver é baixado na primeira vez que você escolhe Cloudflare D1

Visão geral

Linguagem de consulta
SQL
Driver
Baixado no primeiro uso
Conectar por
API do serviço
iPhone e iPad
Não abre

Conecte com um token de API

Uma conexão D1 usa três valores: o nome ou UUID do banco, o ID da sua conta Cloudflare e um token de API. O token fica no campo API Token e é armazenado no Chaves do macOS. Não há host, porta, configuração SSL ou túnel SSH, pois todas as requisições usam HTTPS para acessar a API da Cloudflare.

Crie o token pelo modelo Custom token com a permissão Account > D1 > Edit e copie-o quando a Cloudflare o mostrar, pois ele só é exibido uma vez. Esse token acessa todos os bancos D1 da conta, não apenas aquele ao qual você se conecta.

Importar uma URL d1://account-id/database-name preenche a conta e o banco; o token nunca é incluído na URL, portanto cole-o depois.

Alterne entre bancos e consulte

O seletor de bancos na barra de ferramentas lista os bancos D1 da conta e alterna entre eles sem reconectar. Ele também cria e exclui bancos. Cada aba permanece no banco em que foi aberta.

As consultas usam o dialeto de SQLite. EXPLAIN QUERY PLAN é apresentado como um diagrama, e as edições de linhas aguardam na grade até salvar, com Preview SQL mostrando as instruções antes da execução.

Escreva cada instrução para funcionar de forma independente: uma configuração PRAGMA ou uma tabela temporária criada por uma instrução desaparece na próxima, e cada instrução é confirmada quando executada, sem possibilidade de rollback. Quando a Cloudflare limita a frequência de uma requisição, o erro informa o tempo de espera solicitado antes de tentar novamente.

Tabelas, índices e triggers

A aba Structure cria e exclui tabelas, adiciona e remove colunas e cria e exclui índices, incluindo índices parciais com uma condição WHERE; Preview SQL mostra o DDL antes de salvar. A aba Triggers cria, edita e exclui triggers, e as tabelas podem ser renomeadas pela barra lateral.

Reordenar colunas ou alterar uma chave estrangeira exige reconstruir a tabela. Em D1, TablePro escreve esse script de reconstrução e o entrega para você executar, pois cada instrução é uma requisição separada e nenhuma transação pode manter a reconstrução como uma operação única.

Mova dados

TablePro não tem importação para D1. Carregue um arquivo SQL com wrangler d1 execute e a opção --file, depois explore o resultado aqui. Export grava uma tabela D1 ou o resultado de uma consulta como CSV, JSON, SQL, XLSX, Markdown, HTML e XML.

iPhone e iPad

O app para iPhone e iPad não tem um driver de Cloudflare D1. As conexões Cloudflare D1 sincronizadas de um Mac aparecem na lista, mas não abrem.

Limitações

  • Cada instrução é uma solicitação HTTP separada: o estado da sessão não é mantido, e transações não são compatíveis.

Perguntas sobre Cloudflare D1

TablePro usa a Sessions API de D1?

Não. Cada instrução é enviada como sua própria requisição, sem sessão nem bookmark, portanto nada é mantido entre instruções, seja na mesma aba ou entre abas.

Preciso instalar Wrangler?

Não para navegar, consultar ou editar: TablePro se comunica diretamente com a API da Cloudflare. Wrangler só é necessário para carregar um arquivo SQL, já que TablePro não tem importação para D1.

Baixe TablePro

O app para Mac é gratuito para baixar e usar. Um plano Starter ou Team adiciona recursos opcionais.
Baixar para Mac

Requer macOS 13 Ventura ou posterior