Glossar

Begriffe der Regionaldatenbank Deutschland und das Vokabular, das diese CLI verwendet. Die Datenbank läuft auf der Software GENESIS: Statistiken bestehen aus Datenquadern, die in Tabellen aufbereitet und durch Merkmale und deren Ausprägungen beschrieben werden – und fast alles hat hier zusätzlich eine regionale Dimension, die bis auf Kreis- und Gemeindeebene reicht.

Objekte

Begriff GENESIS Bedeutung
Statistik statistic Ein vollständiges statistisches Produkt, identifiziert über einen fünfstelligen EVAS-Code (z. B. 12411, „Fortschreibung des Bevölkerungsstandes“). Enthält Datenquader.
Tabelle table Eine fertige zweidimensionale Ansicht mit einem Code wie 12411-01-01-4. Das, was Sie hauptsächlich abrufen.
Datenquader cube Die mehrdimensionalen Rohdaten hinter den Tabellen.
Zeitreihe timeseries Ein Datenquader, reduziert auf einen einzelnen Wert im Zeitverlauf.
Merkmal variable Eine Dimension bzw. ein Attribut (z. B. KREISE = Kreise und kreisfreie Städte, GES = Geschlecht).
Ausprägung value Ein konkreter Wert eines Merkmals (z. B. ein bestimmter Kreis).
Ergebnistabelle result Eine von einem asynchronen Job erzeugte Tabelle, gespeichert in Ihrem Nutzerbereich.

Codes und Auswahl

Regionalschlüssel und Ebenen

Die Antworthülle

Jede Antwort außer von helloworld steckt in einer Hülle:

Feld Bedeutung
Ident { Service, Method } – welcher Endpoint geantwortet hat.
Status { Code, Content, Type } – das logische Ergebnis (siehe unten).
Parameter Echo Ihrer Anfrage (Zugangsdaten maskiert als ********).
Copyright der anzugebende Quellenvermerk – siehe DATA_LICENSE.md.
List Katalogergebnisse (ein homogenes Array).
Object Nutzdaten für Daten und Metadaten (nicht näher typisiert; bei data/table ein CSV-String in Object.Content).

helloworld/whoami und helloworld/logincheck verwenden diese Hülle nicht – ebenso wenig Authentifizierungsfehler, die als bloßes { Code, Content, Type }-Objekt ankommen (siehe unten).

Werte von Status.Code

Die meisten logischen Ergebnisse kommen mit HTTP 200; Authentifizierungsfehler liefern dieselbe Struktur mit 401/404:

Code Typ Bedeutung Diese CLI
0 Information Erfolg liefert Daten
22 Warnung Erfolg, ein Parameter wurde automatisch korrigiert liefert Daten (Warnung in Status.Content sichtbar)
50 Information keine neueren Daten (bei --stand) liefert Daten
104 Information kein Objekt gefunden, das passt liefert ein leeres Ergebnis (Exit 0)
90 Fehler angefordertes Objekt nicht gefunden Fehler, Exit 4
98 Information Ergebnis zu groß für einen direkten Abruf Fehler mit Hinweisen zum Eingrenzen, Exit 1
15 ERROR nicht autorisiert (keine oder nicht erkannte Zugangsdaten; flacher Body bei HTTP 401) Fehler + Hinweis zu den Zugangsdaten, Exit 1
2 ERROR falscher Benutzername oder falsches Passwort (flacher Body bei HTTP 404 – kein fehlendes Objekt!) Fehler, Exit 1
beliebig Fehler / Error allgemeiner Fehler Fehler, Exit 1

Platzhalter für den Wertstatus

In einer CSV aus data/table kann eine Zelle statt einer Zahl ein Statuszeichen enthalten: - (nichts vorhanden / tatsächlich null), . (unbekannt oder geheim – auf Gemeindeebene wegen der statistischen Geheimhaltung häufig), ... (noch nicht verfügbar), / (keine Angabe, da Zahlenwert nicht sicher genug), x (keine sinnvolle Aussage möglich), () (eingeschränkter Aussagewert), p (vorläufig), r (berichtigt), s (geschätzt).

Begriffe zur Authentifizierung

Wie Zugangsdaten übertragen werden und warum Weiterleitungen nicht gefolgt wird, beschreibt DEVELOPING.md (englisch).

Quelle auf GitHub ansehen →