Diese Seite dokumentiert erweiterte Funktionen für Datenabfragen. Es empfiehlt sich zuerst die Seite API-Datenabfrage zu lesen.
Dies ist die SDMX 2.1-REST-Anforderung für Daten:
https://<api_base_uri>/sdmx/2.1/<resource>/<flowRef>/<key>?<parameters> |
In jedem Abschnitt dieser Seite werden die Filter erläutert, die in dieser Syntaxdefinition festgelegt werden können.
SDMX 2.1 - REST - Datenfilterung auf Dimension
Anfordern |
Der Schlüssel ist als eine Punkt ('.') Getrennte Liste von dimensionsgefilterten Werten aufgebaut.
Um den Schlüssel zu erstellen:
Rufen Sie die Liste Liste der Datenflüsse ab, um einen relevanten Datenfluss zu ermitteln.
Dann laden Sie die Datenstruktur mit Referenzen Auflösung für Kinder für den relevanten Datenfluss und überprüfen Sie die Liste der Dimensionen.
Jede Dimension unterstützt Werte, die von der Codelistendefinition festgelegt wurden.
Zum Beispiel listet die Datenstrukturdefinition für NAMA_10_GDP 4 Dimensionen in dieser Reihenfolge auf:
FREQ mit Werten, die durch die Codeliste FREQ festgelegt wurden
UNIT mit Werten, die in der Codeliste UNIT festgelegt sind
INDIC_NA mit Werten, die durch die Codeliste INDIC_NA festgelegt wurden
GEO mit Werten, die durch die Codeliste GEO festgelegt wurden
Für NAMA_10_GDP kann der Schlüssel [FREQ].[UNIT].[INDIC_NA].[GEO] in der exakten Reihenfolge der durch die Datenstrukturdefinition festgelegten Dimensionen zum Beispiel A.CP_MEUR.B1GQQ.LU, wobei:
Position | 1 | 2 | 3 | 4 |
---|---|---|---|---|
Abmessungen | FREQ | UNIT | INDIC_NA | GEO |
Key Schlüsselwert | A | CP_MEUR | B1GQ | LU |
Bedeutung | Daten aggregiert jährlich | Aktuelle Preise, Millionen Euro | Bruttoinlandsprodukt zu Marktpreisen | Luxemburg |
Dimensionen, die nicht gefiltert werden sollen, bleiben in der Abfrage leer. Für NAMA_10_GDP kann der Schlüssel ohne Filter für die Dimension FREQ .CP_MEUR.B1GQ.LU sein.
Die logische Konjunktion wird mit dem Pluszeichen "+" erstellt. Für NAMA_10_GDP kann der Schlüssel A.CP_MEUR.B1GQ.BE+LU sein.
SDMX 2.1 - REST - Datenfilterung pünktlich
Dies ermöglicht das Filtern von Datenbeobachtungen innerhalb einer Zeitreihe am Start- und Enddatum.
Anfordern |
Der Beginn und das Ende des Zeitraums im Filter werden als startPeriod und endPeriod festgelegt. Folgende Zeiträume werden unterstützt:
In der folgenden Tabelle steht "YYYY" für das Kalenderjahr, dargestellt in 4 Ziffern. Beispiel: 2018
Zeitraum | Format |
---|---|
Jährlich | YYYY-A1 oder YYYY |
Semester | YYYY-S[1-2] |
Viertel | YYYY-Q[1-4] |
Monatlich | YYYY-M[01-12] oder JJJJ-[01-12] |
Wöchentlich | YYYY-W[01-53] |
Täglich | YYYY-D[001-366] |
Jahresintervall | YYYY / P[01-99] Y |
wie dargestellt durch
Filterung der jährlichen Beobachtungen von NAMA_10_GDP von 2012 bis 2015 |
SDMX 2.1 - REST - Datenfilterung bei ersten N und letzten N Beobachtungen
Dies ermöglicht das Filtern von Datenbeobachtungen innerhalb einer Zeitreihe, um die Anzahl der zurückgegebenen Beobachtungen zu begrenzen.
Anfordern |
Dieser Filter kann auf Daten angewendet werden, die nach Dimension und / oder Zeit gefiltert wurden.
Erste N Beobachtungen geben die ersten N Beobachtungen in der entsprechenden Serie zurück
Letzte N Beobachtungen geben die letzten N Beobachtungen in der entsprechenden Serie zurück
Beide Definitionen können z.B. um die erste und letzte Beobachtung in einer Serie zurückzugeben.
Wenn der Filter falsch ist, wird eine Antwort ohne Beobachtungsergebnisse zurückgegeben.
Filtern auf NAMA_10_GDP für die letzten 5 jährlichen Beobachtungen |
SDMX 2.1 - REST - Daten Details
Anfordern |
wie dargestellt durch
NAMA_10_GDP nur mit Daten |
SDMX 2.1 - REST - Datenfilterung basierend auf der NUTS-Klassifikation
Die Filterung auf NUTS-Ebene kann für regionale Datensätze durchgeführt werden. Datensätze mit Codewerten, die in der GEO-Dimension länger als 2 sind.
Wenn der Filter auf nicht regionale Datensätze angewendet wird, enthält die Abfrageantwort alle Werte in der GEO-Dimension mit Ausnahme der Länder.
Dies ermöglicht das Filtern nach GEO-Dimensionen basierend auf NUTS-2016-Klassifikation auf verschiedenen Ebenen. Weitere Informationen finden Sie auf dieser Seite.
Anfordern |