Class LoadJob (3.34.0)

LoadJob(job_id,source_uris,destination,client,job_config=None)

Asynchronous job for loading data into a table.

Can load from Google Cloud Storage URIs or from a file.

Parameters

NameDescription
job_idstr

the job's ID

source_urisOptional[Sequence[str]]

URIs of one or more data files to be loaded. Seehttps://cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationLoad.FIELDS.source_uris for supported URI formats. Pass None for jobs that load from a file.

destinationgoogle.cloud.bigquery.table.TableReference

reference to table into which data is to be loaded.

clientgoogle.cloud.bigquery.client.Client

A client which holds credentials and project configuration for the dataset (which requires a project).

Properties

allow_jagged_rows

allow_quoted_newlines

autodetect

clustering_fields

configuration

The configuration for this load job.

connection_properties

Seeconnection_properties.

.. versionadded:: 3.7.0

create_disposition

create_session

Seecreate_session.

.. versionadded:: 3.7.0

destination

destination_encryption_configuration

google.cloud.bigquery.encryption_configuration.EncryptionConfiguration: Customencryption configuration for the destination table.

Custom encryption configuration (e.g., Cloud KMS keys)or :data:None if using default encryption.

Seedestination_encryption_configuration.

destination_table_description

destination_table_friendly_name

encoding

field_delimiter

ignore_unknown_values

input_file_bytes

Count of bytes loaded from source files.

Exceptions
TypeDescription
ValueErrorfor invalid value types.
Returns
TypeDescription
Optional[int]the count (None until set from the server).

input_files

Count of source files.

Returns
TypeDescription
Optional[int]the count (None until set from the server).

max_bad_records

null_marker

output_bytes

Count of bytes saved to destination table.

Returns
TypeDescription
Optional[int]the count (None until set from the server).

output_rows

Count of rows saved to destination table.

Returns
TypeDescription
Optional[int]the count (None until set from the server).

quote_character

range_partitioning

reference_file_schema_uri

See:attr:<xref uid="google.cloud.bigquery.job.LoadJobConfig.reference_file_schema_uri">google.cloud.bigquery.job.LoadJobConfig.reference_file_schema_uri</xref>.

schema

Seeschema.

schema_update_options

skip_leading_rows

source_format

source_uris

Optional[Sequence[str]]: URIs of data files to be loaded. Seehttps://cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationLoad.FIELDS.source_urisfor supported URI formats. None for jobs that load from a file.

time_partitioning

use_avro_logical_types

write_disposition

Methods

from_api_repr

from_api_repr(resource:dict,client)->google.cloud.bigquery.job.load.LoadJob
Parameters
NameDescription
resourceDict

dataset job representation returned from the API

clientgoogle.cloud.bigquery.client.Client

Client which holds credentials and project configuration for the dataset.

Returns
TypeDescription
google.cloud.bigquery.job.LoadJobJob parsed fromresource.

to_api_repr

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 2026-01-09 UTC.