Query Files

Doel

Even snel kijken wat er in een databestand zit, betekent meestal: een databaseclient openen, een tabel aanmaken, importeren, en dan pas je query. Query Files slaat dat allemaal over. Het bestand dat je in Notepad++ open hebt, wordt een tabel die THIS heet, en je schrijft er gewoon SQL op.

Onder de motorkap draait DuckDB: moderne SQL met window functions, QUALIFY, PIVOT en GROUP BY ALL, en snel genoeg voor bestanden van miljoenen rijen. Je kunt ook bestanden op schijf direct bevragen en met elkaar joinen, inclusief wildcards zoals 'logs/*.json'.

Er bestaat al een plugin die SQL op CSV draait (CSV Query), maar die gebruikt SQLite uit 2011 en kan alleen CSV. Query Files is in C++ geschreven, gebruikt een lokaal duckdb.exe, en stuurt niets het internet op. Broncode volledig open (MIT-licentie) op GitHub.

Wat je kunt verwachten

Zie het in actie

Een query op een open CSV-bestand, en het resultaat zoals de plugin het in een tabblad zet.

-- this: C:\data\orders.csv
select customer,
       count(*)    as orders,
       sum(amount) as revenue
from this
group by all
order by revenue desc;

┌──────────┬────────┬─────────┐
│ customer │ orders │ revenue │
│ varchar  │ int64  │ double  │
├──────────┼────────┼─────────┤
│ Alpha    │      3 │  394.75 │
│ Beta     │      2 │  122.75 │
│ Gamma    │      1 │    15.0 │
└──────────┴────────┴─────────┘

THIS is van de plugin

THIS is een gereserveerd woord van Query Files en altijd alleen-lezen. Gebruik het als tabel (from this, join this t, describe this, copy this to 'uit.parquet'), maar niet als naam: niet als alias, CTE of tabelnaam, en niet als doel van insert, update of delete. Een kolom die echt this heet, schrijf je tussen dubbele quotes.

Gebruik

1. Installatie

Nog niet in Notepad++'s Plugins Admin — handmatige installatie:

Download QueryFiles.zip van de laatste release en pak hem uit in de Notepad++ plugin-map (64-bit Notepad++ vereist):

C:\Program Files\Notepad++\plugins\
  QueryFiles\
    QueryFiles.dll
    help.txt

2. DuckDB

Query Files gebruikt het gratis duckdb.exe (duckdb.org). Zet het op je PATH, naast de plugin, of kies het in de instellingen. Gebruik je al Datamodder File Tools met DuckDB? Dan pakt Query Files die automatisch op.

3. Plugin activeren

Start Notepad++ opnieuw op. De plugin verschijnt automatisch onder Plugins → Datamodder Query Files.

4. Aan de slag

Open een databestand, kies Query this file, en klik op de ▶-knop in de werkbalk:

Plugins → Datamodder Query Files → Query this file
Plugins → Datamodder Query Files → Run query   (▶)

Veelgestelde vragen