Cliente de BD

El Cliente de BD de Blyck maneja los cinco motores SQLite · Oracle · PostgreSQL · MSSQL · MySQL con la misma interfaz. Sin herramientas de BD aparte, en una sola ventana realizas la conexión · exploración de esquema · escritura de SQL · análisis de resultados · modificación de datos · exportación · generación de SQL a partir de lenguaje natural.

Motores compatibles y conexión

En el menú de pestaña nueva (+) selecciona un motor o haz clic en una conexión guardada.

Motor	Entrada obligatoria	Puerto predeterminado	Notas
SQLite	Ruta del archivo	—	Cambio automático a solo lectura si supera 256 MB·está bloqueado
Oracle	Host · Port · Service Name · usuario · contraseña	1521	Thin por defecto → fallback automático a Thick si falla
PostgreSQL	Host · Port · Database · usuario · contraseña	5432	Opciones de esquema·SSL
MSSQL	Host (servidor\instancia) · Port · Database · usuario · contraseña	1433	Solo autenticación SQL (no admite autenticación integrada de Windows)
MySQL	Host · Port · Database · usuario · contraseña	3306	Opción SSL

Modo Oracle Thin / Thick

Si activas la opción Forzar Thick en el diálogo de conexión, siempre se conecta en modo Thick. Por defecto intenta primero Thin y, si falla, hace fallback a Thick; tras conectar, en la cabecera se muestra Oracle conectado (Thin) o Oracle conectado (Thick). Al usar el modo Thick debes introducir en el diálogo la ruta del Oracle Instant Client de 64 bits.

Error Oracle NJS-116

El error NJS-116 se produce cuando el servidor exige un verificador de contraseña que el controlador Thin no admite. Activa Forzar Thick e introduce la ruta del Instant Client de 64 bits. El error NJS-118 se resuelve reconectando en modo Thick tras reiniciar la app. El Instant Client de 32 bits no funciona.

Conexiones guardadas y autocompletado de contraseña

Si introduces un nombre para guardar en el diálogo de conexión, los datos de conexión se almacenan de forma permanente. La contraseña se protege con cifrado del SO (Windows DPAPI / macOS Keychain) y, a partir de entonces, te conectas al instante con un solo clic sin introducir la contraseña.

Nota

La contraseña guardada solo se descifra en la cuenta del SO actual. Aunque copies connections.json a otro PC o cuenta, la contraseña no se descifra y el diálogo vuelve a abrirse.

---

Árbol de esquema

Al conectar, en el árbol de la izquierda se muestran las secciones TABLES / VIEWS / INDEXES / TRIGGERS / ROUTINES.

• Al desplegar tablas · vistas se muestra la lista de columnas (nombre · tipo · icono de PK), y con doble clic se ejecuta de inmediato en el editor SQL la consulta de las primeras 200 filas.
• Con doble clic en índices · triggers · rutinas se carga el DDL en el editor.
• Puedes arrastrar al editor SQL nombres de tablas·columnas del árbol para insertarlos.

Búsqueda en el árbol

En la barra de búsqueda superior seleccionas el ámbito nombre / columna / ambos para buscar. Al buscar por columna, la tabla correspondiente se despliega automáticamente y en la cabecera se muestra el recuento N / total.

Menú contextual (tablas)

Elemento	Acción
Consulta detallada	Tipo de columna · si admite NULL · valor predeterminado · información de índices
Consultar primeras 200 filas	Ejecuta automáticamente la consulta acorde al dialecto del motor (LIMIT / TOP / ROWNUM)
Ver DDL	Carga la sentencia CREATE en el editor
Analizar columna	Proporción de NULL · número de valores únicos · valor más frecuente · estadísticas numéricas (min/max/media, basadas en muestra)

Al ejecutar una consulta DDL, tras 500 ms el árbol se reindexa automáticamente en segundo plano para reflejar los cambios. Para actualizar manualmente, haz clic en el botón ↻ de la cabecera.

