jq Playground
| Filter | Kirjeldus |
|---|---|
| Vorminda kogu dokument loetavaks | |
| Itereeri massiivi iga elemendi üle | |
| Loe pesastatud väärtus tee järgi | |
| Jäta alles ainult tingimusele vastavad elemendid | |
| Teisenda massiivi iga element | |
| Loetle objekti võtmed | |
| Teisenda objekt võtme/väärtuse paarideks | |
| Rühmita elemendid välja järgi ja loenda need | |
| Sorteeri massiiv välja järgi | |
| Loenda massiivi elemendid | |
| Vorminda read CSV-ks (lülita sisse Toorväljund) | |
| Kodeeri string Base64-ks (lülita sisse Toorväljund) | |
| Loetle kõigi arvuliste väärtuste teed | |
| Kogu rekursiivselt kõik arvud | |
| Summeeri väärtused funktsiooniga reduce | |
| Loe kõik sisendid nullsisendiga (proovi mitut JSON-dokumenti) |
Tehnilised üksikasjad
Kuidas jq Playground töötab
Mida tööriist teeb
jq Playground käivitab päris jq filtreid sinu JSON-i peal sedamööda, kuidas kirjutad. jq 1.8 kompileeritakse WebAssemblyks ja käitatakse Web Workeris, mistõttu tulemused vastavad täpselt käsurea tööriistale, sh veateated. Kleebi JSON, kirjuta filter, näiteks .users[] | select(.age > 30) | .name, ja väljund uueneb pärast lühikest pausi. Valikud vastavad otse jq lippudele: toorväljund (-r), kompaktne (-c), slurp (-s), nullsisend (-n), sorditud võtmed (-S), tabeldusmärgiga taane (--tab) ja nimega --arg muutujad.
Levinumad kasutusjuhud
Arendajad kasutavad seda filtrite prototüüpimiseks enne nende panemist shelliskriptidesse, CI konveieritesse ning Kubernetese või AWS CLI ühe rea käskudesse, suurte API vastuste ja logiridade uurimiseks, JSON-i teisendamiseks CSV-ks @csv-ga, kasulike andmete ümberkujundamiseks käskudega map, group_by ja reduce ning jq õppimiseks sisseehitatud spikri klõpsatavate näidete abil.
Sisendid, väljundid ja lipud
Sisend võib olla üks JSON-dokument või mitu järjestikust dokumenti, nt NDJSON; Slurpiga pakitakse need üheks massiiviks ja Nullsisendiga loed neid ise käskudega input ja inputs. Iga tulemus trükitakse eraldi reale. Toorväljund trükib stringid ilma jutumärkideta, mis on vajalik @csv, @tsv, @base64 ja @uri väljundi jaoks. Valikuga --arg edastatud väärtused on filtris saadaval kujul $name ja on alati stringid.
Lõksud ja piirangud
Sisend on piiratud 5 MB-ga ja käivitus peatatakse 10 sekundi pärast, et lõputu filter ei saaks lehte hanguma panna. Numbreid töödeldakse jq kahekordse täpsuse semantikaga, seega võivad üle 2^53 täisarvud täpsust kaotada. Kesta jutumärkimist pole siin vaja: terminalis pane filter ühekordsetesse jutumärkidesse. See playground ei toeta jq mooduleid, importi failidest ega keskkonnamuutujaid.