Ajustes y datos de la app
DuckLocal guarda un archivo de base de datos en disco, más un archivo pequeño mientras la ventana está en marcha, y un archivo de registro. Si activas el mapa base en línea, también guarda en caché teselas de mapa; una actualización descargada espera en la caché también. Todo lo demás se queda en memoria mientras dura la sesión. Los comentarios de revisión de los paneles son una excepción: se guardan junto al archivo del panel, no en el directorio de datos de la app (consulta Revisar con comentarios).
Dónde se guardan las cosas
| Plataforma | Ruta |
|---|---|
| macOS | ~/Library/Application Support/DuckLocal/history.duckdb |
| Windows | %APPDATA%\DuckLocal\data\history.duckdb |
| Linux | ~/.local/share/ducklocal/history.duckdb |
El archivo de DuckDB contiene cuatro tablas: historial de consultas, archivos de datos registrados, bases de datos adjuntas junto a la base de datos principal, y una pequeña tabla de ajustes clave/valor. Los ajustes incluyen el idioma y el tamaño de la interfaz, las pestañas de consulta y de paneles abiertas, la lista de paneles recientes, y si el mapa base y la comprobación de actualizaciones están activados. Mientras la app se ejecuta, un archivo .wal compañero (el registro de escritura anticipada de DuckDB) está junto a él.
Tus conjuntos de datos nunca se copian a la base de datos de la aplicación. Los archivos registrados se guardan como rutas de archivo y se vuelven a adjuntar automáticamente cada vez que DuckLocal arranca.
Junto a él, mientras hay una ventana abierta, gui-endpoint.json contiene el puerto de bucle local y el token aleatorio que ducklocal open usa para llegar a la ventana. Solo tu cuenta puede leerlo, y un gui-endpoint.json obsoleto que dejó una ventana ya cerrada es inofensivo.
La carpeta logs junto a él contiene el registro de la ventana, ducklocal.log (y el del arranque anterior, ducklocal.previous.log). Si DuckLocal se cae, escribe allí primero un informe crash-….log, y el siguiente arranque cuenta qué pasó, con Mostrar informe. Se conservan los diez últimos informes. Adjunta el informe cuando abras un issue. Abrir carpeta de registros abre la carpeta: está en el menú DuckLocal en macOS, y en el menú contextual de la versión, en el extremo derecho de la barra de estado, en todas partes. El comando ducklocal no escribe ningún archivo de registro; sus errores van a quien lo llama.
Las teselas de mapa del mapa base en línea van a la carpeta de caché de la plataforma — ~/Library/Caches/DuckLocal/tiles en macOS, %LOCALAPPDATA%\DuckLocal\cache\tiles en Windows, ~/.cache/ducklocal/tiles en Linux — una carpeta por servidor de teselas. Borrarla es inofensivo: las teselas simplemente se descargan otra vez. Una actualización descargada espera en updates, en la misma carpeta de caché, hasta que se instala.
Qué sobrevive a un reinicio
| Se recuerda | Dónde |
|---|---|
| Archivos de datos registrados — ruta, nombre de vista, tipo | archivo de datos de la app |
| Historial de consultas, incluidos los fallos | archivo de datos de la app |
| Idioma de la interfaz | archivo de datos de la app |
| Tamaño de la interfaz | archivo de datos de la app |
| Si se ha visto la guía de primer arranque | archivo de datos de la app |
| Si la barra lateral está oculta | archivo de datos de la app |
| Bases de datos adjuntas junto a la principal, y si cada una es de solo lectura | archivo de datos de la app |
| El archivo de base de datos abierto la última vez | archivo de datos de la app — se reabre al arrancar mientras siga existiendo |
| Pestañas de consulta abiertas, con sus títulos y su SQL | archivo de datos de la app |
| Pestañas de paneles abiertas, con sus títulos | archivo de datos de la app |
| Si el mapa base en línea está activado | archivo de datos de la app |
| Si DuckLocal busca actualizaciones al arrancar | archivo de datos de la app |
| Paneles abiertos recientemente (los Paneles de la barra lateral) | archivo de datos de la app |
| No se recuerda | Notas |
|---|---|
| El contenido del panel de resultados | solo en memoria — vuelve a ejecutar la consulta |
| Tablas y vistas creadas en la base de datos en memoria | se te pide guardarlas al salir o al abrir otra base de datos; Guardar como base de datos… las escribe en un archivo .duckdb |
| Un archivo de base de datos que se ha movido o se ha borrado desde entonces | el siguiente arranque empieza en memoria |
| Tamaño y posición de la ventana | fijos en 1440×900, mínimo 960×600 |
| Tamaños de la barra lateral y del panel de resultados | fijos por arranque |
| El filtro de resultados | solo en memoria |
| Lo que han elegido los filtros de un panel | solo en memoria; se mantiene al recargar la pestaña |
| El tema | siempre empieza en claro — ver abajo |
| Credenciales de S3 | solo de sesión por diseño |
El tema es el caso raro: el conmutador de idioma persiste, el del tema no, y cada arranque empieza en modo claro.
Un arranque normal trabaja en memoria, así que las tablas y vistas que crees ahí terminarían con la ventana. DuckLocal pregunta antes de que eso pase: al salir, al cerrar la ventana o al abrir otra base de datos con esas tablas en su sitio, ofrece Guardar como base de datos…, Salir sin guardar o Cancelar. Guardar como base de datos… (también ⌘⇧S, o Archivo → Guardar como base de datos…) copia esquemas, tablas y filas, vistas, macros y secuencias a un archivo .duckdb y mueve la ventana a él, así los cambios posteriores se escriben en el archivo; el siguiente arranque abre ese archivo otra vez. Las vistas que DuckLocal crea a partir de archivos registrados no cuentan — se crean de nuevo a partir de los archivos en cada arranque.
Red
DuckLocal no hace ninguna petición de red por su cuenta hasta que actives alguna. Hay dos interruptores, ambos desactivados al principio, más las cosas que pides directamente:
| Petición | Cuándo | Qué sale de la máquina |
|---|---|---|
| Mapa base en línea | Una vez activado, siempre que se dibuja un mapa | Qué teselas se quieren: aproximadamente la zona y el zoom que se está viendo |
| Comprobación de actualizaciones | Al hacer clic en la versión, o al arrancar una vez activada | Una petición a dl.ducklocal.app para la versión de la última release; cuando hay una más nueva, la descarga de su paquete |
| S3 | Cuando configuras S3 y lo consultas | Tus peticiones al almacén que configuraste |
| Extensiones | Al hacer clic en Instalar o Actualizar, o al ejecutar INSTALL | Una descarga del repositorio de extensiones de DuckDB |
| Datos remotos en SQL | Cuando el SQL nombra https://, s3:// o una base de datos remota, incluido el SQL de un panel al abrirse. Requiere la extensión ya instalada | Lo que pide el SQL, incluido cualquier cosa escrita en la dirección |
No hay telemetría y, aparte del SQL que ejecutas, nada de esto envía una fila de tus datos. El SQL hace lo que dice: una dirección puede llevar valores de tus tablas. Así que, una vez instalado httpfs, un archivo .dash de alguien en quien no confías puede enviar datos al abrirlo. Red y privacidad lista todas las rutas y cómo comprobarlas tú mismo.
Mapa base en línea
Los gráficos de mapa — en un panel o en la pestaña Gráfico de los resultados — pueden dibujar teselas de OpenStreetMap bajo sus puntos. Ver → Mapa base en línea (OpenStreetMap) lo activa y lo desactiva, y la elección se recuerda (el ajuste map_tiles, on u off). Empieza desactivado. Solo salen de la máquina las teselas pedidas — aproximadamente la zona y el zoom que estás viendo — nunca una fila de datos.
La descarga sigue la política de teselas de la OpenStreetMap Foundation: un User-Agent identificativo, como mucho dos peticiones a la vez, teselas reutilizadas de la caché durante una semana, sin prefetch masivo, y la atribución en el mapa. Para un uso más intenso, pon en el ajuste map_tile_url la plantilla {z}/{x}/{y} de otro servidor.
Comprobación de actualizaciones
La barra de estado termina con la versión de DuckLocal — DuckLocal 0.3.0. Haz clic en ella para buscar en dl.ducklocal.app la última release:
- Actualizado — la versión que ejecutas es la última.
- Descargando v0.3.1… — hay una release más nueva y DuckLocal la está descargando. El paquete se comprueba contra el tamaño publicado y el SHA-256 de la release — en macOS, también contra la firma de la app que estás ejecutando — antes de descomprimirlo.
- Reinicia para actualizar a v0.3.1 — la nueva versión está lista. Haz clic para salir, instalar y volver a abrir; si no, se instala la próxima vez que salgas de DuckLocal.
- Actualización disponible: v0.3.1 — una release más nueva que esta copia no puede instalar por sí misma: una compilación que hiciste tú, o una app en una carpeta donde no puede escribir. Haz clic para descargar el paquete e instálalo como instalaste esta.
- Error al comprobar actualizaciones — pasa el cursor por encima para ver el motivo (sin conexión, un proxy, una descarga que no coincidía con su suma de comprobación); haz clic para volver a intentarlo.
Las actualizaciones vienen de dl.ducklocal.app, los mismos paquetes que la release de GitHub, servidos desde un espejo que también es rápido en China continental.
En macOS el menú DuckLocal tiene la misma comprobación, como Buscar actualizaciones…, y Buscar actualizaciones al arrancar, que comprueba una vez cada vez que la app se inicia. Está desactivada hasta que la actives (el ajuste update_check, on u off). Hasta entonces, DuckLocal solo comprueba cuando haces clic.
Idioma
El botón EN / 中 de la barra de título cambia el idioma de la interfaz al momento y registra la elección.
En el primer arranque — antes de que haya ningún ajuste guardado — el idioma se toma de la configuración regional del sistema: LC_ALL o LANG que contenga zh selecciona chino, cualquier otra cosa selecciona inglés. Un valor guardado que no se reconozca vuelve al chino.
Algunas cadenas no se traducen a propósito: DuckLocal, las etiquetas de los botones S3 y EXPLAIN, el conmutador EN / 中 y los marcadores de posición de las credenciales. Los mensajes de error del motor y de la red se muestran tal cual y siempre están en inglés, sea cual sea el idioma de la interfaz.
Temas
El botón de sol/luna alterna entre el tema claro y el oscuro. No hay selector de temas ni archivo de tema que editar — los dos modos son lo que hay.
Tamaño de la interfaz
El texto, los iconos y los controles se escalan juntos, en cuatro pasos:
| Tamaño | Texto base | Texto del editor |
|---|---|---|
| Pequeño | 13px | 12px |
| Predeterminado | 14px | 13px |
| Grande | 16px | 15px |
| Muy grande | 18px | 17px |
Elige uno con el botón Aa de la barra de título, o ve pasando por ellos con ⌘+ (más grande), ⌘− (más pequeño) y ⌘0 (volver al predeterminado) — funcionan estén donde esté el foco, el editor SQL incluido. La elección se recuerda y sobrevive al cambio entre claro y oscuro.
Los tamaños de panel que hayas arrastrado, y la altura de los gráficos de un panel, se quedan en píxeles: son tuyos para ajustarlos, no de la interfaz.
Restablecer
Para empezar de cero — borrando el historial, los archivos registrados, las bases de datos adjuntas, las pestañas recordadas y todos los ajustes — sal de DuckLocal y elimina su directorio de datos de la app:
rm -rf ~/Library/Application\ Support/DuckLocal # macOS
rm -rf ~/.local/share/ducklocal # LinuxEn Windows, borra %APPDATA%\DuckLocal.
El siguiente arranque lo crea de cero. Tus archivos de datos nunca se ven afectados por esto, solo los registros propios de DuckLocal.
Solución de problemas
Los síntomas, causas y arreglos están reunidos en la página de Solución de problemas.
