Collibra Integration

Collibra Integration#

Generate ODCS files from Collibra data catalog assets.

Overview#

The Collibra integration extracts metadata from Collibra assets and generates ODCS v3.1.0 compliant YAML files.

Features#

  • ✅ Automatic metadata extraction via REST API

  • ✅ Column discovery through asset relations

  • ✅ Data type mapping (logical and physical)

  • ✅ Classification support via GraphQL API

  • ✅ Tag integration at asset and column levels

  • ✅ Custom attribute preservation

Installation#

pip install -e .

Configuration#

Environment Variables#

export COLLIBRA_URL="https://your-instance.collibra.com"
export COLLIBRA_USERNAME="your_username"
export COLLIBRA_PASSWORD="your_password"

Required Permissions#

  • Read access to assets

  • Read access to attributes

  • Read access to relations

  • Access to GraphQL API

  • Read access to tags

Usage#

Command Line#

python -m wxdi.odcs_generator.generate_odcs_from_collibra <asset_id>

With options:

python -m wxdi.odcs_generator.generate_odcs_from_collibra <asset_id> \
  --output my-contract.yaml \
  --url https://collibra.com \
  --username myuser \
  --password mypass

Python API#

from wxdi.odcs_generator.generate_odcs_from_collibra import CollibraClient, ODCSGenerator

# Initialize client
client = CollibraClient(
    base_url="https://your-instance.collibra.com",
    username="your_username",
    password="your_password"
)

# Create generator
generator = ODCSGenerator(client)

# Generate ODCS
odcs_data = generator.generate_odcs("asset-id")

# Save to file
generator.save_to_yaml(odcs_data, "output.yaml")

See Also#