Ένα plugin μόνο για ανάγνωση για το Beekeeper Studio που βρίσκει στήλες σε όλους τους πίνακες και τα views της ενεργής βάσης δεδομένων.
Υποστηρίζει PostgreSQL, MySQL και MariaDB. Οι μερικές αναζητήσεις χωρίς διάκριση πεζών-κεφαλαίων εμφανίζουν schema, πίνακα/view, στήλη και τύπο δεδομένων. Μια συντόμευση Structure ανοίγει τους πίνακες που ταιριάζουν, όταν υπάρχουν στη φορτωμένη λίστα οντοτήτων του Beekeeper. Τα αποτελέσματα περιορίζονται στα 500. Χωρίς telemetry, επιπλέον server ή διαπιστευτήρια βάσης δεδομένων.
Σημαντικό: το plugin ανοίγει στη δική του καρτέλα από το βέλος δίπλα στο +. Το επίσημο SDK δεν επιτρέπει στα plugins να τροποποιούν το εγγενές φίλτρο της πλαϊνής μπάρας.
Εγκατάσταση από CI artifact (χωρίς Node)
- Άνοιξε το Actions → CI και κατέβασε το artifact beekeeper-column-finder από ένα επιτυχημένο run.
- Εξήγαγε το manifest.json και τον dist/ φάκελο σε έναν φάκελο με όνομα beekeeper-column-finder στον φάκελο plugins του 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
- Ενεργοποίησε τα community plugins (παρακάτω), κάνε πλήρη επανεκκίνηση του Beekeeper και άνοιξε το Column Finder από το αναπτυσσόμενο μενού δίπλα στο +.
Αναμενόμενη δομή: beekeeper-column-finder/manifest.json και beekeeper-column-finder/dist/index.html μαζί με dist/assets/.
Το CI κάνει build σε Windows και Ubuntu με Node.js 22, τρέχει unit tests και ανεβάζει ένα πακέτο plugin έτοιμο για εγκατάσταση (διαθέσιμο για 30 ημέρες· η λήψη artifacts από το GitHub μπορεί να απαιτεί σύνδεση).
Εγκατάσταση από τον πηγαίο κώδικα (Windows PowerShell)
Τρέξε αυτές τις εντολές στο 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
}
Αν έχεις ήδη συνδέσει παλαιότερη έκδοση, μην ξαναδημιουργήσεις το junction. Τράβηξε τον πιο πρόσφατο κώδικα, τρέξε npm install, npm test, npm run build και κάνε επανεκκίνηση του Beekeeper.
Ενεργοποίηση community plugins (Beekeeper 5.7+)
Στα Windows, άνοιξε το αρχείο ρυθμίσεων:
notepad "$env:APPDATA\beekeeper-studio\user.config.ini"
Πρόσθεσε ή ενημέρωσε μία ενότητα pluginSystem, διατηρώντας τις υπόλοιπες ρυθμίσεις σου:
[pluginSystem]
disabled = false
communityDisabled = false
Μην προσθέσεις το ID του Column Finder στο allow[]· εκεί γίνονται δεκτά μόνο IDs ενσωματωμένων plugins. Αυτή η ρύθμιση επιτρέπει και άλλα plugins τρίτων, οπότε εγκατάστησε μόνο όσα εμπιστεύεσαι. Το system.config.ini ενός διαχειριστή μπορεί να υπερισχύει των ρυθμίσεων χρήστη.
Στο Beekeeper άνοιξε Tools → Manage Plugins για να επιβεβαιώσεις ότι το Column Finder είναι ενεργό. Κάνε επανεκκίνηση αν χρειαστεί. Μετά χρησιμοποίησε το αναπτυσσόμενο μενού καρτελών δίπλα στο +.
Συμπεριφορά και περιορισμοί
| Βάση δεδομένων | Εύρος αναζήτησης |
|---|---|
| PostgreSQL | Όλα τα προσβάσιμα schemas χρήστη στην ενεργή βάση δεδομένων, εκτός από pg_catalog, information_schema και pg_toast* |
| MySQL | DATABASE(), η επιλεγμένη βάση δεδομένων |
| MariaDB | DATABASE(), η επιλεγμένη βάση δεδομένων |
Η αναζήτηση διαβάζει μόνο το information_schema.columns και αντικατοπτρίζει τα δικαιώματά σου στα μεταδεδομένα. Χρησιμοποιεί είσοδο UTF-8 κωδικοποιημένη σε hex, αποτρέποντας το SQL injection και αντιμετωπίζοντας κυριολεκτικά τους χαρακτήρες ποσοστού/κάτω παύλας. Δεν εκτελεί καμία εγγραφή. Εμφανίζονται έως 500 αποτελέσματα, με ένδειξη αν υπάρχουν περισσότερα.
Η συντόμευση Structure εξαρτάται από τη λίστα πινάκων που έχει ήδη φορτώσει το Beekeeper. Ανανέωσε τη λίστα οντοτήτων αν ένας πίνακας βρεθεί αλλά η πλοήγηση αποτύχει. Στις MySQL και MariaDB η πλοήγηση παραλείπει το schema για να ταιριάζει με την εσωτερική αναπαράσταση της εφαρμογής. Ομοίως, κάποια schemas της PostgreSQL μπορεί να λείπουν από την cache της εφαρμογής.
Ανάπτυξη και testing
npm install
npm test
npm run build
npm run dev
- Ο ενσωματωμένος test runner του Node ελέγχει τη δημιουργία SQL, την αντοχή σε injection, τις διαλέκτους και τις επιλογές πλοήγησης πινάκων (8 unit tests).
- Ο compiler της TypeScript ελέγχει τους τύπους και το Vite κάνει build του plugin για production.
- Το GitHub Actions τρέχει tests και build σε Windows και Ubuntu και μετά ανεβάζει τα manifest.json + dist ως artifact.
- Τα unit tests δεν εκτελούν queries σε πραγματικές βάσεις δεδομένων· επαλήθευσε χειροκίνητα την ενσωμάτωση με MySQL/PostgreSQL/MariaDB.
Δομή project: src/sql.ts (SQL), src/navigation.ts (πλοήγηση καρτελών της εφαρμογής), src/main.ts (ενσωμάτωση SDK), src/style.css και index.html (UI), tests/*.test.mjs (unit tests) και .github/workflows/ci.yml (αυτοματοποίηση).
Αντιμετώπιση προβλημάτων
- Το plugin λείπει/είναι απενεργοποιημένο: έλεγξε το Tools → Manage Plugins και το user.config.ini.
- Παλιά έκδοση: έλεγξε το manifest.json στον πραγματικό φάκελο του plugin ή στον στόχο του junction.
- Το Structure δείχνει “Table not found”: ανανέωσε τις οντότητες· η εφαρμογή ανοίγει μόνο πίνακες που είναι στην cache.
- Το build αποτυγχάνει μετά από αλλαγή Windows/Linux: εγκατάστησε ξανά τα dependencies με npm install για την πλατφόρμα σου.
- Προβλήματα SDK: έλεγξε το Help → Show Developer Tools στο Beekeeper.
Αναφορές και άδεια
- Επίσημο plugin API του Beekeeper
- Δημιούργησε το πρώτο σου plugin
- PostgreSQL information_schema.columns
Άδεια MIT. Ανεξάρτητο community project· δεν υποστηρίζεται επίσημα από το Beekeeper Studio.