Registry / gcp / google-cloud-datacatalog-lineage

google-cloud-datacatalog-lineage

library0.7.0pypypi✓ verified 84d ago

The `google-cloud-datacatalog-lineage` client library allows Python developers to interact with the Google Cloud Datacatalog Lineage API. This API helps track the origin and transformation of data within Google Cloud, providing visibility into data pipelines. The current version is 0.6.0, and it follows Google Cloud's frequent release cadence for client libraries, often aligning with underlying API changes or bug fixes.

gcp data

pip install google-cloud-datacatalog-lineage

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · GOOGLE-CLOUD-DATAC

google-cloud-datacatalog-lineage

gcppythonv0.7.0

Install

5.3s avg

Import

1776ms

Disk

67MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.7.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

installs and imports cleanly · install 0.0s · import 2.037s · 68.7MB

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 5.3s · import 1.515s · 66MB

67MB installed

● package 67MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

LineageClient

✓ from google.cloud import datacatalog_lineage_v1

✗ from google.cloud import datacatalog_lineage

The official client for the Datacatalog Lineage API is exposed through the versioned module `datacatalog_lineage_v1`, not the base `datacatalog_lineage` module.

This quickstart demonstrates how to initialize the `LineageClient` and list data lineage processes within a specified Google Cloud project and location. It includes basic error handling and emphasizes proper project ID and authentication setup.

import os from google.cloud import datacatalog_lineage_v1 # Ensure GOOGLE_APPLICATION_CREDENTIALS is set, or running in a GCP environment. # For local development, set GOOGLE_APPLICATION_CREDENTIALS environment variable: # export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/keyfile.json" # Replace with your actual GCP project ID and desired location project_id = os.environ.get("GCP_PROJECT_ID", "your-gcp-project-id") location = "us-central1" # e.g., "us-central1", "europe-west1" try: client = datacatalog_lineage_v1.LineageClient() parent = f"projects/{project_id}/locations/{location}" print(f"Listing processes in {parent}...") # The list_processes method returns an iterable for process in client.list_processes(parent=parent): print(f"Found Process: {process.name}") print("Successfully listed processes (or completed iteration if none found).") except Exception as e: print(f"An error occurred: {e}") print("Ensure 'GCP_PROJECT_ID' environment variable is set or replace placeholder.") print("Ensure `google-cloud-datacatalog-lineage` is installed and authenticated.")

Debug

Known issues

breakingThe library is currently in version 0.x.x, indicating that the API surface may not be fully stable and could introduce breaking changes in minor versions without a major version bump. Always review release notes when upgrading.

fix

Always pin to a specific minor version (e.g., `google-cloud-datacatalog-lineage==0.6.*`) and test thoroughly before deploying new versions to production. Consult release notes for any breaking changes.

affects: 0.x.x (all versions before 1.0.0)

gotchaIncorrect or missing Google Cloud authentication credentials will lead to `DefaultCredentialsError` or `PermissionDenied` errors when making API calls.

fix

Ensure `GOOGLE_APPLICATION_CREDENTIALS` environment variable points to a valid service account key file, or run your application in a Google Cloud environment (e.g., GCE, Cloud Run, GKE) with appropriate permissions configured for the default service account.

affects: All versions

gotchaList operations (e.g., `list_processes`, `list_runs`) return iterators. If you need all results in a single list, you must explicitly convert the iterator to a list or iterate through it.

fix

To get all items at once, use `list(client.list_processes(...))` or iterate directly: `for item in client.list_processes(...): ...`.

affects: All versions

gotchaThe library requires Python 3.9 or newer. Running with older Python versions will result in installation failures or runtime errors.

fix

Ensure your environment uses Python 3.9 or a newer supported version. Upgrade Python if necessary.

affects: <=0.6.0 (and likely future versions)

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'google.cloud.datacatalog_lineage'

Attempting to import the client from an unversioned or incorrect module path.

fix

Change your import statement to `from google.cloud import datacatalog_lineage_v1`.

google.auth.exceptions.DefaultCredentialsError: Could not automatically determine credentials.

The application could not find valid Google Cloud credentials in the environment.

fix

Set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable to the path of your service account key file, or ensure your application is running in a Google Cloud environment with default credentials configured.

google.api_core.exceptions.NotFound: 404 Not Found: Requested entity was not found

The specified project, location, or resource path (e.g., for `parent`) does not exist or is incorrect, or the authenticated principal lacks permission to access it.

fix

Double-check the `project_id`, `location`, and any resource names. Verify that the service account or user has the necessary Data Catalog Lineage Viewer/Editor roles (`roles/datacatalog.viewer`, `roles/datacatalog.editor`) for the project.

Upgrade

Version history

0.7.0latest on PyPI · released Jun 3, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

20 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/googleapis/google-cloud-python ↗

packagehttps://pypi.org/project/google-cloud-datacatalog-lineage/ ↗

homepagehttps://cloud.google.com/data-catalog/docs ↗