Skip to content

Ingesting Data

How to ingest data into OSDU at Equinor.

graph LR A[1. Entitlements]:::step --> B[2. Legal Tags]:::step B --> C[3. LRA Tags]:::step C --> D[4. Technical Assurance]:::step D --> E[Ready to ingest]:::done classDef step fill:#e3f2fd,stroke:#1565c0 classDef done fill:#e8f5e9,stroke:#2e7d32

Read first

Every developer should read the Schema Usage Guide before adding any data to OSDU.

Before you start

  1. The Data Owner must have agreed to the data being added
  2. There must be an LRA covering the usage of the data
  3. Entitlements, LRA tags, legal tag, and technical assurance tag must all be set when you add the data — not left empty for later

Checklist

Every record you ingest must have all of these set:

  • ACL viewer group assigned (based on data type)
  • ACL owner group assigned (your Data Producer group)
  • Legal tag with country of origin
  • LRA tags from the LRA Data Inventory
  • Technical assurance tag (at minimum "Unevaluated")

Step 1: Entitlements

Every record needs a viewer ACL (who can read) and an owner ACL (who can write).

Viewer ACL — depends on data type
Data type Viewer ACL
Reference / Master Data data.office.global.viewers
Work Product Components (Internal) data.office.<country>.viewers and data.office.<asset>.viewers
Restricted Data Custom ACL — work with the Data Office to define

See Data Office Groups for the full list of viewer groups.

Owner ACL — your Data Producer group

Use the data.***.owners group your team has been assigned to (e.g. data.masterdata.owners).

See Data Producer Groups for the full list.

See Entitlements (ACL) for the JSON format.

Use the simplified legal tag format and change the country accordingly. See Legal Tags for the JSON format.

Step 3: LRA tags

LRA identifies, describes, and classifies risks related to data and information. Read more about LRA.

See Record Tags for the full list of required tags.

How to find the right LRA

LRAs are in the LRA Data Inventory.

Example: Creating a record of kind osdu:wks:master-data--Wellbore:1.3.0 from SMDA Wellheader:

Step 1: Filter the LRA Data Inventory by source system:

Filter Example

Step 2: Find an LRA for a data model that approximates your OSDU schema kind. For wellbore from SMDA, use LRA ID 0205 — Wellheader data:

Filtered Options

Step 3: If multiple Data IDs exist, inspect each one. Data ID 0526 covers Brazil as country of origin:

LRA Wellheader Brazil

Step 4: Check the Data Classification tab:

Data Classification

See Record Tags for the resulting tag values.

Step 4: Technical assurance

Always add at minimum the "Unevaluated" tag when ingesting data. This tells users the quality has not been evaluated. You can upgrade this later.

See Record Tags for the JSON format, reference values, and a full example.

How it fits together

Each step above maps to a section of the OSDU record:

graph TD R[OSDU Record]:::record --> ACL[acl]:::step R --> LEGAL[legal]:::step R --> TAGS[tags]:::step R --> DATA[data]:::step ACL --> V[Viewer groups — Step 1]:::detail ACL --> O[Owner groups — Step 1]:::detail LEGAL --> LT[Legal tag + country — Step 2]:::detail TAGS --> LRA[LRA tags — Step 3]:::detail DATA --> TA[Technical assurance — Step 4]:::detail classDef record fill:#f5f5f5,stroke:#616161 classDef step fill:#e3f2fd,stroke:#1565c0 classDef detail fill:#fff3e0,stroke:#e65100

Example

Full record ready for ingestion — wellbore from SMDA (Brazil)

Below is a full record that brings together all the required metadata: entitlements, legal tag, LRA tags, and technical assurance.

{
    "kind": "osdu:wks:master-data--Wellbore:1.3.0",
    "acl": {
        "viewers": [
            "data.office.global.viewer@equinorswe.dataservices.energy"
        ],
        "owners": [
            "data.masterdata.owners@equinorswe.dataservices.energy"
        ]
    },
    "legal": {
        "legaltags": [
            "equinor-data-equinor-osdu-reference-default"
        ],
        "otherRelevantDataCountries": [
            "BR"
        ],
        "status": "compliant"
    },
    "tags": {
        "lra.dataID": "0526",
        "lra.securityClassification": "Internal",
        "lra.exportControl": "No",
        "lra.inside": "No",
        "lra.businessCriticalData": "No",
        "lra.soxCriticalData": "No",
        "lra.personalData": "No",
        "lra.intellectualPropertyRight": "Not assessed yet",
        "lra.countryOfOrigin": "Brazil",
        "lra.sourceSystem": "SMDA",
        "lra.legalOwnership": "Equinor solely"
    },
    "data": {
        "FacilityName": "My Wellbore",
        "WellID": "equinorswe:master-data--Well:some-well-uuid:",
        "TechnicalAssurances": [
            {
                "TechnicalAssuranceTypeID": "namespace:reference-data--TechnicalAssuranceType:Unevaluated:"
            }
        ]
    }
}

Each section of this record is documented in detail:

Last update: 2026-02-27