jq Playground
| Suodatin | Kuvaus |
|---|---|
| Muotoile koko dokumentti | |
| Käy läpi taulukon jokainen alkio | |
| Lue sisäkkäinen arvo polun perusteella | |
| Säilytä vain ehtoon täsmäävät alkiot | |
| Muunna taulukon jokainen alkio | |
| Luettele objektin avaimet | |
| Muunna objekti avain/arvo-pareiksi | |
| Ryhmittele alkiot kentän mukaan ja laske ne | |
| Järjestä taulukko kentän mukaan | |
| Laske taulukon alkiot | |
| Muotoile rivit CSV:ksi (ota Raakatuloste käyttöön) | |
| Koodaa merkkijono Base64-muotoon (ota Raakatuloste käyttöön) | |
| Luettele kaikkien numeeristen arvojen polut | |
| Kerää rekursiivisesti kaikki luvut | |
| Laske arvot yhteen reducella | |
| Lue kaikki syötteet null-syötteellä (kokeile useita JSON-dokumentteja) |
Tekniset tiedot
Näin jq Playground toimii
Mitä työkalu tekee
jq Playground suorittaa oikeita jq-suodattimia JSONillesi kirjoittaessasi. jq 1.8 on käännetty WebAssemblyksi ja suoritetaan Web Workerissa, joten tulokset vastaavat täsmälleen komentorivityökalua, virheilmoitukset mukaan lukien. Liitä JSON, kirjoita suodatin, kuten .users[] | select(.age > 30) | .name, ja tuloste päivittyy lyhyen tauon jälkeen. Asetukset vastaavat suoraan jq:n lippuja: raakatuloste (-r), tiivis (-c), slurp (-s), null-syöte (-n), järjestetyt avaimet (-S), sarkainsisennys (--tab) ja nimetyt --arg-muuttujat.
Yleisiä käyttötapauksia
Kehittäjät käyttävät sitä suodattimien prototyyppien tekoon ennen kuin ne viedään komentotulkkiskripteihin, CI-putkiin ja Kubernetes- tai AWS CLI -yksirivisiin, suurten API-vastausten ja lokirivien tutkimiseen, JSONin muuntamiseen CSV:ksi @csv:llä, payloadien muotoiluun map-, group_by- ja reduce-funktioilla sekä jq:n oppimiseen sisäänrakennetun, napsautettavia esimerkkejä sisältävän pikaoppaan avulla.
Syötteet, tulosteet ja liput
Syöte voi olla yksi JSON-dokumentti tai useita yhdistettyjä dokumentteja, kuten NDJSON; Slurpilla ne kääritään yhteen taulukkoon ja Null-syötteellä luet ne itse input- ja inputs-funktioilla. Jokainen tulos tulostetaan omalle rivilleen. Raakatuloste tulostaa merkkijonot ilman lainausmerkkejä, mitä tarvitaan @csv-, @tsv-, @base64- ja @uri-tulosteisiin. --arg-valitsimella annetut arvot ovat suodattimessa käytettävissä muodossa $name ja ovat aina merkkijonoja.
Sudenkuopat ja rajoitukset
Syöte on rajattu 5 Mt:hen ja suoritus keskeytetään 10 sekunnin jälkeen, jotta päättymätön suodatin ei jäädytä sivua. Luvut käsitellään jq:n kaksoistarkkuuden semantiikalla, joten yli 2^53:n kokonaisluvut voivat menettää tarkkuutta. Komentotulkin lainausmerkkejä ei tarvita tässä: päätteessä kääri suodatin yksittäisiin lainausmerkkeihin. Tämä playground ei tue jq-moduuleja, tuontia tiedostoista eikä ympäristömuuttujia.