# Ajustes y datos de la app

> Dónde guarda DuckLocal sus datos, qué recuerda, las únicas peticiones de red que puede hacer, el tamaño de la interfaz, el tema y el idioma, y cómo restablecerla.

Source: https://ducklocal.app/docs/es/settings-and-data

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](dashboards.md#review-with-comments)).

## Dónde se guardan las cosas {#where-things-are-stored}

| 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`](cli.md#show-work-in-the-running-window) 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](https://github.com/JetSquirrel/DuckLocal/issues).
**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](#online-base-map) 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](#update-check) 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 {#network}

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](#online-base-map) | 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](#update-check) | 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](s3.md) | 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](https://github.com/JetSquirrel/DuckLocal/blob/main/docs/network-and-privacy.md)
lista todas las rutas y cómo comprobarlas tú mismo.

## Mapa base en línea {#online-base-map}

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 {#update-check}

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](https://github.com/JetSquirrel/DuckLocal/releases/latest),
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 {#interface-size}

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:

```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](troubleshooting.md).
