Cliente de Turso e libSQL para Mac

Escolha Turso na lista de tipos de conexão e deixe Connection Mode em Remote (Turso). Cole a URL HTTPS do banco, que termina em .turso.io, e coloque um token no campo API Token, armazenado no Chaves do macOS. O painel do Turso mostra ambos, assim como turso db show my-db --url e turso db tokens create my-db.

Uma URL libsql:// é convertida para HTTPS, e importá-la cria uma conexão remota. Não há campos de host, porta ou banco, pois a URL identifica um banco. A conexão é criptografada quando a URL usa HTTPS em vez de HTTP sem criptografia, e não há túnel SSH.

libSQL usa a sintaxe de SQLite, portanto navegação, diagramas EXPLAIN QUERY PLAN, edições pendentes com Preview SQL e exportação funcionam como em SQLite.

Uma conexão remota não executa transações. Cada instrução é uma requisição HTTP independente e é confirmada separadamente, e BEGIN falha com “Transactions are not supported in this mode”. Trabalhos transacionais exigem um arquivo libSQL local, descrito na seção libSQL.

O modo remoto não carrega extensões SQLite: um banco Turso executa as incluídas na compilação do servidor. Quando Turso limita uma conexão, o erro informa quantos segundos aguardar antes de tentar novamente.

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.

Para reordenar colunas ou alterar uma chave estrangeira em um banco remoto, TablePro escreve o script de reconstrução para você ler e executar. Ele não pode executá-lo por você, pois a reconstrução exigiria uma transação que abrangesse requisições HTTP separadas.

TablePro não tem importação para Turso ou libSQL; carregue dados pela CLI do Turso ou por uma importação no seu servidor sqld. Para extrair dados, exporte uma tabela ou o resultado de uma consulta como CSV, JSON, SQL, XLSX, Markdown, HTML e XML.

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

Baixado no primeiro usoiPhone e iPad: Não abre

Escolha libSQL para um servidor sqld hospedado por você ou um arquivo neste Mac. No modo Remote, ele acessa qualquer sqld que forneça o endpoint de pipeline Hrana v2, inclusive um executado neste Mac, que escuta na porta 8080 por padrão. Deixe o token vazio para um servidor iniciado sem --auth-jwt-key-file, ou forneça um JWT correspondente à chave do servidor.

O modo Local File abre um arquivo libSQL com o mecanismo SQLite incluído no driver, e um caminho que ainda não existe é criado, incluindo as pastas. Um arquivo local executa transações, carrega extensões SQLite da lista Extensions da conexão e executa a reconstrução para reordenar colunas ou alterar chaves estrangeiras depois da sua confirmação.

Instruções que só libSQL entende, como ALTER TABLE … ALTER COLUMN, falham em um arquivo local, pois o mecanismo SQLite as recebe. Arquivos libSQL criptografados não abrem. Nunca abra um arquivo que um app em execução esteja sincronizando como réplica incorporada do Turso: o acesso simultâneo por dois programas pode corrompê-lo.

Backup Dump e Restore Dump executam sqlite3 em um arquivo libSQL local.

Guia de configuração de libSQL (inglês)↗