Duomenų ir failų atsisiuntimas

Atsisiųskite visą lentelę kaip NDJSON, JSON, CSV ar Parquet su eksporto galiniu tašku ir atsisiųskite saugomus failus.

Užklausos galinis taškas skirtas eilutėms skaityti po puslapį JSON formatu. Kai norite viso rezultatų rinkinio kaip failo, naudokite eksporto galinį tašką – jis pateikia duomenis pasirinktu formatu be puslapiavimo.

POST/namespaces/{namespace}/tables/{tableName}/export

Toks pat kūnas kaip užklausoje

Eksportas priima tokį patį JSON užklausos kūną kaip užklausos galinis taškas – select, filter, sort, limit, offset, exclude_nulls – todėl bet kurią sudarytą užklausą galima eksportuoti. Vienintelis papildymas – format užklausos parametras, nurodantis failo tipą. Praleiskite kūną ({}), kad eksportuotumėte visą lentelę.

Formatai

Nustatykite format užklausos parametrą. ndjson yra numatytasis:

Parametras	Tipas	Aprašymas
`ndjson`	numatytasis	Naujos eilutės atskirtas JSON – vienas objektas eilutėje, tinka srautiniam apdorojimui.
`json`	formatas	Eilučių objektų JSON srautas.
`csv`	formatas	Kableliais atskirtos reikšmės – antraštės eilutė ir duomenys.
`xlsx`	formatas	Microsoft Excel darbaknygė. Ribojama iki 1 000 000 eilučių – didesnes lenteles filtruokite arba puslapiuokite.
`parquet`	formatas	Stulpelinis dvejetainis – mažiausias ir greičiausias analitikai.

# Visa lentelė kaip NDJSON
curl -L -o toksikologija.ndjson \
  -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/export?format=ndjson' \
  -H 'Content-Type: application/json' \
  -d '{}'

{"_id":"11939610733872445230","vda_id":"166d143f8929ba0","pavadinimas":"Etanolis (etilo alkoholis)","lytis":"Moteris","mirties_metai":2021, …}
{"_id":"00016506519020014367","vda_id":"4f277520b7ccca2","pavadinimas":"Etanolis (etilo alkoholis)","lytis":"Vyras","mirties_metai":2019, …}

Pakeiskite į format=csv, format=json, format=xlsx arba format=parquet, kad gautumėte kitą failo tipą, ir atitinkamai pakeiskite išvesties failo pavadinimą. xlsx (Excel) formatas ribojamas iki 1 000 000 eilučių – didesnes lenteles susiaurinkite su filter arba limit.

Pasirinkti stulpeliai ir filtrai

Kadangi eksportas naudoja tą patį užklausos kūną, susiaurinkite eksportą su select ir filter lygiai taip pat kaip užklausą – užklausų vadove aprašyta visa filtro gramatika:

# Tik trys stulpeliai, mirusios moterys, kaip NDJSON
curl -L -o subset.ndjson \
  -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/export?format=ndjson' \
  -H 'Content-Type: application/json' \
  -d '{"select":"lytis,mirties_metai,pavadinimas","filter":"lytis=Moteris"}'

Užklausos kūnas

Parametras	Tipas	Aprašymas
`select`	string	Kableliais atskirti įtraukiami stulpeliai. Praleiskite visiems.
`filter`	string	Filtro išraiška – tokia pat gramatika kaip užklausos galiniame taške.
`sort`	string	Kableliais atskirti raktai. Prefiksas - – mažėjančiai.
`limit`	int	Apriboti į failą įrašomų eilučių skaičių.
`offset`= 0	int	Praleidžiamos eilutės prieš įrašymą.
`exclude_nulls`	string[]	Stulpeliai, kurie turi būti ne-null; eilutės su null ten pašalinamos.

format užklausos parametras

format rašomas URL adrese kaip užklausos eilutė (?format=ndjson), o ne JSON kūne. Kūne perduodami tik aukščiau nurodyti užklausos laukai.

Failų atsisiuntimas

Su vardų erdve susieti saugomi failai (PDF, paveikslėliai, archyvai) atsisiunčiami pagal pavadinimą. Failo pavadinimas yra vienas bazinis vardas – jame negali būti /.

GET/namespaces/{namespace}/files/{fileName}

curl -L -O 'https://api.dataportal.gov.lt/namespaces/{namespace}/files/report.pdf'

Atsakymas yra neapdoroti baitai su išsaugotu pirminiu Content-Type ir failo pavadinimu.

Duomenų ir failų atsisiuntimas

Formatai

Pasirinkti stulpeliai ir filtrai

Užklausos kūnas

Failų atsisiuntimas

Užklausos į lenteles

Klaidos

Taip pat žiūrėkite

Šiame puslapyje