Registry / gcp / google-cloud-biglake

google-cloud-biglake

library0.5.0pypypi✓ verified 83d ago

The `google-cloud-biglake` library provides a Python client for interacting with the Google Cloud BigLake API. BigLake allows you to unify data lakes and warehouses, enabling a consistent management plane and access control for data stored in various formats across Google Cloud (e.g., Cloud Storage) and other clouds. It is currently in a 0.x.x version, indicating early access or preview, and is part of the larger `googleapis/google-cloud-python` monorepo, receiving updates as the underlying API evolves.

gcp data

pip install google-cloud-biglake

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · GOOGLE-CLOUD-BIGLA

google-cloud-biglake

gcppythonv0.5.0

Install

5.6s avg

Import

—

Disk

66MB

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.5.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.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 68.1MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 5.6s · import 0.000s · 66MB

66MB installed

● package 66MB

Code

Verified usage

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

BigLakeServiceClient

✓ from google.cloud import biglake_v1

✗ from google.cloud.biglake_v1 import BigLakeServiceClient

This quickstart demonstrates how to initialize the BigLakeServiceClient and list existing BigLake catalogs within a specified Google Cloud project and location. It assumes you have Application Default Credentials (ADC) configured or `GOOGLE_APPLICATION_CREDENTIALS` environment variable set.

import os from google.cloud.biglake_v1 import BigLakeServiceClient # Set your Google Cloud Project ID and Location # You can also set GOOGLE_CLOUD_PROJECT environment variable project_id = os.environ.get('GCP_PROJECT_ID', 'your-project-id') location = os.environ.get('GCP_LOCATION', 'us-central1') # e.g., 'us-central1', 'europe-west1' if project_id == 'your-project-id' or location == 'us-central1': print("Please set GCP_PROJECT_ID and GCP_LOCATION environment variables or replace placeholders.") exit() client = BigLakeServiceClient() # Construct the parent path for listing catalogs # The parent must be in the format: projects/{project}/locations/{location} parent_path = f"projects/{project_id}/locations/{location}" try: # List BigLake catalogs within the specified project and location print(f"Listing BigLake catalogs in {parent_path}:") for catalog in client.list_catalogs(parent=parent_path): print(f" Catalog: {catalog.name}") except Exception as e: print(f"An error occurred: {e}") print("Ensure BigLake API is enabled and your service account has 'biglake.catalogs.list' permission.")

Debug

Known issues

gotchaThe library is in a 0.x.x version, meaning the API surface might not be fully stable. Breaking changes may occur in minor versions until a 1.0.0 release. Always pin to specific patch versions (e.g., `google-cloud-biglake==0.3.0`) in production environments.

fix

Pin to specific patch versions in your `requirements.txt` or `pyproject.toml` to prevent unexpected breaking changes: `google-cloud-biglake==0.3.0`.

affects: <1.0.0

gotchaGoogle Cloud BigLake resources (catalogs, databases, tables) require specific permission roles for access. Common issues arise from missing 'BigLake Admin' (roles/biglake.admin) or 'BigLake Viewer' (roles/biglake.viewer) permissions on the project or specific resources.

fix

Ensure the service account or user running the code has the necessary BigLake IAM roles assigned at the project or resource level via the Google Cloud Console or `gcloud iam` commands.

affects: All

gotchaBigLake API methods often require resource names in a specific string format (e.g., `projects/{project}/locations/{location}/catalogs/{catalog}`). Incorrectly formatted resource paths will result in `google.api_core.exceptions.InvalidArgument` errors.

fix

Always construct resource paths using the `client.catalog_path`, `client.database_path`, or `client.table_path` methods, or carefully follow the documented string format for each API call.

affects: All

Upgrade

Version history

0.5.0latest on PyPI · released Jun 12, 2026

Audit

Dependencies

google-api-core[grpc]requiredCore Google API client functionality, including gRPC for communication.

protobufrequiredUsed for serializing and deserializing structured data.

Agent activity

14 hits · last 30 days

node

OpenAI (training)

Resources

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

packagehttps://pypi.org/project/google-cloud-biglake/ ↗

homepagehttps://cloud.google.com/biglake ↗