You can interact with the Data Contract service through a Command Line Interface (CLI) or through direct API calls.
You can also perform most actions in Collibra. For more information, go to create and maintain data contracts from Collibra.
Data Contract CLI
The Data Contract CLI is a tool that packages API calls into an easy-to-use tool, enabling automation and integration. To use the CLI, you have to set it up and configure it locally. Once the CLI is installed and configured, you can use the commands to create and maintain data contracts.
From the CLI, you can perform the following actions. Detailed information and examples are available in the CLI.
| Action | Definition |
|---|---|
| collibra data-contract init | Initialize a Data Contract asset with an initial manifest. Tip This operation is the first step in creating a new data contract asset and linking it to its initial manifest. You can provide an existing manifest to upload, or a template will be generated from the associated Collibra content if none is provided. Once a data contact has been initialized, you are able to use all other actions on it. |
| collibra data-contract draft | Generate a new manifest draft using Collibra metadata. |
| collibra data-contract push | Upload a new version of a Data Contract manifest to Collibra. |
| collibra data-contract fetch | Retrieve a Data Contract. |
| collibra data-contract list | List all Data Contracts and their metadata. |
| collibra data-contract list-versions | For a Data Contract, list the Data Contract versions and their metadata. |
| collibra data-contract set-active | Set a specific Data Contract version as active. |
| collibra data-contract apply | Apply the active manifest version to the Collibra Knowledge Graph, updating the SLA properties that match existing out-of-the-box attributes on the Data Contract asset. |
| collibra data-contract clear | Permanently deletes all data contract versions and unlinks the Manifest ID from the Data Contract asset. |
| collibra data-contract delete | Permanently deletes a specific data contract manifest version. |
Tip The CLI includes a --help flag to retrieve the built-in reference documentation.
For example: ./collibra data-contract --help
Data Products API
If you prefer working directly with API calls, you don't require the CLI setup. You can use any API tool, such as Postman, cURL, or Insomnia, to interact with the Data Contract service. In that case, you can refer to the API specifications for detailed information on all available endpoints, including those for listing contract metadata, managing versions, and setting the active version.
Tip Initializing a data contract is the first step in creating a new Data Contract asset and linking it to its initial manifest. You can provide an existing manifest to upload, or a template will be generated from the associated Collibra content if none is provided. Once a Data Contact has been initialized, you are able to use all other API calls on it.
- Go to GitHub for the CLI.
- Go to API specifications.