Class BigQueryOptions (1.5.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,
)

Encapsulates configuration for working with a session.

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.

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.

The OAuth2 credentials to use for this client.

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

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.

Default location for job, datasets, and tables.

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

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

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.

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.