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.
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
Requiere macOS 13 Ventura o posterior