// herramienta gratuita

Generador de cadena de conexión de DuckDB

DuckDB se ejecuta dentro de tu proceso y abre un archivo, por lo que su «cadena de conexión» es una ruta. Construye la URL JDBC, la llamada en Python, la URL de SQLAlchemy y el comando CLI para un archivo de base de datos, ya sea de solo lectura o en memoria. 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 de DuckDB

Cada cliente de DuckDB abre una ruta de archivo de base de datos, o :memory: para una base de datos temporal en memoria. Solo un proceso puede abrir un archivo en modo lectura-escritura a la vez; varios procesos pueden compartirlo en modo solo lectura.

Ruta de archivo cada cliente, SQLly

/var/data/analytics.duckdb

JDBC Controlador JDBC de DuckDB

jdbc:duckdb:/var/data/analytics.duckdb

URL de SQLAlchemy duckdb-engine

duckdb:////var/data/analytics.duckdb

CLI, solo lectura duckdb

duckdb -readonly /var/data/analytics.duckdb

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 DuckDB: SQLly para DuckDB.

Abrir una base de datos DuckDB

El modo de solo lectura permite que varios procesos lean un archivo.

Palabra claveSinónimosPredeterminadoLo que hace
JDBC - jdbc:duckdb: (en memoria) jdbc:duckdb:/path/file.duckdb; solo lectura con la duckdb.read_only=true propiedad de conexión. A continuación pueden añadirse ajustes separados por punto y coma: jdbc:duckdb:/path;threads=4.
Python - :memory: duckdb.connect("file.duckdb", read_only=True).
SQLAlchemy - - duckdb:///relative.duckdb, duckdb:////abs/path.duckdb, duckdb:///:memory:; solo lectura a través de connect_args={"read_only": True}.
CLI - en memoria duckdb file.duckdb; añade -readonly para solo lectura.
Node.js - - @duckdb/node-api: await DuckDBInstance.create("file.duckdb").

Errores comunes de conexión a DuckDB

IO Error: Could not set lock on file "analytics.duckdb": Conflicting lock is held

Por qué: Otro proceso ya tiene el archivo abierto en modo lectura-escritura (a menudo un cuaderno, una sesión de CLI o una segunda instancia de la aplicación).

Solución: Cierra el otro proceso, o abre ambos en modo solo lectura si ninguno necesita escribir.

IO Error: Cannot open database "analytics.duckdb" in read-only mode: database does not exist

Por qué: El modo solo lectura nunca crea el archivo, y la ruta es incorrecta o relativa a un directorio de trabajo inesperado.

Solución: Usa una ruta absoluta a una base de datos existente.

Preguntas frecuentes sobre la cadena de conexión de DuckDB

¿DuckDB tiene una cadena de conexión?

No en el sentido cliente/servidor: DuckDB está embebido, por lo que abres una ruta de archivo (o :memory:). Los wrappers difieren: jdbc:duckdb:/path en Java, duckdb:///path en SQLAlchemy, una ruta simple en Python, Node y la CLI.

¿Cómo abro un archivo DuckDB en modo solo lectura?

read_only=True en Python, la duckdb.read_only=true propiedad en JDBC, connect_args={"read_only": True} en SQLAlchemy, o duckdb -readonly file.duckdb en la CLI.

¿Pueden dos programas usar el mismo archivo DuckDB?

Solo un proceso puede tenerlo en lectura-escritura. Varios procesos pueden abrirlo en solo lectura al mismo tiempo.

// 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 DuckDB, entre otros.