Function bootstrap_namespace

misc/python/materialize/biglake.py:189–203

Ensure the catalog and namespace for ``gs:// `` exist. Mints a token from ``service_account``, ensures the BigLake catalog for the bucket exists, resolves the warehouse prefix, and creates ``namespace`` if it is missing. Idempotent: a no-op once the catalog and namespace exist. R

(service_account: dict, bucket: str, namespace: str)

def bootstrap_namespace(service_account: dict, bucket: str, namespace: str) -> str:
    """Ensure the catalog and namespace for ``gs://<bucket>`` exist.

    Mints a token from ``service_account``, ensures the BigLake catalog for the
    bucket exists, resolves the warehouse prefix, and creates ``namespace`` if it
    is missing. Idempotent: a no-op once the catalog and namespace exist. Returns
    the resolved catalog prefix.
    """
    project = service_account["project_id"]
    token = mint_gcp_access_token(service_account)
    ensure_catalog(token, project, bucket)
    prefix = resolve_warehouse_prefix(token, project, bucket)
    create_namespace(token, project, prefix, namespace)
    print(f"BigLake namespace ready: {namespace} (gs://{bucket})")
    return prefix