Un plugin de solo lectura para Beekeeper Studio que encuentra columnas en todas las tablas y vistas de la base de datos activa.
Compatible con PostgreSQL, MySQL y MariaDB. Las búsquedas parciales, sin distinguir mayúsculas de minúsculas, muestran el esquema, la tabla/vista, la columna y el tipo de dato. Un acceso directo a Estructura abre las tablas coincidentes cuando están en la lista de entidades cargada en Beekeeper. Los resultados se limitan a 500. Sin telemetría, servidores extra ni credenciales de base de datos.
Importante: el plugin se abre en su propia pestaña desde la flecha junto a +. El SDK oficial no permite que los plugins modifiquen el filtro nativo de la barra lateral.
Instalar desde un artefacto de CI (sin necesidad de Node)
- Abre Actions → CI y descarga el artefacto beekeeper-column-finder de una ejecución exitosa.
- Extrae su manifest.json y el directorio dist/ en una carpeta llamada beekeeper-column-finder dentro del directorio de plugins de Beekeeper:
- Windows: %APPDATA%\beekeeper-studio\plugins\beekeeper-column-finder
- Linux: ~/.config/beekeeper-studio/plugins/beekeeper-column-finder
- macOS: ~/Library/Application Support/beekeeper-studio/plugins/beekeeper-column-finder
- Windows Portable: {app-directory}\beekeeper-studio-data\plugins\beekeeper-column-finder
- Habilita los plugins de la comunidad (abajo), reinicia Beekeeper por completo y luego abre Column Finder desde el menú desplegable junto a +.
Estructura esperada: beekeeper-column-finder/manifest.json y beekeeper-column-finder/dist/index.html, además de dist/assets/.
La CI compila en Windows y Ubuntu con Node.js 22, ejecuta pruebas unitarias y después sube un paquete del plugin listo para instalar (disponible por 30 días; descargar artefactos de GitHub puede requerir iniciar sesión).
Instalar desde el código fuente (Windows PowerShell)
Ejecuta estos comandos en PowerShell:
git clone https://github.com/hugoalves-dev/beekeeper-studio-column-finder.git
cd beekeeper-studio-column-finder
npm install
npm test
npm run build
$pluginDirectory = Join-Path $env:APPDATA 'beekeeper-studio\plugins'
New-Item -ItemType Directory -Force -Path $pluginDirectory | Out-Null
$link = Join-Path $pluginDirectory 'beekeeper-column-finder'
if (Test-Path $link) {
Write-Host "Already exists: $link. Check its target before changing it."
} else {
New-Item -ItemType Junction -Path $link -Target (Get-Location).Path | Out-Null
}
Si ya enlazaste una versión anterior, no vuelvas a crear el junction. Descarga el código más reciente, ejecuta npm install, npm test, npm run build y reinicia Beekeeper.
Habilitar plugins de la comunidad (Beekeeper 5.7+)
En Windows, abre el archivo de configuración:
notepad "$env:APPDATA\beekeeper-studio\user.config.ini"
Agrega o actualiza una sola sección pluginSystem sin perder el resto de tu configuración:
[pluginSystem]
disabled = false
communityDisabled = false
No agregues el ID de Column Finder a allow[]; ahí solo se aceptan IDs de plugins incluidos. Esta configuración también permite otros plugins de terceros, así que instala solo los que sean de confianza. El system.config.ini de un administrador puede sobrescribir la configuración del usuario.
En Beekeeper, abre Tools → Manage Plugins para confirmar que Column Finder esté habilitado. Reinicia si hace falta. Luego usa el menú desplegable de pestañas junto a +.
Comportamiento y limitaciones
| Base de datos | Alcance de la búsqueda |
|---|---|
| PostgreSQL | Todos los esquemas de usuario accesibles en la base de datos activa, excepto pg_catalog, information_schema y pg_toast* |
| MySQL | DATABASE(), la base de datos seleccionada |
| MariaDB | DATABASE(), la base de datos seleccionada |
La búsqueda solo lee information_schema.columns y refleja tus privilegios sobre los metadatos. Usa entrada UTF-8 codificada en hexadecimal, lo que evita la inyección SQL y trata los caracteres de porcentaje y guion bajo de forma literal. No realiza escrituras. Se muestran hasta 500 coincidencias, con un aviso si hay más.
El acceso directo a Estructura depende de la lista de tablas ya cargada en Beekeeper. Actualiza la lista de entidades si se encuentra una tabla pero la navegación falla. En MySQL y MariaDB la navegación omite el esquema para coincidir con la representación interna de la aplicación. Del mismo modo, algunos esquemas de PostgreSQL pueden no estar en la caché de la aplicación.
Desarrollo y pruebas
npm install
npm test
npm run build
npm run dev
- El ejecutor de pruebas integrado de Node verifica la generación de SQL, la resistencia a inyecciones, los dialectos y las opciones de navegación de tablas (8 pruebas unitarias).
- El compilador de TypeScript verifica los tipos y Vite compila el plugin para producción.
- GitHub Actions ejecuta las pruebas y la compilación en Windows y Ubuntu, y luego sube manifest.json + dist como artefacto.
- Las pruebas unitarias no ejecutan consultas contra bases de datos reales; verifica manualmente la integración con MySQL/PostgreSQL/MariaDB.
Estructura del proyecto: src/sql.ts (SQL), src/navigation.ts (navegación de pestañas de la aplicación), src/main.ts (integración con el SDK), src/style.css e index.html (UI), tests/*.test.mjs (pruebas unitarias) y .github/workflows/ci.yml (automatización).
Solución de problemas
- Plugin ausente o deshabilitado: revisa Tools → Manage Plugins y user.config.ini.
- Versión antigua: revisa el manifest.json en el directorio real del plugin o en el destino del junction.
- Estructura muestra “Table not found”: actualiza las entidades; la aplicación solo abre tablas en caché.
- La compilación falla tras cambiar entre Windows y Linux: reinstala las dependencias con npm install para tu plataforma.
- Problemas con el SDK: revisa Help → Show Developer Tools en Beekeeper.
Referencias y licencia
Licencia MIT. Proyecto independiente de la comunidad; no está respaldado por Beekeeper Studio.