Saltar al contenido

¿Usas TablePro a diario? Una licencia añade funciones de pago y financia la próxima versión. Comprar licenciaLicencia para apoyar TablePro

Cliente Turso y libSQL para Mac

Conecta a Turso con URL y token, consulta con sintaxis SQLite y modifica tablas, índices y triggers. El mismo controlador abre servidores sqld propios y archivos libSQL en tu Mac.

Funciona en MacEl controlador se descarga la primera vez que eliges Turso

De un vistazo

Lenguaje de consulta
SQL
Controlador
Se descarga en el primer usoCompartido con libSQL
Conectar mediante
La API del servicio
iPhone y iPad
No se abre

Conecta a Turso

Elige Turso en los tipos de conexión y deja Modo de conexión en Remoto (Turso). Pega la URL HTTPS de la base terminada en .turso.io y un token en Token API, guardado en el Llavero de macOS. El panel Turso muestra ambos, igual que turso db show my-db --url y turso db tokens create my-db.

Una URL libsql:// se reescribe como HTTPS e importarla crea una conexión remota. No hay campos de host, puerto o base porque la URL identifica una base. La conexión está cifrada si usa HTTPS en lugar de HTTP sin cifrar; no hay túnel SSH.

Consulta y edita

libSQL usa sintaxis SQLite, así que explorar, diagramas EXPLAIN QUERY PLAN, ediciones pendientes con Vista previa SQL y exportación funcionan como en SQLite.

Una conexión remota no ejecuta transacciones. Cada sentencia es una solicitud HTTP con su propio commit; BEGIN falla con “Las transacciones no son compatibles con este modo”. Para transacciones usa un archivo libSQL local, descrito en la sección libSQL.

El modo remoto no carga extensiones SQLite: Turso ejecuta las incorporadas a su servidor. Si Turso limita la conexión, el error indica cuántos segundos esperar antes de reintentar.

Tablas, índices y triggers

La pestaña Estructura crea tablas, añade y elimina columnas e índices y crea, edita y elimina triggers. Se pueden renombrar tablas, pero no vistas, desde la barra lateral.

Para reordenar columnas o cambiar una clave foránea en una base remota, TablePro escribe el script de reconstrucción para que lo revises y ejecutes. No puede ejecutarlo: necesitaría una transacción entre solicitudes HTTP separadas.

Transfiere datos

TablePro no importa a Turso ni libSQL; carga datos con Turso CLI o una importación del servidor sqld. Para sacarlos, exporta tablas o resultados como CSV, JSON, SQL, XLSX, Markdown, HTML y XML.

iPhone y iPad

La app para iPhone y iPad no tiene un controlador de Turso. Las conexiones de Turso sincronizadas desde un Mac aparecen en la lista, pero no se abren.

Limitaciones

  • Cada conexión es una base de datos. No se admiten cambios de base ni ramas.
  • Las réplicas integradas no son compatibles: un archivo local se abre por sí solo y no se sincroniza.

libSQL

Se descarga en el primer usoiPhone y iPad: No se abre

Elige libSQL para un servidor sqld propio o un archivo local. En Remoto accede a cualquier sqld con endpoint Hrana v2 pipeline, incluido uno local, que usa 8080 por defecto. Deja el token vacío si se inició sin --auth-jwt-key-file, o proporciona un JWT acorde a la clave del servidor.

Archivo local abre libSQL con el motor SQLite del controlador; una ruta inexistente se crea, incluidas carpetas. Un archivo local ejecuta transacciones, carga extensiones de la lista Extensiones y reconstruye por reordenación de columnas o claves foráneas tras confirmar.

Las sentencias exclusivas de libSQL, como ALTER TABLE … ALTER COLUMN, fallan en un archivo local porque las recibe SQLite. Los archivos libSQL cifrados no se abren. Nunca abras un archivo que otra app esté sincronizando como réplica embebida Turso: el acceso simultáneo puede corromperlo.

Volcado de copia de seguridad y Restaurar volcado ejecutan sqlite3 en un archivo libSQL local.

Limitaciones de libSQL

  • Crear volcado solo funciona para archivos libSQL locales, no para bases remotas.

Guía de configuración de libSQL (inglés)

Preguntas sobre Turso

¿Elijo Remoto o Archivo local?

Remoto para Turso o sqld por URL. Archivo local para libSQL en el Mac, que también ofrece transacciones, extensiones SQLite y copias de seguridad.

¿Necesito instalar Turso CLI?

No. El panel Turso muestra la URL y también crea tokens. La CLI sirve para cargar datos desde terminal, ya que TablePro no importa a Turso.

Consigue TablePro

La app para Mac se descarga y usa gratis. Un plan Starter o Equipo añade funciones opcionales.
Descargar para Mac

Requiere macOS 13 Ventura o posterior