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.
Abrir esta conexión en SQLly
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 clave | Sinónimos | Predeterminado | Lo 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.
Otros motores
- Cadenas de conexión de SQL Server
- Cadenas de conexión de PostgreSQL
- Cadenas de conexión de MySQL
- Cadenas de conexión de MariaDB
- Cadenas de conexión de SQLite
- Cadenas de conexión de Oracle
- Cadenas de conexión de Redis
- Cadenas de conexión de ClickHouse
- Cadenas de conexión de libSQL
- Todos los motores y formatos
- Formateador SQL
- Todas las herramientas gratuitas
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.