---

Editor SQL

Abre el editor con doble clic en una tabla o con el botón Nueva consulta de la cabecera del árbol.

Riel izquierdo

Botón	Acción
✨	Alternar la barra de entrada lenguaje natural→SQL
▶	Ejecutar la consulta (Ctrl+Enter)
■	Detener la ejecución (activo solo durante la ejecución)
+	Añadir pestaña SQL

En la parte inferior del riel se muestra la lista de pestañas SQL del panel actual, lo que permite alternar rápidamente entre pestañas.

Barra de herramientas

• nombreBD — SQL ▾: desplegable para cambiar de conexión
• Casilla de autocommit / commit / rollback
• IA (Ctrl+I): IA de celda (analiza el rango seleccionado de la cuadrícula)
• Historial / Snippets / Exportar ▾ / Formato / Cerrar (Esc)

Ejecución y autocompletado

• Ejecuta con Ctrl+Enter o el botón ▶.
• Si ejecutas con texto seleccionado, solo se ejecuta el rango seleccionado.
• Los nombres de tablas·columnas de la BD conectada se autocompletan.
• El botón Formato ejecuta el formateador integrado tomando como base los saltos de línea antes de las cláusulas SQL.
• Tras ejecutar DML, en la línea de estado se muestra Completado — N filas modificadas · X ms o un error en rojo.

Transacciones

Si desactivas la casilla de autocommit, pasas al modo de transacción manual. Aunque ejecutes DML, no se confirma de inmediato y queda en estado ● sin confirmar. Confirma con el botón commit o revierte con el botón rollback.

Nota

El DDL (CREATE / ALTER / DROP) hace autocommit en la mayoría de los motores, por lo que no queda protegido por la transacción. En Oracle el DDL siempre hace autocommit. Al cerrar la conexión, las transacciones sin confirmar se revierten automáticamente.

---

Cancelación de consultas del lado del servidor (■ Detener)

Al hacer clic en el botón ■, la cancelación procede en dos fases.

1. Cancelación blanda (inmediata) — La UI vuelve de inmediato e invalida el token para descartar el resultado. En la línea de estado se muestra Ejecución interrumpida.
2. Cancelación del lado del servidor (best-effort) — Envía la señal de cancelación al motor. Si el servidor de BD la reconoce en su checkpoint, la consulta se interrumpe.

Motor	Método de cancelación
Oracle	connection.break() → devuelve ORA-01013
MSSQL	request.cancel() → paquete TDS Attention
PostgreSQL	pg_cancel_backend(pid) por una conexión aparte — mantiene la conexión existente
MySQL	KILL QUERY threadId por una conexión aparte — mantiene la conexión existente
SQLite	Sin cancelación de servidor — solo cancelación blanda (interrupción inmediata)

Consejo

Cuando pulsas ■ y no se detiene de inmediato, espera un momento hasta que el servidor procese la señal de cancelación en un checkpoint. Una consulta de agregación pesada puede seguir ejecutándose hasta el siguiente checkpoint. SQLite no tiene fase de servidor, así que se interrumpe al instante.

---

Cambio de conexión

Al hacer clic en el título del editor SQL nombreBD — SQL ▾ se muestra la lista de todas las conexiones de BD abiertas actualmente, con un ✓ en la conexión actual. Al seleccionar una conexión, se mantiene el SQL del editor tal cual y solo cambia la BD destino de ejecución.

Consejo

Es útil cuando quieres ejecutar tal cual en BD de staging · producción una consulta escrita en la BD de desarrollo. Si en la lista de conexiones hay una con la etiqueta prod, la verificación de riesgo se refuerza un escalón.

---

Cuadrícula de resultados

Los resultados se muestran en una cuadrícula con scroll virtual, lo que permite explorar con fluidez incluso cientos de miles de filas.

