Ir al contenido

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 ​

PlataformaRuta
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 recuerdaDónde
Archivos de datos registrados — ruta, nombre de vista, tipoarchivo de datos de la app
Historial de consultas, incluidos los fallosarchivo de datos de la app
Idioma de la interfazarchivo de datos de la app
Tamaño de la interfazarchivo de datos de la app
Si se ha visto la guía de primer arranquearchivo de datos de la app
Si la barra lateral está ocultaarchivo de datos de la app
Bases de datos adjuntas junto a la principal, y si cada una es de solo lecturaarchivo de datos de la app
El archivo de base de datos abierto la última vezarchivo de datos de la app — se reabre al arrancar mientras siga existiendo
Pestañas de consulta abiertas, con sus títulos y su SQLarchivo de datos de la app
Pestañas de paneles abiertas, con sus títulosarchivo de datos de la app
Si el mapa base en línea está activadoarchivo de datos de la app
Si DuckLocal busca actualizaciones al arrancararchivo de datos de la app
Paneles abiertos recientemente (los Paneles de la barra lateral)archivo de datos de la app
No se recuerdaNotas
El contenido del panel de resultadossolo en memoria — vuelve a ejecutar la consulta
Tablas y vistas creadas en la base de datos en memoriase 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 entoncesel siguiente arranque empieza en memoria
Tamaño y posición de la ventanafijos en 1440×900, mínimo 960×600
Tamaños de la barra lateral y del panel de resultadosfijos por arranque
El filtro de resultadossolo en memoria
Lo que han elegido los filtros de un panelsolo en memoria; se mantiene al recargar la pestaña
El temasiempre empieza en claro — ver abajo
Credenciales de S3solo 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ónCuándoQué sale de la máquina
Mapa base en líneaUna vez activado, siempre que se dibuja un mapaQué teselas se quieren: aproximadamente la zona y el zoom que se está viendo
Comprobación de actualizacionesAl hacer clic en la versión, o al arrancar una vez activadaUna 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
S3Cuando configuras S3 y lo consultasTus peticiones al almacén que configuraste
ExtensionesAl hacer clic en Instalar o Actualizar, o al ejecutar INSTALLUna descarga del repositorio de extensiones de DuckDB
Datos remotos en SQLCuando el SQL nombra https://, s3:// o una base de datos remota, incluido el SQL de un panel al abrirse. Requiere la extensión ya instaladaLo 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ñoTexto baseTexto del editor
Pequeño13px12px
Predeterminado14px13px
Grande16px15px
Muy grande18px17px

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:

bash
rm -rf ~/Library/Application\ Support/DuckLocal   # macOS
rm -rf ~/.local/share/ducklocal                  # Linux

En 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.

Publicado bajo la licencia Apache-2.0.