Plugin Beekeeper Studio read-only untuk mencari kolom di semua tabel dan view pada database yang aktif.
Mendukung PostgreSQL, MySQL, dan MariaDB. Pencarian parsial tanpa membedakan huruf besar/kecil menampilkan skema, tabel/view, kolom, dan tipe data. Pintasan Structure membuka tabel yang cocok jika ada di daftar entitas yang sudah dimuat Beekeeper. Hasil dibatasi 500. Tanpa telemetri, server tambahan, atau kredensial database.
Penting: plugin terbuka di tab tersendiri melalui panah di samping +. SDK resmi tidak mengizinkan plugin mengubah filter sidebar bawaan.
Instal dari artifact CI (tanpa perlu Node)
- Buka Actions → CI lalu download artifact beekeeper-column-finder dari run yang berhasil.
- Ekstrak manifest.json dan dist/ ke dalam folder bernama beekeeper-column-finder di direktori plugin 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
- Aktifkan plugin komunitas (lihat di bawah), restart Beekeeper sepenuhnya, lalu buka Column Finder dari dropdown di samping +.
Struktur yang diharapkan: beekeeper-column-finder/manifest.json dan beekeeper-column-finder/dist/index.html serta dist/assets/.
CI melakukan build di Windows dan Ubuntu dengan Node.js 22, menjalankan unit test, lalu mengunggah bundle plugin yang siap diinstal (tersedia selama 30 hari; download artifact GitHub mungkin perlu login).
Instal dari source (Windows PowerShell)
Jalankan perintah berikut di 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
}
Jika Anda sudah menautkan versi lama, jangan membuat ulang junction. Tarik source terbaru, jalankan npm install, npm test, npm run build, lalu restart Beekeeper.
Aktifkan plugin komunitas (Beekeeper 5.7+)
Di Windows, buka file pengaturan:
notepad "$env:APPDATA\beekeeper-studio\user.config.ini"
Tambahkan atau perbarui satu bagian pluginSystem tanpa mengubah pengaturan Anda yang lain:
[pluginSystem]
disabled = false
communityDisabled = false
Jangan menambahkan ID Column Finder ke allow[]; hanya ID plugin bawaan yang diterima di sana. Konfigurasi ini juga mengizinkan plugin pihak ketiga lainnya, jadi instal hanya yang Anda percayai. system.config.ini milik administrator dapat menimpa pengaturan pengguna.
Di Beekeeper, buka Tools → Manage Plugins untuk memastikan Column Finder sudah aktif. Restart jika perlu. Lalu gunakan dropdown tab di samping +.
Perilaku dan keterbatasan
| Database | Cakupan pencarian |
|---|---|
| PostgreSQL | Semua skema pengguna yang dapat diakses di database aktif, kecuali pg_catalog, information_schema, dan pg_toast* |
| MySQL | DATABASE(), database yang dipilih |
| MariaDB | DATABASE(), database yang dipilih |
Pencarian hanya membaca information_schema.columns dan mengikuti hak akses metadata Anda. Input dikodekan sebagai UTF-8 dalam hex, sehingga mencegah SQL injection dan memperlakukan karakter persen/garis bawah secara literal. Tidak ada operasi tulis. Maksimal 500 hasil ditampilkan, dengan penanda jika masih ada hasil lain.
Pintasan Structure bergantung pada daftar tabel yang sudah dimuat oleh Beekeeper. Refresh daftar entitas jika tabel ditemukan tetapi navigasi gagal. Navigasi MySQL dan MariaDB tidak menyertakan skema agar sesuai dengan representasi internal host. Beberapa skema PostgreSQL juga mungkin tidak ada di cache host.
Pengembangan dan pengujian
npm install
npm test
npm run build
npm run dev
- Test runner bawaan Node memeriksa pembuatan SQL, ketahanan terhadap injection, dialek, dan opsi navigasi tabel (8 unit test).
- Compiler TypeScript memeriksa tipe dan Vite melakukan build plugin untuk production.
- GitHub Actions menjalankan test dan build di Windows dan Ubuntu, lalu mengunggah manifest.json + dist sebagai artifact.
- Unit test tidak menjalankan query ke database sungguhan; verifikasi integrasi MySQL/PostgreSQL/MariaDB secara manual.
Struktur proyek: src/sql.ts (SQL), src/navigation.ts (navigasi tab host), src/main.ts (integrasi SDK), src/style.css dan index.html (UI), tests/*.test.mjs (unit test), serta .github/workflows/ci.yml (otomasi).
Pemecahan masalah
- Plugin tidak ada/nonaktif: periksa Tools → Manage Plugins dan user.config.ini.
- Versi lama: periksa manifest.json di direktori plugin yang sebenarnya atau target junction.
- Structure menampilkan “Table not found”: refresh entitas; host hanya membuka tabel yang ada di cache.
- Build gagal setelah beralih Windows/Linux: instal ulang dependensi dengan npm install untuk platform Anda.
- Masalah SDK: periksa Help → Show Developer Tools di Beekeeper.
Referensi dan lisensi
Lisensi MIT. Proyek komunitas independen; tidak didukung secara resmi oleh Beekeeper Studio.