• La columna de número de fila (#) queda fija aunque hagas scroll horizontal. Al hacer clic se abre el visor de detalle de fila.
• En la barra de estado se muestra la información de ejecución N filas · X ms.
• NULL se marca de forma diferenciada como NULL (se distingue de la cadena vacía).
• El ancho de columna se ajusta arrastrando.

Ordenar · filtrar

• Ordenar: al hacer clic en la cabecera de columna alterna entre ascendente (▲) · descendente (▼).
• Filtrar: al escribir texto en el campo de entrada superior se filtra en tiempo real por coincidencia parcial en todas las columnas (solo filtra las filas mostradas, sin reconsultar la BD).

Más de 5000 filas

Muestra 5000 filas de forma predeterminada y, al superarlas, con el botón 5000 filas más carga acumulativamente mediante OFFSET/FETCH.

Selección · copia de celdas

Selecciona un rango rectangular arrastrando y, con Exportar ▾ → Portapapeles (TSV), lo copias para pegarlo directamente en Excel. Con Shift+doble clic ves el valor completo de la celda en el visor.

---

Edición directa de celdas → UPDATE

La edición de celdas solo se activa cuando el resultado es un SELECT de una sola tabla y se incluye la columna PK.

1. Haz doble clic en una celda para modificar el valor.
2. Al hacer clic en el botón commit, se añade al editor la sentencia UPDATE … WHERE PK=….
3. Ejecuta con Ctrl+Enter para aplicarla.

El cambio ejecutado se registra en el historial de cambios (Ctrl+Shift+H) como cualquier otro DML y se puede revertir.

Nota

La edición de celdas se desactiva en resultados que incluyan JOIN / GROUP BY / UNION / DISTINCT o en tablas sin PK. Lo mismo aplica a resultados de agregación o vistas.

---

Añadir filas nuevas · copiar filas → INSERT

Con los botones + Fila o Copiar fila de la barra de herramientas de la cuadrícula de resultados puedes usar INSERT en preparación (staged).

Botón	Acción
+ Fila	Añade una fila vacía (si se deja vacía, NULL)
Copiar fila	Añade una fila nueva con todos los valores de columna de la fila seleccionada duplicados

Tras añadir filas y editar las celdas, haz clic en el botón Guardar. Al guardar, se desactiva temporalmente el autocommit y se ejecuta el INSERT, de modo que después confirmas con commit o cancelas con rollback.

Consejo

Tras hacer clic en la columna #, con Ctrl+V puedes pegar tal cual las filas copiadas desde Excel.

---

Exportación masiva (CSV · Excel)

Selecciona Exportar ▾ → CSV o Excel.

• Modo streaming: el proceso principal transmite directamente al disco, por lo que puedes guardar millones de filas sin preocuparte por la memoria.
• En el modal de progreso se muestra N / total de filas (X%) y puedes interrumpir a mitad con el botón Cancelar.
• CSV: incluye BOM UTF-8 (el coreano se muestra correctamente en Excel).
• Excel (.xls): límite de 1 048 575 filas.

Caracteres corruptos al abrir el CSV en Excel

El CSV se guarda con BOM UTF-8. Si lo abres con doble clic, según la configuración del sistema puede abrirse sin opción de selección de codificación. Si los caracteres se corrompen, usa Importar datos de Excel (Power Query) → especificar codificación 65001 UTF-8, o copia con Portapapeles (TSV) y pega directamente.

Cuando la app se cuelga por un resultado de consulta masivo

Si intentas traer cientos de miles de filas de golpe a la cuadrícula, puede producirse falta de memoria. En lugar de copiar al portapapeles desde la cuadrícula, usa Exportar ▾ (streaming a disco).

---

Lenguaje natural → SQL (✨)

Con el botón ✨ del riel izquierdo del editor SQL alternas la barra de entrada de lenguaje natural.

▸ Los 5 principales clientes por ventas de este mes
▸ Muéstrame el número de usuarios registrados la semana pasada, por día

Orden de funcionamiento: análisis de palabras clave → puntuación del esquema completo de la conexión activa → selección de tablas·columnas relevantes → generación de SQL (con el estado de progreso y el tiempo transcurrido de cada paso). El SQL generado se inserta debajo de la línea del cursor (sin sobrescribir el contenido existente). Puedes deshacerlo con Ctrl+Z e interrumpir la generación con el botón Cancelar.

El SQL generado entra en el editor, por lo que lo ejecutas tú tras revisarlo — no se ejecuta automáticamente.

Mejora la precisión con el glosario

Con el botón 📒 Glosario de la barra de entrada, registra mapeos de términos de negocio → tablas/columnas/reglas para aumentar la precisión de la generación de SQL a partir de lenguaje natural. Ej.: "pedido" → tabla orders, "usuario activo" → status = 'active'.

Nota

La primera vez que usas lenguaje natural→SQL, si no hay índice de conocimiento se muestra el botón 📚 Sin índice — Crear. Haz clic para crear primero el índice. Si el resultado de lenguaje natural→SQL referencia tablas equivocadas, prueba también a reconstruir el índice + registrar el glosario.

---

Snippets de SQL

Guarda el SQL que usas con frecuencia para invocarlo rápidamente.

• Clic en el botón Snippets de la barra de herramientas → Guardar SQL actual (introduce un nombre; si lo dejas vacío, se usa automáticamente el comienzo del SQL).
• Al hacer clic en un elemento se carga en el editor, y con ✕ lo eliminas.
• Los snippets se guardan globalmente y se pueden usar desde cualquier editor de BD.

---

Historial de consultas

Al hacer clic en el botón Historial de la barra de herramientas, se muestran las consultas exitosas en orden cronológico inverso (eliminación automática de duplicados). Al hacer clic en un elemento se carga en el editor. El historial se guarda en userData/db-history.json.

---

IA de celdas de la cuadrícula (Ctrl+I)

Tras seleccionar un rango de celdas en la cuadrícula, al pulsar Ctrl+I o el botón IA de la barra de herramientas, puedes preguntar a la IA usando los datos seleccionados como contexto.

▸ Analiza los valores atípicos entre estos
▸ Crea una consulta UPDATE con estos datos
▸ ¿Por qué hay columnas con alta proporción de NULL?

Analiza usando como contexto los valores seleccionados · nombre de tabla · SQL ejecutado · información de PK · tipo de motor. Si superan las 200 filas, solo se transmiten las primeras 200.

---

Análisis de columna

Al seleccionar Analizar columna con clic derecho en el árbol, puedes ver estadísticas reales de los datos de la tabla basadas en muestra.

Columna status — NULL 2,3% · Distinct 4 (active, inactive, pending, blocked) · valor más frecuente active 87%
Columna amount — NULL 0% · min 100 · max 9 800 000 · media 452 000

Proporciona proporción de NULL · número de valores únicos · candidatos a enum y, si es numérico, min/max/media. Úsalo para conocer las características de una columna antes de escribir la consulta o para el diseño de índices.

---

Protección de consultas peligrosas

Las consultas que ejecutas directamente con Ctrl+Enter en el editor SQL se ejecutan al instante sin confirmación (para usuarios avanzados). A cambio, todo DDL/DML se registra automáticamente en el historial de cambios y se puede revertir (ver más abajo). Hay dos casos en los que aparece una ventana de confirmación antes de ejecutar.

Ruta	Acción
SQL que ejecuta la IA (herramienta db_query)	Las lecturas son automáticas; las escrituras·destructivas (DROP/TRUNCATE/DELETE sin WHERE, etc.) pasan por un diálogo de confirmación. Las conexiones con etiqueta prod se refuerzan un escalón
▶ Ejecutar un bloque de código SQL (respuesta de IA·code lens del editor)	DROP/DELETE/UPDATE/TRUNCATE/ALTER/GRANT/REVOKE, etc., se confirman junto con una vista previa de la consulta

Operaciones como clic derecho en el árbol de esquema → DROP TABLE… pasan por una confirmación reforzada que requiere escribir el nombre de la tabla para ejecutarse.

Reversión basada en copia de seguridad

Al ejecutar DDL/DML, los datos previos al cambio se respaldan automáticamente, de modo que se puede revertir tanto la ejecución humana como la de la IA.

• Volumen pequeño (≤1000 filas, tabla única con PK): las filas previas al cambio se conservan en JSON en la BD interna de historial.
• Volumen grande / complejo / sin PK: se crea una tabla de respaldo (blyck_bak_…) en la BD destino para conservarlas, y se elimina automáticamente tras la reversión.
• Algunos DDL como DROP / TRUNCATE no admiten SQL inverso, por lo que se marcan como elementos no reversibles.

Selecciona un elemento en el historial de cambios (Ctrl+Shift+H) y haz la reversión. Los UPDATE · DELETE masivos sin WHERE también se pueden restaurar desde los datos de respaldo.

---

Junto con el Chat con IA

El Chat con IA invoca directamente las herramientas de BD.

▸ Encuentra correos duplicados en esta tabla
▸ Muéstrame el esquema de orders y recomienda índices
▸ TOP 10 clientes con mayor tasa de cancelación de pedidos el mes pasado

Orden de funcionamiento: comprobar el esquema (db_schema) → analizar columnas si es necesario → escribir·ejecutar la consulta (db_query) → autocorrección si falla. Las consultas de escritura siempre pasan por las salvaguardas anteriores (diálogo de confirmación).

Consejo

En el Chat con IA también es posible lenguaje natural→SQL. Reconoce el motor del panel de BD activo y ajusta automáticamente el dialecto (Oracle ROWNUM, MSSQL TOP, MySQL/PG LIMIT), y pasa por una confirmación antes de ejecutar. Para saber cómo usar el Chat con IA, consulta el documento Chat con IA.

---

Integración con otros documentos

Función	Documento
Vincular BD al editor SQL para autocompletado de SQL dentro del código	Editor de código
Esquema de BD·resultados con Búsqueda RAG	Búsqueda unificada (RAG)
Historial de cambios·reversión de DML	Historial de cambios · Git
Automatizar tareas de BD con el Chat con IA	Chat con IA

---

Preguntas frecuentes

Aparece el error Oracle NJS-116.
Es un método de verificador de contraseña que el controlador Thin no admite. En el diálogo de conexión activa Forzar Thick e introduce la ruta del Instant Client de 64 bits.

Pulsé ■ Detener pero la consulta no se para.
La cancelación del lado del servidor es best-effort y se reconoce en el siguiente checkpoint. Espera un momento en consultas de agregación pesadas. SQLite no tiene fase de servidor, así que se interrumpe al instante.

La app se cierra durante una consulta masiva.
En lugar de copiar al portapapeles desde la cuadrícula, usa Exportar ▾ (streaming a disco). Excel tiene un límite de 1 millón de filas.

Abrí el CSV en Excel y los caracteres están corruptos.
El CSV se guarda con BOM UTF-8. Usa Importar datos de Excel → especificar codificación 65001 UTF-8, o pega directamente con Portapapeles (TSV).

No puedo editar las celdas.
Solo se activa en resultados de SELECT de una sola tabla que incluyan la columna PK. No se pueden editar resultados con JOIN · GROUP BY · UNION · DISTINCT ni resultados de vistas.

El resultado de lenguaje natural→SQL usa tablas equivocadas.
Reconstruye el índice y registra términos de negocio·mapeos de tablas en el 📒 Glosario para aumentar la precisión.

Justo tras conectar, el árbol está vacío.
La indexación del esquema puede tardar unos segundos tras conectar con éxito. Prueba a hacer clic en el botón ↻ de la cabecera. Si está en curso un fallback Thick de Oracle, la conexión puede tardar más en completarse.