menu
languageItaliano
save_alt Download

Column Finder

Trova colonne in tabelle e viste di PostgreSQL, MySQL e MariaDB con ricerche sullo schema in sola lettura.

di Vitor Hugo Plugin della community

Readme

Questo testo è stato scritto da terzi e tradotto automaticamente. Leggi l'originale in inglese

CI

Un plugin di Beekeeper Studio in sola lettura per trovare colonne in tutte le tabelle e viste del database attivo.

Supporta PostgreSQL, MySQL e MariaDB. Le ricerche parziali e senza distinzione tra maiuscole e minuscole mostrano schema, tabella/vista, colonna e tipo di dato. Una scorciatoia Struttura apre le tabelle corrispondenti se presenti nell'elenco delle entità caricato da Beekeeper. I risultati sono limitati a 500. Niente telemetria, server aggiuntivi o credenziali del database.

Importante: il plugin si apre in una scheda dedicata tramite la freccia accanto a +. L'SDK ufficiale non permette ai plugin di modificare il filtro nativo della barra laterale.

Installa dall'artifact CI (senza Node)

  1. Apri Actions → CI e scarica l'artifact beekeeper-column-finder da un'esecuzione riuscita.
  2. Estrai il file manifest.json e la dist/ directory in una cartella chiamata beekeeper-column-finder nella directory dei plugin di 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
  3. Abilita i plugin della community (vedi sotto), riavvia completamente Beekeeper, poi apri Column Finder dal menu a tendina accanto a +.

Struttura prevista: beekeeper-column-finder/manifest.json e beekeeper-column-finder/dist/index.html più dist/assets/.

La CI compila su Windows e Ubuntu con Node.js 22, esegue i test unitari e poi carica un pacchetto del plugin installabile (disponibile per 30 giorni; per scaricare gli artifact di GitHub potrebbe essere necessario l'accesso).

Installa dai sorgenti (Windows PowerShell)

Esegui questi comandi in 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
}

Se hai già collegato una versione precedente, non ricreare la junction. Scarica i sorgenti più recenti, esegui npm install, npm test, npm run build e riavvia Beekeeper.

Abilita i plugin della community (Beekeeper 5.7+)

Su Windows, apri il file delle impostazioni:

notepad "$env:APPDATA\beekeeper-studio\user.config.ini"

Aggiungi o aggiorna una sola sezione pluginSystem, mantenendo le altre impostazioni:

[pluginSystem]
disabled = false
communityDisabled = false

Non aggiungere l'ID di Column Finder ad allow[]: lì sono accettati solo gli ID dei plugin inclusi. Questa configurazione consente anche altri plugin di terze parti, quindi installa solo quelli di cui ti fidi. Il file system.config.ini di un amministratore può sovrascrivere le impostazioni utente.

In Beekeeper apri Tools → Manage Plugins per verificare che Column Finder sia abilitato. Riavvia se necessario. Poi usa il menu a tendina delle schede accanto a +.

Comportamento e limitazioni

Database Ambito di ricerca
PostgreSQL Tutti gli schemi utente accessibili nel database attivo, esclusi pg_catalog, information_schema e pg_toast*
MySQL DATABASE(), il database selezionato
MariaDB DATABASE(), il database selezionato

La ricerca legge solo information_schema.columns e rispecchia i tuoi privilegi sui metadati. Usa input UTF-8 codificato in esadecimale, prevenendo la SQL injection e trattando letteralmente i caratteri percentuale/underscore. Non esegue scritture. Vengono mostrate fino a 500 corrispondenze, con un'indicazione se ce ne sono altre.

La scorciatoia Struttura dipende dall'elenco delle tabelle già caricato da Beekeeper. Aggiorna l'elenco delle entità se una tabella viene trovata ma la navigazione non riesce. Per MySQL e MariaDB la navigazione omette lo schema per corrispondere alla rappresentazione interna dell'host. Allo stesso modo, alcuni schemi PostgreSQL potrebbero mancare dalla cache dell'host.

Sviluppo e test

npm install
npm test
npm run build
npm run dev
  • Il test runner integrato di Node verifica la generazione SQL, la resistenza alle injection, i dialetti e le opzioni di navigazione delle tabelle (8 test unitari).
  • Il compilatore TypeScript controlla i tipi e Vite compila il plugin per la produzione.
  • GitHub Actions esegue test e build su Windows e Ubuntu, poi carica manifest.json + dist come artifact.
  • I test unitari non eseguono query su database reali: verifica manualmente l'integrazione con MySQL/PostgreSQL/MariaDB.

Struttura del progetto: src/sql.ts (SQL), src/navigation.ts (navigazione tra le schede dell'host), src/main.ts (integrazione SDK), src/style.css e index.html (UI), tests/*.test.mjs (test unitari) e .github/workflows/ci.yml (automazione).

Risoluzione dei problemi

  • Plugin mancante/disabilitato: controlla Tools → Manage Plugins e user.config.ini.
  • Versione vecchia: controlla il manifest.json nella directory effettiva del plugin o nella destinazione della junction.
  • Struttura mostra “Table not found”: aggiorna le entità; l'host apre solo le tabelle in cache.
  • La build fallisce dopo il passaggio tra Windows/Linux: reinstalla le dipendenze con npm install per la tua piattaforma.
  • Problemi con l'SDK: controlla Help → Show Developer Tools in Beekeeper.

Riferimenti e licenza

Licenza MIT. Progetto indipendente della community, non approvato da Beekeeper Studio.