BigQuery regional endpoints

This page describes how you can usePrivate Service Connect regionalendpointsto access resources in BigQuery. Regional endpoints letyou run your workloads in a manner that complies withdataresidency and data sovereigntyrequirements, where your request traffic is routed directly to the regionspecified in the endpoint.

Overview

Regional endpoints are request endpoints that help restrict requests to proceedonly if the affected resource exists in the location specified by the endpoint.For example, if you use the endpointhttps://bigquery.us-central1.rep.googleapis.com in a delete datasetrequest, then the request only proceeds if the dataset is located inUS-CENTRAL1.

Unlike global endpoints, where requests can be routed through a differentlocation from where the resource resides, regional endpoints can help torestrict your requests to the location specified by the endpoint where theresource resides. Regional endpoints terminate TLS sessions in the locationspecified by the endpoint for requests received from the Internet, otherGoogle Cloud resources (such as Compute Engine virtual machines), on-premiseservices using VPN or Interconnect, and Virtual Private Clouds (VPCs).

Regional endpoints help to ensure data residency by keeping your at-rest andin-transit table data within the location specified by the endpoint. Thisexcludes resource metadata, such as dataset names andIAM policies. For more information, seeNote on servicedata.

BigQuery includes multiple APIs. The following APIs are availablefor use with regional endpoint:

APIURLReference
BigQuery APIbigquery.LOCATION.rep.googleapis.comREST
BigQuery Storage APIbigquerystorage.LOCATION.rep.googleapis.comRPC
BigQuery Reservations APIbigqueryreservation.LOCATION.rep.googleapis.comRPC andREST
BigQuery Migration APIbigquerymigration.LOCATION.rep.googleapis.comREST
BigQuery Data Transfer Service APIbigquerydatatransfer.LOCATION.rep.googleapis.comRPC andREST

Supported locations

You can use regional endpoints to keep your data within the following locations:

  • Asia-Pacific

    • Delhiasia-south2
    • Mumbaiasia-south1
  • Europe

    • Belgiumeurope-west1
    • Frankfurteurope-west3
    • Londoneurope-west2
    • Milaneurope-west8
    • Pariseurope-west9
    • Züricheurope-west6
  • Middle East

    • Dammamme-central2
  • United States

    • Iowaus-central1
    • South Carolinaus-east1
    • Northern Virginiaus-east4
    • Columbus, Ohious-east5
    • Dallasus-south1
    • Oregonus-west1
    • Los Angelesus-west2
    • Salt Lake Cityus-west3
    • Las Vegasus-west4

Supported operations

Regional endpoints can only be used to perform operations that access or mutateresources stored in the location specified by the endpoint.Regional endpoints cannot be used to perform operations that access or mutateresources outside of the location specified by the endpoint.

For example, when you use the regional endpointhttps://bigquery.us-central1.rep.googleapis.com, you can read tables indatasets located inUS-CENTRAL1, and copy a table from a source dataset to adestination dataset only when both datasets are located inUS-CENTRAL1. If youattempt to read or copy a table from outsideUS-CENTRAL1, you get anerror.

Limitations and restrictions

Regional endpoints cannot be used to perform the following operations:

  • Operations that access or mutate resources outside of the location specifiedby the endpoint
  • Copying, replicating, or rewriting resources from one location to another.

Keep in mind the following restrictions when using regional endpoints:

Tools for using regional endpoints

Console

To access BigQuery resources in a manner that's compliant withdata residency or sovereignty requirements, use the jurisdictionalGoogle Cloud console URLs:

ResourceURL
Dataset list for a projecthttps://console.JURISDICTION.cloud.google.com/bigquery?project=PROJECT_ID
Table list for a datasethttps://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables
Details for a tablehttps://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables/TABLE_NAME

ReplaceJURISDICTION with one of the followingvalues:

  • eu if the resource is located in the European Union
  • sa if the resource is located in the Kingdom of Saudi Arabia
  • us if the resource is located in the United States
Note: You cannot use the jurisdictional Google Cloud console to upload files ineu,sa, orus.

Command line

To configure the Google Cloud CLI for use with regional endpoints,complete the following steps:

  1. Make sure you're using the Google Cloud CLI 402.0.0 or newer.

  2. Set theapi_endpoint_overrides/bigquery property to the regionalendpoint you want to use:

    gcloud config set api_endpoint_overrides/bigquery https://bigquery.LOCATION.rep.googleapis.com/bigquery/v2/

    Alternatively, you can set theCLOUDSDK_API_ENDPOINT_OVERRIDES_BIGQUERY environment variable to theendpoint:

    CLOUDSDK_API_ENDPOINT_OVERRIDES_BIGQUERY=https://bigquery.LOCATION.rep.googleapis.com/bigquery/v2/ gcloud  alpha bq  datasets list

REST APIs

For REST API, instead of sending a REST request to aservice endpoint, send therequest to the regional endpoint in the following format:https://bigquery.LOCATION.rep.googleapis.com.

Restrict global API endpoint usage

To help enforce the use of regional endpoints, use theconstraints/gcp.restrictEndpointUsage organization policy constraint to blockrequests to the global API endpoint. For more information, seeRestricting endpoint usage.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-15 UTC.