Entities and their describing Schemas (Kinds of Data) are the heart of a data ecosystem.
- Summary Presentation
- WKE, WKS and Enrichment - Explained
- Comparing OSDU and OpenDES Schema - Recommendations
Schema (or JSON Schema)
Schema is a structure of the data, defined in JSON format and follows the spec https://json-schema.org/specification-links.html#draft-7. Each entity defined in the system is described exactly by one schema.
In addition to describing the data attributes of the entity, the schema also describes additional metadata such as legal tags, ACLs, common attributes are required to fully quality a entity in the OSDU system
A unique identifier (or a tag) given to the schema, such that from the identifier it is relatively easy to infer the entity it describes. Such that kind
osdu:ihs:well:1.0.0 may relate to a schema defining well headers that are provided by IHS and defined (authored) by osdu data definition subcommittee. It is a recommended that there exists a service or web server that hosts the schema of all type and each type can be retrieved by specificing it's kind. Such as
Schema also plays an important role, as the information present in the schema definitions can serve as a index schema for search engines
A record or instance of a data item that follows the schema of its
Well Known Schema (WKS)
Same as schema, except when there is an interest to map different schema from different sources, into a canonical model. Subsequently such a common model is promoted as the first class citizen to search and consume. WKS can be defined as needed for a given implementation, with OSDU providing the first set of such known schema for known types handled inside the OSDU Data Platform.
Well Known Entities (WKE)
Instances of WKS, just how the Entity is an instance of Kind. In addition to being on the common model, duplicates in data are also expected to be resolved by designating them as WKE. For example, a well data can be mastered/enriched from more than one sources of information and enriched to remove redundant & duplicate entries. Such a resulting set of data are known as Well Known Entities.
WKE, WKS and Enrichment - Explained
Comparing OSDU and OpenDES Schema - Recommendations
Please refer to Comparing OSDU & OpenDES Schema Semantics on guidance of how the two models can be mapped as one going forward.