---
id: google-cloud-datacatalog-lineage
version: "0.7.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# google-cloud-datacatalog-lineage — Google Cloud Datacatalog Lineage API client library

License: permissive · Maintenance: active · Downloads: 358.9K/mo

## What it is and what it does

This is Google's official Python client for the Cloud Data Lineage API, a service that tracks data flow and transformations across Google Cloud data systems. It provides programmatic access to create, query, and visualize lineage information—showing where data originates, where it flows, and what transformations occur along the way.

The library wraps gRPC and REST endpoints using standard Google Cloud client patterns (google-api-core, google-auth, protobuf). It requires Python 3.10 or later and is maintained as part of the broader google-cloud-python monorepo. Setup requires a Google Cloud project with the Data Lineage API enabled and proper authentication configured. The package is in Beta status and actively maintained, with no known security vulnerabilities.

Use it for:

- Track data lineage for compliance and audit purposes in cloud data warehouses
- Visualize end-to-end data transformations in ETL/ELT pipelines
- Query data provenance to understand dependencies between datasets
- Integrate lineage tracking into data governance and metadata management systems
- Automate lineage documentation for data catalogs and data dictionaries

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for Google Cloud Data Lineage API, enabling programmatic tracking and visualization of data flow, transformations, and lifecycle across cloud data systems.

Yes, if you are working with Google Cloud data systems and need programmatic lineage tracking. The library is actively maintained, has low install friction, carries a permissive license, and integrates naturally with other Google Cloud Python clients. No security vulnerabilities are known. Install only if your project requires Data Lineage API access and you can meet the Python 3.10+ requirement.

## Install

pip install google-cloud-datacatalog-lineage
uv add google-cloud-datacatalog-lineage
poetry add google-cloud-datacatalog-lineage

## Installing google-cloud-datacatalog-lineage

Before you install: Low install friction with a pure Python wheel distribution. Actively maintained as of 72 days ago with recent commits. Depends on standard Google Cloud libraries (google-api-core, google-auth, grpcio, proto-plus, protobuf).

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Quickstart:

pip install google-cloud-datacatalog-lineage

from google.cloud import datacatalog_lineage

client = datacatalog_lineage.LineageClient()
# Use client methods to query or create lineage data

Requires Python >= 3.10 and Google Cloud project with Data Lineage API enabled; authentication via google-auth (typically Application Default Credentials or service account key).

Verify before relying:

- Specific lineage query and mutation capabilities beyond basic client instantiation
- Performance characteristics for large-scale lineage graphs
- Integration patterns with other Google Cloud services (BigQuery, Dataflow, etc.)

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 358.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google cloud data lineage, data flow tracking, data provenance, cloud data catalog lineage, data transformation tracking, data origin and destination, lineage visualization api, google-cloud, data-lineage, metadata-management

[View on SkillFed](https://skillfed.io/packages/google-cloud-datacatalog-lineage) · [View on PyPI](https://pypi.org/project/google-cloud-datacatalog-lineage/)