{"id":1836,"library":"google-cloud-bigquery-biglake","title":"Google Cloud BigQuery BigLake API Client Library","description":"The `google-cloud-bigquery-biglake` library is the Python client for the Google Cloud BigLake API. BigLake serves as a unified storage engine, simplifying data access for data warehouses and data lakes. It offers uniform, fine-grained access control across multi-cloud storage solutions like Google Cloud Storage, Amazon S3, and Azure Data Lake Storage, and supports querying open-source table formats such as Apache Iceberg in BigQuery. This library is part of the larger `google-cloud-python` monorepo, suggesting a consistent release and maintenance cadence aligned with other Google Cloud client libraries.","status":"active","version":"0.7.0","language":"en","source_language":"en","source_url":"https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-bigquery-biglake","tags":["google-cloud","bigquery","biglake","data-lake","analytics","serverless"],"install":[{"cmd":"pip install google-cloud-bigquery-biglake","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"Requires Python version 3.9 or higher.","package":"Python","optional":false}],"imports":[{"symbol":"BigLakeServiceClient","correct":"from google.cloud.bigquery_biglake_v1 import BigLakeServiceClient"}],"quickstart":{"code":"import os\nfrom google.cloud.bigquery_biglake_v1 import BigLakeServiceClient\n\n# Set your Google Cloud Project ID and a location (e.g., 'us-central1')\nproject_id = os.environ.get('GOOGLE_CLOUD_PROJECT', 'your-gcp-project-id')\nlocation = os.environ.get('GOOGLE_CLOUD_LOCATION', 'us-central1')\n\n# Ensure you have authenticated to Google Cloud. For local development, use:\n# gcloud auth application-default login\n\ndef list_biglake_catalogs(project_id: str, location: str):\n    \"\"\"Lists BigLake catalogs in a given project and location.\"\"\"\n    client = BigLakeServiceClient()\n    parent = f\"projects/{project_id}/locations/{location}\"\n\n    print(f\"Listing BigLake catalogs in {parent}:\")\n    try:\n        # The list_catalogs method returns an iterable of Catalog objects\n        for catalog in client.list_catalogs(parent=parent):\n            print(f\"  Catalog: {catalog.name}\")\n    except Exception as e:\n        print(f\"An error occurred: {e}\")\n        print(\"Ensure the BigLake API is enabled for your project and the service account has 'biglake.catalogs.list' permission.\")\n\nif __name__ == \"__main__\":\n    list_biglake_catalogs(project_id, location)","lang":"python","description":"This quickstart demonstrates how to initialize the BigLakeServiceClient and list available BigLake catalogs within a specified Google Cloud project and location. Ensure your `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` environment variables are set or replace the placeholder values. Authentication typically relies on Application Default Credentials."},"warnings":[{"fix":"Consult the `google-cloud-python` monorepo release notes for `google-cloud-bigquery-biglake` prior to upgrading to new minor versions.","message":"The library is currently at version 0.7.0. While API stability is generally high for Google Cloud client libraries, pre-1.0.0 versions may introduce breaking changes in minor releases. Always review release notes when upgrading to new minor versions (e.g., 0.7.x to 0.8.x).","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Enable the BigLake API via the Google Cloud Console or `gcloud services enable biglake.googleapis.com`.","message":"The BigLake API must be explicitly enabled in your Google Cloud project before you can use this client library to interact with BigLake resources.","severity":"gotcha","affected_versions":"All"},{"fix":"Ensure your environment is authenticated correctly. On Google Cloud infrastructure, credentials are often discovered automatically through the attached service account.","message":"Proper authentication is required. For local development, Application Default Credentials (ADC) are recommended, often set up using `gcloud auth application-default login` or by setting the `GOOGLE_APPLICATION_CREDENTIALS` environment variable to a service account key file.","severity":"gotcha","affected_versions":"All"},{"fix":"Configure logging explicitly if needed. You can set the `GOOGLE_SDK_PYTHON_LOGGING_SCOPE` environment variable or use advanced code-based configuration. Be mindful of sensitive data in logs.","message":"The library's logging is not configured by default and may contain sensitive information.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"last_verified":"2026-04-09T00:00:00.000Z","next_check":"2026-07-08T00:00:00.000Z"}