Ir para o conteúdo

Cliente de Turso e libSQL

Conecte-se a um banco de dados Turso com a URL e o token dele, ou abra um arquivo libSQL, e consulte-o com a sintaxe do SQLite.

Visão geral

Linguagem de consulta
SQL
Driver
Baixado no primeiro usoCompartilhado com libSQL
Conectar por
API do serviço

Conecte ao Turso

Escolha Remote (Turso) em Connection Mode e cole a URL HTTPS do banco de dados e um API Token, que fica guardado no macOS Keychain. Os dois vêm do painel ou da CLI do Turso.

Uma URL libsql:// importada vira uma conexão remota HTTPS, e cada URL indica um banco de dados. URLs HTTP simples não são criptografadas, e túneis SSH não estão disponíveis.

Consulte e edite

O libSQL usa a sintaxe do SQLite, então navegação, diagramas EXPLAIN QUERY PLAN e exportação funcionam como no SQLite.

Uma conexão remota não executa transações: cada instrução é uma requisição HTTP própria e é confirmada sozinha, e BEGIN falha com “Transactions are not supported in this mode”. Transações exigem um arquivo local, aberto como libSQL. O modo remoto não carrega extensões SQLite, já que um banco Turso roda as que vieram na compilação do servidor, e o erro de uma requisição limitada informa quantos segundos aguardar.

Tabelas, índices e triggers

A aba Structure cria tabelas, adiciona e remove colunas e índices, e cria, edita e remove triggers. Tabelas, mas não views, podem ser renomeadas pela barra lateral.

Reordenar colunas ou alterar uma chave estrangeira no modo remoto gera um script de reconstrução para você revisar e executar, porque o TablePro não consegue manter requisições HTTP separadas em uma única transação.

Esta página trata do que é específico de Turso. Safe Mode, o assistente de IA, o servidor MCP e o resto do TablePro estão nas páginas de recursos.

libSQL

Escolha libSQL para um servidor sqld hospedado por você, acessado pelo endpoint de pipeline Hrana v2, ou para um arquivo neste Mac no modo Local File. Um arquivo local executa transações, carrega extensões SQLite e executa scripts de reconstrução depois da sua confirmação, e Backup Dump e Restore Dump executam sqlite3 nele.

Nunca abra um arquivo que um app em execução sincroniza como réplica incorporada do Turso: o acesso simultâneo por dois programas pode corrompê-lo.

Limitações
  • Backup Dump funciona apenas para arquivos libSQL locais, não para bancos remotos.

Também

  • Mover dados

    Exporte uma tabela ou o resultado de uma consulta como CSV, JSON, SQL, XLSX, Markdown, HTML e XML. Para carregar dados, use a CLI do Turso ou uma importação no seu servidor sqld.

  • Limitações

    • Cada conexão é um banco. Alternância entre bancos e branches não são compatíveis.
    • Réplicas integradas não são compatíveis: um arquivo local abre sozinho e não sincroniza.
  • Devo escolher Remote ou Local File?

    Remote, para um banco Turso ou servidor sqld acessado por URL. Local File, para um arquivo libSQL neste Mac, que também oferece transações, extensões SQLite e backups.

  • Preciso instalar a CLI do Turso?

    Não. O painel do Turso também mostra a URL do banco de dados e cria tokens. A CLI é útil para carregar dados pelo terminal.

Baixe o TablePro

Tudo nesta página é gratuito.