About data contract creation and maintenance

The data contract is a key component of a data product. It defines the agreement between the data product owner and the data consumers. The data contract specifies the structure, format, service level, quality, and terms of use. It includes a high-level overview of the agreement and a data contract manifest. A data contract manifest is a YAML file that contains the definitions and contents of a data contract. Multiple versions of the manifest can exist.
For more information, go to About data contracts.

Available tools to create and maintain data contracts

To create, maintain, and show data contracts and their details, Collibra offers a set of tools. These tools are optimized for the Open Data Contract Standard, an open-source framework that describes what is expected in a data contract manifest file. Collibra provides:

  • In-product features to create, manage, and view the data contracts and manifests.

  • CLIs and API calls to create, maintain, and integrate data contracts and manifests.

Data Contract SLA mappings

The following out-of-the-box SLA (Service Level Agreement) asset attributes are mapped to the manifest file. These attributes are used by Collibra to generate a manifest file and are updated with manifest data when you use the apply API command.

Collibra asset attribute Manifest property

Backup Frequency

 backupFrequency
Latency latency
Most Recent Record Date mostRecentRecordDate

Processing Frequency

 processingFrequency

Processing Method

 processingMethod

Recency

 recency

Recovery Point

 recoveryPoint

Recovery Time

 recoveryTime

Response Time

 responseTime

Retention Period

 retentionPeriod

Support Availability

 supportAvailability

Unlimited Retention

 isRetentionUnlimited

Uptime Percentage

 uptimePercentage

When mapping manifest file data to Collibra only manifest file data with titlecase (camelCase) property names are mapped to Data Contract asset attributes. If the manifest property includes a unit, both the value and the unit are combined in the Data Contract attribute.

Example For the following manifest data, the resulting Retention Period attribute value in Collibra will be 5 months.
slaProperties:
	- property: retentionPeriod
	value: 5
	unit: months

Variations in the manifest, such as retentionperiod or retention_period won't be mapped.

Related topics

Helpful resources