Class BigQueryOptions (1.16.0)

BigQueryOptions(
    credentials: typing.Optional[google.auth.credentials.Credentials] = None,
    project: typing.Optional[str] = None,
    location: typing.Optional[str] = None,
    bq_connection: typing.Optional[str] = None,
    use_regional_endpoints: bool = False,
    application_name: typing.Optional[str] = None,
    kms_key_name: typing.Optional[str] = None,
    skip_bq_connection_check: bool = False,
    *,
    ordering_mode: typing.Literal["strict", "partial"] = "strict"
)

Encapsulates configuration for working with a session.

Properties

application_name

The application name to amend to the user-agent sent to Google APIs.

The application name to amend to the user agent sent to Google APIs. The recommended format is "application-name/major.minor.patch_version" or "(gpn:PartnerName;)" for official Google partners.

bq_connection

Name of the BigQuery connection to use in the form <PROJECT_NUMBER/PROJECT_ID>.

You either need to create the connection in a location of your choice, or you need the Project Admin IAM role to enable the service to create the connection for you.

If this option isn't available, or the project or location isn't provided, then the default connection project/location/connection_id is used in the session.

If this option isn't provided, or project or location aren't provided, session will use its default project/location/connection_id as default connection.

credentials

The OAuth2 credentials to use for this client.

kms_key_name

Customer managed encryption key used to control encryption of the data-at-rest in BigQuery. This is of the format projects/PROJECT_ID/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY.

For more information, see https://cloud.google.com/bigquery/docs/customer-managed-encryption Customer-managed Cloud KMS keys

Make sure the project used for Bigquery DataFrames has the Cloud KMS CryptoKey Encrypter/Decrypter IAM role in the key's project. For more information, see https://cloud.google.com/bigquery/docs/customer-managed-encryption#assign_role Assign the Encrypter/Decrypter.

location

Default location for job, datasets, and tables.

For more information, see https://cloud.google.com/bigquery/docs/locations BigQuery locations.

ordering_mode

Controls whether total row order is always maintained for DataFrame/Series.

project

Google Cloud project ID to use for billing and as the default project.

skip_bq_connection_check

Forcibly use the BigQuery connection.

Setting this flag to True would avoid creating the BigQuery connection and checking or setting IAM permissions on it. So if the BigQuery connection (default or user-provided) does not exist, or it does not have necessary permissions set up to support BigQuery DataFrames operations, then a runtime error will be reported.

use_regional_endpoints

Flag to connect to regional API endpoints.

Requires that location is set. For example, to connect to asia-northeast1-bigquery.googleapis.com, specify location='asia-northeast1' and use_regional_endpoints=True.