Plac zabaw jq
| Filtr | Opis |
|---|---|
| Sformatuj czytelnie cały dokument | |
| Iteruj po każdym elemencie tablicy | |
| Odczytaj zagnieżdżoną wartość według ścieżki | |
| Zachowaj tylko elementy spełniające warunek | |
| Przekształć każdy element tablicy | |
| Wypisz klucze obiektu | |
| Zamień obiekt na pary klucz/wartość | |
| Pogrupuj elementy według pola i policz je | |
| Posortuj tablicę według pola | |
| Policz elementy tablicy | |
| Sformatuj wiersze jako CSV (włącz Surowe wyjście) | |
| Zakoduj ciąg w Base64 (włącz Surowe wyjście) | |
| Wypisz ścieżki wszystkich wartości liczbowych | |
| Rekurencyjnie zbierz wszystkie liczby | |
| Zsumuj wartości za pomocą reduce | |
| Odczytaj wszystkie dane wejściowe z pustym wejściem (wypróbuj kilka dokumentów JSON) |
Szczegóły techniczne
Jak działa plac zabaw jq
Co robi to narzędzie
Plac zabaw jq uruchamia prawdziwe filtry jq na Twoim JSON w trakcie pisania. jq 1.8 jest skompilowany do WebAssembly i uruchamiany w Web Worker, więc wyniki dokładnie odpowiadają narzędziu wiersza poleceń, w tym komunikaty o błędach. Wklej JSON, napisz filtr, na przykład .users[] | select(.age > 30) | .name, a wynik zaktualizuje się po krótkiej pauzie. Opcje odpowiadają bezpośrednio flagom jq: surowe wyjście (-r), kompaktowo (-c), slurp (-s), puste wejście (-n), posortowane klucze (-S), wcięcie tabulatorem (--tab) i nazwane zmienne --arg.
Typowe zastosowania
Programiści używają go do prototypowania filtrów przed umieszczeniem ich w skryptach powłoki, potokach CI i jednolinijkowcach Kubernetes lub AWS CLI, do eksplorowania dużych odpowiedzi API i linii logów, konwertowania JSON na CSV za pomocą @csv, przekształcania danych za pomocą map, group_by i reduce oraz do nauki jq dzięki wbudowanej ściądze z klikalnymi przykładami.
Wejścia, wyjścia i flagi
Dane wejściowe mogą być pojedynczym dokumentem JSON lub kilkoma połączonymi dokumentami, np. NDJSON; ze Slurp są pakowane w jedną tablicę, a z Pustym wejściem odczytujesz je samodzielnie przez input i inputs. Każdy wynik jest drukowany w osobnej linii. Surowe wyjście drukuje ciągi bez cudzysłowów, co jest potrzebne dla wyjścia @csv, @tsv, @base64 i @uri. Wartości przekazane przez --arg są dostępne w filtrze jako $name i zawsze są ciągami.
Pułapki i ograniczenia
Dane wejściowe są ograniczone do 5 MB, a uruchomienie jest zatrzymywane po 10 sekundach, aby nieskończony filtr nie zawiesił strony. Liczby są przetwarzane według semantyki podwójnej precyzji jq, więc liczby całkowite powyżej 2^53 mogą utracić precyzję. Cytowanie powłoki nie jest tu potrzebne: w terminalu ujmij filtr w apostrofy. Ten plac zabaw nie obsługuje modułów jq, importu z plików ani zmiennych środowiskowych.