In-depth practical guides

Read an SDMX series without losing its dimensions

Identify the structure, codes and attributes of a statistical extract before comparing values.

Updated :

Do two values actually describe the same series?

SDMX supports statistical data and metadata exchange. An isolated value does not identify its population, unit or observation status. The producer’s structure explains the codes; a response format cannot replace that reading.

  1. Find the flow and structure

    Record agency, flow identifier and structure version. An omitted version may select the latest; retain the structure actually used.

  2. Break down the key

    Read dimensions in their documented order and consult code lists. Frequency, territory, unit or adjustment can change a series’ meaning.

  3. Keep attributes

    Retain unit, multiplier and status at their attachment level. Do not turn missing or provisional observations into final results.

  4. Freeze the extract

    Record full request, filters, period, Accept header, download time and raw file. Compare keys before numbers.

Situations and decisions

Typical situations for preparing a check. They do not describe completed assignments or actual observations.

Different units

In a fictional example, unit and thousand-unit tables show 120 and 0.120. The multiplier explains the difference; no economic change is established.

Open frequency filter

An illustrative request returns annual and monthly series. Separate keys rather than treating every row as one timeline.

Record to retain

  • Flow, agency and version
  • Structure and code lists
  • Full keys and filters
  • Attributes, raw file and extraction date

Official references

Related source profiles

Related protocols

Checks before reaching a conclusion

  • Are all dimensions retained?
  • Are units and multipliers explicit?
  • Are observation attributes preserved?
  • Can the period filter be reproduced?

An extract linking each observation to its key, unit and status.

Frequently asked questions

Can a key be interpreted from its segments alone?

No. Their order and meaning come from the flow structure. The same short code can occur in different lists.

Does a CSV archive the request?

It retains values but may omit parameters or metadata. Store the request and relevant structures alongside the file.

TOOLS / REGISTERS

Write a record

Record full request, filters, period, Accept header, download time and raw file. Compare keys before numbers.

  • Access date and time zone
  • Exact URL
  • Dataset / series code
  • Dimensions / filters
  • Unit / calculation basis
  • Reference period
  • Version / revision
  • Observed status
  • Method / definition
  • Limit / uncertainty
  • Decision / next action
  • Review owner
  • Next review