// herramienta gratuita

Constructor de cadenas de conexión SQLite

Crea cadenas de conexión SQLite para Microsoft.Data.Sqlite, JDBC, SQLAlchemy, Python y Node a partir de una ruta de archivo, o pega un nombre de archivo URI o una cadena Data Source para ver qué hace cada opción. Todo se ejecuta en tu navegador: nada de lo que escribas se envía a ningún lugar.

Abrir esta conexión en SQLly

Abre el editor de conexiones de SQLly con los datos ya rellenados.

Privado por diseño. El constructor y el decodificador son JavaScript puro que se ejecuta en esta pestaña. La página no envía ninguna solicitud con lo que escribes, no almacena nada (ni siquiera en tu navegador) y sigue funcionando sin conexión una vez cargada. El enlace Abrir en SQLly va directamente desde tu navegador a la aplicación en tu computadora.

Formatos de cadena de conexión SQLite

Una «cadena de conexión» de SQLite es principalmente una ruta de archivo, pero cada envoltorio la presenta de manera diferente: Data Source=app.db en .NET, jdbc:sqlite:/path en Java, sqlite:////abs/path.db (cuatro barras) en SQLAlchemy. Los nombres de archivo URI del propio SQLite (file:app.db?mode=ro) añaden opciones como el modo de solo lectura, pero solo cuando quien invoca habilita el manejo de URI.

Ruta de archivo CLI sqlite3, la mayoría de los controladores, SQLly

/var/data/app.db

Nombre de archivo URI (solo lectura) Nombres de archivo URI de SQLite

file:///var/data/app.db?mode=ro

ADO.NET Microsoft.Data.Sqlite, EF Core

Data Source=/var/data/app.db;Mode=ReadOnly

JDBC xerial sqlite-jdbc

jdbc:sqlite:/var/data/app.db

URL de SQLAlchemy Python SQLAlchemy

sqlite:////var/data/app.db

Los marcadores de posición como your_password son eso mismo: construye tu propia cadena con el formulario de arriba. Más sobre cómo conectar SQLly a SQLite: SQLly para SQLite.

Parámetros de nombres de archivo URI de SQLite

El esquema es file:; la autoridad debe estar vacía o localhost, así que file:/abs/path, file:///abs/path y file://localhost/abs/path son todos el mismo archivo. Codifica ? como %3F y # como %23 en la ruta. El manejo de URI viene desactivado por defecto: actívalo con SQLITE_OPEN_URI, uri=True en Python, o el equivalente de tu envoltorio.

Palabra claveSinónimosPredeterminadoLo que hace
mode - rwc ro solo lectura, rw lectura-escritura (debe existir), rwc lectura-escritura-crear, memory en memoria.
cache - privado shared permite que las conexiones de un proceso compartan una caché.
immutable - 0 1 promete que el archivo nunca cambia: sin bloqueo alguno. Lecturas corruptas si alguien llega a escribir.
nolock - 0 1 desactiva el bloqueo de archivos.
vfs - VFS por defecto Nombre del módulo VFS a usar.
psow - compilación por defecto Sobrescritura segura.

Palabras clave de Microsoft.Data.Sqlite

Estilo ADO.NET. Data Source también puede ser un nombre de archivo URI.

Palabra claveSinónimosPredeterminadoLo que hace
Data Source DataSource, nombre de archivo vacío (base de datos temporal en disco) Ruta del archivo, :memory:, o un nombre de archivo URI.
Mode - ReadWriteCreate ReadWriteCreate, ReadWrite, ReadOnly, Memory.
Cache - Predeterminado Default, Private, Shared.
Password - - Envía PRAGMA key; necesita una compilación compatible con cifrado como SQLCipher.
Foreign Keys - vacío (sin pragma) True activa PRAGMA foreign_keys.
Recursive Triggers - Falso PRAGMA recursive_triggers.
Default Timeout Tiempo de espera del comando 30 6.0+. Segundos; también cuánto tiempo esperar cuando la base de datos está bloqueada.
Pooling - Verdadero 6.0+. Pool de conexiones.

Errores comunes de conexión a SQLite

unable to open database file

Por qué: SQLITE_CANTOPEN: el directorio no existe, el proceso no puede escribir en el directorio (SQLite necesita crear archivos de diario junto a la base de datos), una ruta relativa resuelta contra un directorio de trabajo inesperado, o ~ fue utilizada (SQLite no la expande).

Solución: Usa una ruta absoluta, crea el directorio y otorga al proceso acceso de escritura al directorio, no solo al archivo.

database is locked

Por qué: SQLITE_BUSY: otra conexión mantiene un bloqueo de escritura y esta no esperó lo suficiente.

Solución: Establece un busy timeout (Default Timeout en Microsoft.Data.Sqlite, timeout en Python, busy_timeout pragma), mantén cortas las transacciones de escritura y considera PRAGMA journal_mode=WAL para lectores concurrentes.

attempt to write a readonly database

Por qué: El archivo o su directorio es de solo lectura para este proceso, o se abrió con mode=ro / Mode=ReadOnly.

Solución: Corrige los permisos del archivo y de su directorio, o ábrelo en modo de lectura y escritura.

file is not a database

Por qué: SQLITE_NOTADB: el archivo no es SQLite (por ejemplo, un archivo DuckDB), está cifrado con una clave que no proporcionaste, o está dañado.

Solución: Verifica qué tipo de archivo es (file app.db en macOS/Linux) y ábrelo con el motor adecuado o la clave correcta.

Preguntas frecuentes sobre la cadena de conexión de SQLite

¿Qué es la cadena de conexión de SQLite?

Generalmente solo la ruta del archivo. En .NET es Data Source=/path/app.db, en Java jdbc:sqlite:/path/app.db, en SQLAlchemy sqlite:////path/app.db para una ruta absoluta (sqlite:///app.db para uno relativo).

¿Cómo abro una base de datos SQLite en modo solo lectura?

Usa un nombre de archivo URI con mode=ro (file:/path/app.db?mode=ro, con el manejo de URI habilitado), Mode=ReadOnly en Microsoft.Data.Sqlite, open_mode=1 en sqlite-jdbc, o readonly: true en better-sqlite3.

¿Cómo creo una base de datos SQLite en memoria?

Usar :memory: como la ruta. Cada conexión obtiene su propia base de datos privada a menos que uses un URI de caché compartido como file::memory:?cache=shared.

¿Por qué cuatro barras en una URL de SQLite de SQLAlchemy?

sqlite:// es el esquema y el host vacío; la tercera barra cierra la parte del host, y el resto es la ruta. Una ruta absoluta empieza con su propia barra, así que /var/data/app.db se convierte en sqlite:////var/data/app.db.

// olvídate de las cadenas por completo

Conéctate una vez. Luego solo escribe SQL.

SQLly es un entorno de trabajo SQL nativo para macOS, Windows y Linux. Pega una cadena de conexión en su editor de conexiones, guarda las contraseñas en el llavero del sistema y obtén IntelliSense que entiende el esquema en SQLite, entre otros.