Send feedback
Module client (3.36.0) Stay organized with collections
Save and categorize content based on your preferences.
Version latest keyboard_arrow_down
Client for interacting with the Google BigQuery API.
Classes
Client
(
project
:
typing
.
Optional
[
str
]
=
None
,
credentials
:
typing
.
Optional
[
google
.
auth
.
credentials
.
Credentials
]
=
None
,
_http
:
typing
.
Optional
[
requests
.
sessions
.
Session
]
=
None
,
location
:
typing
.
Optional
[
str
]
=
None
,
default_query_job_config
:
typing
.
Optional
[
google
.
cloud
.
bigquery
.
job
.
query
.
QueryJobConfig
]
=
None
,
default_load_job_config
:
typing
.
Optional
[
google
.
cloud
.
bigquery
.
job
.
load
.
LoadJobConfig
]
=
None
,
client_info
:
typing
.
Optional
[
google
.
api_core
.
client_info
.
ClientInfo
]
=
None
,
client_options
:
typing
.
Optional
[
typing
.
Union
[
google
.
api_core
.
client_options
.
ClientOptions
,
typing
.
Dict
[
str
,
typing
.
Any
]
]
]
=
None
,
default_job_creation_mode
:
typing
.
Optional
[
str
]
=
None
,
)
Client to bundle configuration needed for API requests.
project
Optional[str]
Project ID for the project which the client acts on behalf of. Will be passed when creating a dataset / job. If not passed, falls back to the default inferred from the environment.
credentials
Optional[google.auth.credentials.Credentials]
The OAuth2 Credentials to use for this client. If not passed (and if no _http
object is passed), falls back to the default inferred from the environment.
_http
Optional[requests.Session]
HTTP object to make requests. Can be any object that defines request()
with the same interface as requests.Session.request
. If not passed, an _http
object is created that is bound to the credentials
for the current object. This parameter should be considered private, and could change in the future.
location
Optional[str]
Default location for jobs / datasets / tables.
client_info
Optional[google.api_core.client_info.ClientInfo]
The client info used to send a user-agent string along with API requests. If None
, then default info will be used. Generally, you only need to set this if you're developing your own library or partner tool.
client_options
Optional[Union[google.api_core.client_options.ClientOptions, Dict]]
Client options used to set user options on the client. API Endpoint should be set through client_options.
default_job_creation_mode
Optional[str]
Sets the default job creation mode used by query methods such as query_and_wait(). For lightweight queries, JOB_CREATION_OPTIONAL is generally recommended.
google.auth.exceptions.DefaultCredentialsError
Raised if credentials
is not specified and the library fails to acquire default credentials.
Project
(
project_id
,
numeric_id
,
friendly_name
)
Wrapper for resource describing a BigQuery project.
project_id
str
Opaque ID of the project
numeric_id
int
Numeric ID of the project
friendly_name
str
Display name of the project
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-04 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Module client (3.36.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.36.0 (latest)](/python/docs/reference/bigquery/latest/google.cloud.bigquery.client)\n- [3.35.1](/python/docs/reference/bigquery/3.35.1/google.cloud.bigquery.client)\n- [3.34.0](/python/docs/reference/bigquery/3.34.0/google.cloud.bigquery.client)\n- [3.33.0](/python/docs/reference/bigquery/3.33.0/google.cloud.bigquery.client)\n- [3.31.0](/python/docs/reference/bigquery/3.31.0/google.cloud.bigquery.client)\n- [3.30.0](/python/docs/reference/bigquery/3.30.0/google.cloud.bigquery.client)\n- [3.29.0](/python/docs/reference/bigquery/3.29.0/google.cloud.bigquery.client)\n- [3.27.0](/python/docs/reference/bigquery/3.27.0/google.cloud.bigquery.client)\n- [3.26.0](/python/docs/reference/bigquery/3.26.0/google.cloud.bigquery.client)\n- [3.25.0](/python/docs/reference/bigquery/3.25.0/google.cloud.bigquery.client)\n- [3.24.0](/python/docs/reference/bigquery/3.24.0/google.cloud.bigquery.client)\n- [3.23.1](/python/docs/reference/bigquery/3.23.1/google.cloud.bigquery.client)\n- [3.22.0](/python/docs/reference/bigquery/3.22.0/google.cloud.bigquery.client)\n- [3.21.0](/python/docs/reference/bigquery/3.21.0/google.cloud.bigquery.client)\n- [3.20.1](/python/docs/reference/bigquery/3.20.1/google.cloud.bigquery.client)\n- [3.19.0](/python/docs/reference/bigquery/3.19.0/google.cloud.bigquery.client)\n- [3.18.0](/python/docs/reference/bigquery/3.18.0/google.cloud.bigquery.client)\n- [3.17.2](/python/docs/reference/bigquery/3.17.2/google.cloud.bigquery.client)\n- [3.16.0](/python/docs/reference/bigquery/3.16.0/google.cloud.bigquery.client)\n- [3.15.0](/python/docs/reference/bigquery/3.15.0/google.cloud.bigquery.client)\n- [3.14.1](/python/docs/reference/bigquery/3.14.1/google.cloud.bigquery.client)\n- [3.13.0](/python/docs/reference/bigquery/3.13.0/google.cloud.bigquery.client)\n- [3.12.0](/python/docs/reference/bigquery/3.12.0/google.cloud.bigquery.client)\n- [3.11.4](/python/docs/reference/bigquery/3.11.4/google.cloud.bigquery.client)\n- [3.4.0](/python/docs/reference/bigquery/3.4.0/google.cloud.bigquery.client)\n- [3.3.6](/python/docs/reference/bigquery/3.3.6/google.cloud.bigquery.client)\n- [3.2.0](/python/docs/reference/bigquery/3.2.0/google.cloud.bigquery.client)\n- [3.1.0](/python/docs/reference/bigquery/3.1.0/google.cloud.bigquery.client)\n- [3.0.1](/python/docs/reference/bigquery/3.0.1/google.cloud.bigquery.client)\n- [2.34.4](/python/docs/reference/bigquery/2.34.4/google.cloud.bigquery.client)\n- [2.33.0](/python/docs/reference/bigquery/2.33.0/google.cloud.bigquery.client)\n- [2.32.0](/python/docs/reference/bigquery/2.32.0/google.cloud.bigquery.client)\n- [2.31.0](/python/docs/reference/bigquery/2.31.0/google.cloud.bigquery.client)\n- [2.30.1](/python/docs/reference/bigquery/2.30.1/google.cloud.bigquery.client)\n- [2.29.0](/python/docs/reference/bigquery/2.29.0/google.cloud.bigquery.client)\n- [2.28.1](/python/docs/reference/bigquery/2.28.1/google.cloud.bigquery.client)\n- [2.27.1](/python/docs/reference/bigquery/2.27.1/google.cloud.bigquery.client)\n- [2.26.0](/python/docs/reference/bigquery/2.26.0/google.cloud.bigquery.client)\n- [2.25.2](/python/docs/reference/bigquery/2.25.2/google.cloud.bigquery.client)\n- [2.24.1](/python/docs/reference/bigquery/2.24.1/google.cloud.bigquery.client)\n- [2.23.3](/python/docs/reference/bigquery/2.23.3/google.cloud.bigquery.client)\n- [2.22.1](/python/docs/reference/bigquery/2.22.1/google.cloud.bigquery.client)\n- [2.21.0](/python/docs/reference/bigquery/2.21.0/google.cloud.bigquery.client)\n- [2.20.0](/python/docs/reference/bigquery/2.20.0/google.cloud.bigquery.client)\n- [2.19.0](/python/docs/reference/bigquery/2.19.0/google.cloud.bigquery.client)\n- [2.18.0](/python/docs/reference/bigquery/2.18.0/google.cloud.bigquery.client)\n- [2.17.0](/python/docs/reference/bigquery/2.17.0/google.cloud.bigquery.client)\n- [2.16.1](/python/docs/reference/bigquery/2.16.1/google.cloud.bigquery.client)\n- [2.15.0](/python/docs/reference/bigquery/2.15.0/google.cloud.bigquery.client)\n- [2.14.0](/python/docs/reference/bigquery/2.14.0/google.cloud.bigquery.client)\n- [2.13.1](/python/docs/reference/bigquery/2.13.1/google.cloud.bigquery.client)\n- [2.12.0](/python/docs/reference/bigquery/2.12.0/google.cloud.bigquery.client)\n- [2.11.0](/python/docs/reference/bigquery/2.11.0/google.cloud.bigquery.client)\n- [2.10.0](/python/docs/reference/bigquery/2.10.0/google.cloud.bigquery.client)\n- [2.9.0](/python/docs/reference/bigquery/2.9.0/google.cloud.bigquery.client)\n- [2.8.0](/python/docs/reference/bigquery/2.8.0/google.cloud.bigquery.client)\n- [2.7.0](/python/docs/reference/bigquery/2.7.0/google.cloud.bigquery.client)\n- [2.6.2](/python/docs/reference/bigquery/2.6.2/google.cloud.bigquery.client)\n- [2.5.0](/python/docs/reference/bigquery/2.5.0/google.cloud.bigquery.client)\n- [2.4.0](/python/docs/reference/bigquery/2.4.0/google.cloud.bigquery.client)\n- [2.3.1](/python/docs/reference/bigquery/2.3.1/google.cloud.bigquery.client)\n- [2.2.0](/python/docs/reference/bigquery/2.2.0/google.cloud.bigquery.client)\n- [2.1.0](/python/docs/reference/bigquery/2.1.0/google.cloud.bigquery.client)\n- [2.0.0](/python/docs/reference/bigquery/2.0.0/google.cloud.bigquery.client)\n- [1.28.2](/python/docs/reference/bigquery/1.28.2/google.cloud.bigquery.client)\n- [1.27.2](/python/docs/reference/bigquery/1.27.2/google.cloud.bigquery.client)\n- [1.26.1](/python/docs/reference/bigquery/1.26.1/google.cloud.bigquery.client)\n- [1.25.0](/python/docs/reference/bigquery/1.25.0/google.cloud.bigquery.client)\n- [1.24.0](/python/docs/reference/bigquery/1.24.0/google.cloud.bigquery.client)\n- [1.23.1](/python/docs/reference/bigquery/1.23.1/google.cloud.bigquery.client)\n- [1.22.0](/python/docs/reference/bigquery/1.22.0/google.cloud.bigquery.client)\n- [1.21.0](/python/docs/reference/bigquery/1.21.0/google.cloud.bigquery.client)\n- [1.20.0](/python/docs/reference/bigquery/1.20.0/google.cloud.bigquery.client)\n- [1.19.0](/python/docs/reference/bigquery/1.19.0/google.cloud.bigquery.client)\n- [1.18.0](/python/docs/reference/bigquery/1.18.0/google.cloud.bigquery.client)\n- [1.17.0](/python/docs/reference/bigquery/1.17.0/google.cloud.bigquery.client)\n- [1.16.0](/python/docs/reference/bigquery/1.16.0/google.cloud.bigquery.client) \nClient for interacting with the Google BigQuery API.\n\nClasses\n-------\n\n### [Client](/python/docs/reference/bigquery/latest/google.cloud.bigquery.client.Client)\n\n Client(\n project: typing.Optional[str] = None,\n credentials: typing.Optional[google.auth.credentials.Credentials] = None,\n _http: typing.Optional[requests.sessions.Session] = None,\n location: typing.Optional[str] = None,\n default_query_job_config: typing.Optional[\n google.cloud.bigquery.job.query.QueryJobConfig\n ] = None,\n default_load_job_config: typing.Optional[\n google.cloud.bigquery.job.load.LoadJobConfig\n ] = None,\n client_info: typing.Optional[google.api_core.client_info.ClientInfo] = None,\n client_options: typing.Optional[\n typing.Union[\n google.api_core.client_options.ClientOptions, typing.Dict[str, typing.Any]\n ]\n ] = None,\n default_job_creation_mode: typing.Optional[str] = None,\n )\n\nClient to bundle configuration needed for API requests.\n\n### [Project](/python/docs/reference/bigquery/latest/google.cloud.bigquery.client.Project)\n\n Project(project_id, numeric_id, friendly_name)\n\nWrapper for resource describing a BigQuery project."]]
