Changelog

PyPI History

2.34.0 (2025-10-28)

Features

• Add support for Python 3.14 ( bd0f5422aa8d817e936f556ce33c0e96b5d02874 )

Bug Fixes

• Deprecate credentials_file argument ( bd0f5422aa8d817e936f556ce33c0e96b5d02874 )

• Require grpcio >= 1.33.2 ( bd0f5422aa8d817e936f556ce33c0e96b5d02874 )

• Require grpcio >= 1.75.1 for Python 3.14 ( bd0f5422aa8d817e936f556ce33c0e96b5d02874 )

2.33.1 (2025-09-08)

Bug Fixes

• deps:Exclude google-auth 2.24.0 and 2.25.0 ( 5b60dd4 )

• deps:Require google-api-core >= 1.34.1 ( 5b60dd4 )

• deps:Require proto-plus >= 1.22.3 ( 5b60dd4 )

2.33.0 (2025-09-02)

Features

• Add support for CMEK, runtime controls, and PSC-I to Reasoning Engine protos ( #968 ) ( e2082ff )

• Add support for Python 3.13 ( #964 ) ( 6e2c94f )

2.32.0 (2025-05-27)

Features

• Add BigQuery Metastore Partition Service API version v1beta ( #941 ) ( fa8c533 )

Bug Fixes

• Separate create_stream() in pyarrow sample ( #946 ) ( 127e70c )

2.31.0 (2025-04-22)

Features

• v1alpha:Increased the number of partitions can be written in a single request ( 1f2ed7e )

Documentation

• v1alpha:Updated the number of partitions (from 100 to 900) that can be inserted, updated and deleted in a single request ( 1f2ed7e )

2.30.0 (2025-03-25)

Features

• Link stream to use _Connection ( #901 ) ( 28e0529 )

• Sample for AppendRowsStream with Arrow ( #915 ) ( a6df546 )

Bug Fixes

• Remove setup.cfg configuration for creating universal wheels ( #913 ) ( a1fa1c7 )

2.29.1 (2025-03-13)

Bug Fixes

• Correct user agent header to track calls as veneer instead of gapic ( #909 ) ( eabe4ba )

2.29.0 (2025-03-11)

Features

• Add Connection class ( #888 ) ( 8d342ee )

• Add REST Interceptors which support reading metadata ( #884 ) ( 50a37af )

Bug Fixes

• Allow protobuf 6.x ( #905 ) ( 54e4802 )

2.28.0 (2025-01-28)

Features

• Add support for opt-in debug logging ( #855 ) ( 405f776 )

Bug Fixes

• Add response object to any append rows requests exception ( #838 ) ( 04867c6 )

• deps:Update proto-plus to >=1.25 for Python 3.13 compatibility ( #865 ) ( bed5210 ), closes #842

• Disable universe-domain validation ( #839 ) ( 4662b39 )

2.27.0 (2024-10-14)

Features

• Add experimental ArrowData type and arrow_data field within AppendRowsRequest ( #837 ) ( 03a99ff )

Bug Fixes

• Increase method timeout to 240s for BigQuery Metastore Partition Service API version v1alpha ( #830 ) ( 826a23f )

2.26.0 (2024-09-04)

Features

• v1alpha:Add BigQuery Metastore Partition Service API ( 6ba2796 )

Bug Fixes

• Allow protobuf 5.x; require protobuf >=3.20.2 ( #808 ) ( 0a644e3 )

2.25.0 (2024-05-01)

Features

• Add ability to request compressed ReadRowsResponse rows ( #728 ) ( fe09e3b )

• Add client side lib id with lib version ( #760 ) ( 05664dc )

• Add include_recaptcha_script for as a new action in firewall policies ( #753 ) ( 0d2c013 )

• Add stream write samples for range ( #780 ) ( 27dbbc2 )

• Add support for proto3 optional tag ( #727 ) ( 3b9724a )

• Add the RANGE type to the google.cloud.bigquery.storage.v1.TableFieldSchema ( #746 ) ( 47f6b05 )

• Allow users to explicitly configure universe domain ( #737 ) ( 44feef7 )

Bug Fixes

• Add google-auth as a direct dependency ( #740 ) ( 4942bd1 )

• Export handwritten classes AppendRowsStream and ReadRowsStream ( #770 ) ( 198c312 )

• Fix ValueError in test__validate_universe_domain ( #743 ) ( 9d8ad7e )

• main:Clarify importlib import ( #738 ) ( 04efdbd )

• Make read_session no longer DEPRECATED ( #765 ) ( a3168f4 )

• Missing export BigQueryWriteClient ( #754 ) ( 2600532 )

• Resolve AttributeError ‘Credentials’ object has no attribute ‘universe_domain’ ( #739 ) ( ea4c1f4 )

• Use triple equal for pinned requirements ( #769 ) ( d746c3c )

Documentation

• Mark BigQueryWrite v1beta2 as deprecated ( #750 ) ( 201ae3e )

2.24.0 (2023-12-12)

Features

• Add support for Python 3.12 ( 4834ed1 )

• Introduce compatibility with native namespace packages ( #706 ) ( 59f9564 )

Bug Fixes

• Use retry_async instead of retry in async client ( #713 ) ( 4e18437 )

2.23.0 (2023-11-17)

Features

• Add default_missing_value_interpretation field; indicate KMS_SERVICE_ERROR is retryable ( #637 ) ( 9550ea6 )

Bug Fixes

• Do not set BidiRpc to None when closing it ( #698 ) ( 7921561 )

• samples:Catch EOFError in quickstart ( #708 ) ( 1683879 )

Documentation

• Minor formatting ( cbde9a6 )

2.22.0 (2023-07-06)

Features

• Add ResourceExhausted to retryable error for Write API unary calls ( aebe9d1 )

Documentation

• Add multiplexing documentation ( aebe9d1 )

2.21.0 (2023-07-04)

Features

• Add estimated physical file sizes to ReadAPI v1 ( #605 ) ( ad342fe )

Bug Fixes

• Add async context manager return types ( #610 ) ( e7069d1 )

2.20.0 (2023-05-25)

Features

• Add storage error codes for KMS ( ff1f064 )

• Add table sampling to ReadAPI ( ff1f064 )

2.19.1 (2023-03-23)

Documentation

• Fix formatting of request arg in docstring ( #586 ) ( 76c4f0f )

2.19.0 (2023-03-01)

Features

• Add default_value_expression to TableFieldSchema ( #571 ) ( 277ed54 )

2.18.1 (2023-01-20)

Bug Fixes

• Add context manager return types ( ec04714 )

Documentation

• Add documentation for enums ( ec04714 )

2.18.0 (2023-01-10)

Features

• Add support for python 3.11 ( #547 ) ( 7201f67 )

2.17.0 (2022-12-14)

Features

• Add estimated number of rows to CreateReadSession response ( #542 ) ( 16c19a4 )

• Add missing_value_interpretations to AppendRowsRequest ( #529 ) ( 2ba8bae )

Bug Fixes

• deps:Require google-api-core >=1.34.0, >=2.11.0 ( 5e2fc1e )

• Drop usage of pkg_resources ( 5e2fc1e )

• Fix timeout default values ( 5e2fc1e )

Documentation

• samples:Snippetgen should call await on the operation coroutine before calling result ( 5e2fc1e )

2.16.2 (2022-10-07)

Bug Fixes

• deps:Allow protobuf 3.19.5 ( #522 ) ( cbe3fef )

2.16.1 (2022-09-29)

Bug Fixes

• deps:Require protobuf >= 3.20.2 ( #517 ) ( 53d72c7 )

2.16.0 (2022-09-19)

Features

• Add location to WriteStream and add WriteStreamView support ( #507 ) ( 20371ef )

• add proto annotation for non-ascii field mapping ( 7eba58c )

2.15.0 (2022-09-06)

Features

• Allow users to set Apache Avro output format options through avro_serialization_options param in TableReadOptions message ( #490 ) ( 0c1264d )

2.14.2 (2022-08-12)

Bug Fixes

• deps:allow protobuf < 5.0.0 ( #486 ) ( e96a352 )

• deps:drop freezegun dependency in extras ( #481 ) ( 7ba7953 )

• deps:require proto-plus >= 1.22.0 ( e96a352 )

Documentation

• clarify size limitations for AppendRowsRequest ( #474 ) ( 7132617 )

2.14.1 (2022-07-13)

Bug Fixes

• deps:require google-api-core>=1.32.0,>=2.8.0 ( #469 ) ( 42f7a0d )

2.14.0 (2022-07-08)

Features

• add audience parameter ( 346c719 )

• add fields to eventually contain row level errors ( 346c719 )

Bug Fixes

• deps:require google-api-core >= 2.8.0 ( 346c719 )

• handle AttributeError in bigquery_storage writer ( #414 ) ( 2cb641a )

• Modify client lib retry policy for CreateWriteStream with longer backoff, more error code and longer overall time ( 346c719 )

• require python 3.7+ ( #468 ) ( c13b1e5 )

2.13.2 (2022-06-06)

Bug Fixes

• deps:require protobuf <4.0.0dev ( #456 ) ( b5e7719 )

Documentation

• fix changelog header to consistent size ( #457 ) ( 143dac9 )

2.13.1 (2022-04-04)

Bug Fixes

• Deprecate format specific row_count field in Read API ( #424 ) ( d52dbba )

2.13.0 (2022-03-07)

Features

• expose additional StorageError enum values ( 4657e2f )

• update default timeout/retry information ( 4657e2f )

• update parent annotation for BatchCommitWriteStreamsRequest ( 4657e2f )

Bug Fixes

• deps:require google-api-core>=1.31.5, >=2.3.2 ( #404 ) ( 99f51e0 )

Documentation

• improve documentation for write client ( #403 ) ( 4657e2f )

2.12.0 (2022-02-22)

Features

• add api key support ( #387 ) ( 5e7b502 )

• add trace_id for Read API ( #396 ) ( 5d7f918 )

Bug Fixes

• remove bigquery.readonly auth scope ( #394 ) ( e08d2fd )

• remove libcst as a required dependency ( #389 ) ( 92b503a )

• resolve DuplicateCredentialArgs error when using credentials_file ( 16520e3 )

Documentation

• add generated snippets ( e08d2fd )

2.11.0 (2022-01-12)

Features

• add write_mode property to BigQuery Storage Write API v1 ( #360 ) ( aa9740d )

• retryable resource exhausted handling ( #366 ) ( 33757d8 )

2.10.1 (2021-11-11)

Documentation

• show that Python 3.9 and 3.10 are supported in classifiers ( #351 ) ( 1faa16f )

2.10.0 (2021-11-05)

Features

• add context manager support in client ( #328 ) ( afcf3dc )

Bug Fixes

• deps:drop packaging dependency ( 5390146 )

• deps:require google-api-core >= 1.28.0 ( 5390146 )

Documentation

• list oneofs in docstring ( 5390146 )

2.9.1 (2021-10-06)

Documentation

• samples:Add minimal sample to show Write API in pending mode ( #322 ) ( db51469 )

2.9.0 (2021-09-27)

Features

• add AppendRowsStream to use write API from v1 endpoint ( #309 ) ( 9fc3c08 )

• add BigQuery Storage Write API v1 ( #301 ) ( 69e3fb8 )

Bug Fixes

• add ‘dict’ annotation type to ‘request’ ( a778080 )

• add missing read api retry setting on SplitReadStream ( #311 ) ( 66c09c0 )

• avoid failure if closing AppendRowsStream before opening ( #304 ) ( 9f145f8 )

• avoid opening write stream more than once, make open method private ( #305 ) ( 58ec844 )

2.8.0 (2021-09-10)

Features

• add AppendRowsStream helper to append rows with a BigQueryWriteClient ( #284 ) ( 2461f63 )

2.7.0 (2021-09-02)

Features

• v1beta2:Align ReadRows timeout with other versions of the API ( #293 ) ( 43e36a1 )

Documentation

• v1beta2:Align session length with public documentation ( 43e36a1 )

2.6.3 (2021-08-06)

Bug Fixes

• resume read stream on Unknown transport-layer exception ( #263 ) ( 127caa0 )

2.6.2 (2021-07-28)

Bug Fixes

• enable self signed jwt for grpc ( #249 ) ( a7e8d91 )

Documentation

• remove duplicate code samples ( #246 ) ( 303f273 )

• add Samples section to CONTRIBUTING.rst ( #241 ) ( 5d02358 )

2.6.1 (2021-07-20)

Bug Fixes

• deps:pin ‘google-{api,cloud}-core’, ‘google-auth’ to allow 2.x versions ( #240 ) ( 8f848e1 )

Documentation

• pandas DataFrame samples are more standalone ( #224 ) ( 4026997 )

2.6.0 (2021-07-09)

Features

• read_session optional to ReadRowsStream.rows() ( #228 ) ( 4f56029 )

• add always_use_jwt_access ( #223 ) ( fd82417 )

2.5.0 (2021-06-29)

⚠ BREAKING CHANGES

• remove default deadline for AppendRows API (#205)

Features

• Add ZSTD compression as an option for Arrow ( #197 ) ( f941446 )

• new JSON type through BigQuery Write ( #178 ) ( a6d6afa )

Bug Fixes

• deps:add packaging requirement ( #200 ) ( f2203fe )

• remove default deadline for AppendRows API ( #205 ) ( cd4e637 )

Documentation

• omit mention of Python 2.7 in ‘CONTRIBUTING.rst’ ( #1127 ) ( #212 ) ( 8bcc4cd )

Miscellaneous Chores

• release 2.5.0 ( #220 ) ( 946c8a9 )

2.4.0 (2021-04-07)

Features

• add a Arrow compression options (Only LZ4 for now) ( #166 ) ( 1c91a27 )

• updates for v1beta2 storage API - Updated comments on BatchCommitWriteStreams - Added new support Bigquery types BIGNUMERIC and INTERVAL to TableSchema - Added read rows schema in ReadRowsResponse - Misc comment updates ( #172 ) ( bef63fb )

Dependencies

• update minimum pandas to 0.21.1 ( #165 ) ( 8a97763 )

2.3.0 (2021-02-18)

Features

• add client_cert_source_for_mtls argument to transports ( #135 ) ( 072850d )

Documentation

• update python contributing guide ( #140 ) ( 1671056 )

2.2.1 (2021-01-25)

Documentation

• remove required session variable to fix publish ( #124 ) ( 19a105c )

2.2.0 (2021-01-22)

Features

• add clients for v1beta2 endpoint ( #113 ) ( e5f6198 )

• add manual wrapper for v1beta2 read client ( #117 ) ( 798cd34 )

Bug Fixes

• skip some system tests for mtls testing ( #106 ) ( 89ba292 )

Documentation

• add note about Arrow blocks to README ( #73 ) ( d9691f1 )

• request only a single stream in dataframe example ( #114 ) ( 3518624 )

2.1.0 (2020-11-04)

Features

• add public transport property and path formatting methods to client ( #80 ) ( fbbb439 )

Documentation

• add intersphinx to proto-plus library ( #86 ) ( 4cd35d2 )

• show inheritance in types reference ( #91 ) ( e5fd4e6 )

2.0.1 (2020-10-21)

Bug Fixes

• don’t fail with 429 when downloading wide tables ( #79 ) ( 45faf97 )

Documentation

• update to_dataframe sample to latest dependencies ( #72 ) ( a7fe762 )

2.0.0

09-24-2020 08:21 PDT

Implementation Changes

• Transition the library to microgenerator. ( #62 ) This is a breaking changethat introduces several method signature changesand drops support for Python 2.7 and 3.5. See migration guide for more info.

1.1.0

09-14-2020 08:51 PDT

Implementation Changes

• Change default retry policies timeouts (via synth). ( #53 )

New Features

• Add resource path helper methods. ( #40 )

Documentation

• Move code samples from the common samples repo to this library. ( #50 )

• Fix read_rows() docstring sample. ( #44 )

Internal / Testing Changes

• Update CODEOWNERS for samples and library code. ( #56 )

• Update language of py2 admonition, add 3.8 unit tests. ( #45 )

• Install google-cloud-testutils (via synth). ( #26 )

1.0.0 (2020-06-04)

Bug Fixes

• handle consuming streams with no data ( #29 ) ( 56d1b1f )

• update pyarrow references that are warning ( #31 ) ( 5302481 )

0.8.0 (2020-03-03)

Features

• add manual layer for v1 endpoint ( #16 ) ( a0fc0af )

• update synth to generate v1beta2, v1 endpoints for bigquerystorage ( #10 ) ( 2ea5ac4 )

Bug Fixes

• bigquerystorage:resume reader connection on EOS internal error ( #9994 ) ( acbd57f )

• bigquerystorage:to_dataframe on an arrow stream uses 2x faster to_arrow + to_pandas, internally ( #9997 ) ( fdfb21e )

• pass snapshot_millis to the main function ( #8 ) ( e522bf8 )

0.7.0

07-31-2019 17:48 PDT

New Features

• Support faster Arrow data format in to_dataframe and to_arrow when using BigQuery Storage API. ( #8551 )

Dependencies

• Bump minimum version for google-api-core to 1.14.0. ( #8709 )

• Update pins of ‘googleapis-common-protos. ( #8688 )

Documentation

• Update quickstart sample with data format and sharding options. ( #8665 )

• Fix links to bigquery storage documentation. ( #8859 )

• Link to googleapis.dev documentation in READMEs. ( #8705 )

• Add compatibility check badges to READMEs. ( #8288 )

Internal / Testing Changes

• Pin black version. (via synth). ( #8672 )

0.6.0

07-11-2019 13:15 PDT

New Features

• Add to_arrow with support for Arrow data format. ( #8644 )

• Add ‘client_options’ support (via synth). ( #8536 )

• Add sharding strategy, stream splitting, Arrow support (via synth). ( #8477 )

Documentation

• Add docs job to publish to googleapis.dev. ( #8464 )

Internal / Testing Changes

• Allow kwargs to be passed to create_channel (via synth). ( #8441 )

• Add encoding declaration to protoc-generated files (via synth). ( #8345 )

• Refactor reader.ReadRowsPage to use _StreamParser . ( #8262 )

• Fix coverage in ‘types.py’ (via synth). ( #8148 )

• Add empty lines, remove coverage exclusions (via synth). ( #8051 )

0.5.0

05-20-2019 09:23 PDT

Implementation Changes

• Increase default deadline on ReadRows. ( #8030 )

• Respect timeout on client.read_rows . Don’t resume on DEADLINE_EXCEEDED errors. ( #8025 )

Documentation

• Use alabaster theme everwhere. ( #8021 )

0.4.0

04-16-2019 13:46 PDT

Implementation Changes

• Remove gRPC size limit in the transport options ( #7664 )

• Add retry params for create_read_session (via synth). ( #7658 )

New Features

• Add page iterator to ReadRowsStream ( #7680 )

Internal / Testing Changes

• Remove system test for split rows ( #7673 )

0.3.0

04-02-2019 15:22 PDT

Dependencies

• Add dependency for resource proto. ( #7585 )

• Remove classifier for Python 3.4 for end-of-life. ( #7535 )

Documentation

• Fix links to BigQuery Storage API docs ( #7647 )

• Update proto / docstrings (via synth). ( #7461 )

• googlecloudplatform –> googleapis in READMEs ( #7411 )

• Updated client library documentation URLs. ( #7307 )

• Blacken new quickstart snippet. ( #7242 )

• Add quickstart demonstrating most BQ Storage API read features ( #7223 )

• Add bigquery_storage to docs ( #7222 )

Internal / Testing Changes

• Add protos as an artifact to library ( #7205 )

• Copy lintified proto files (via synth). ( #7475 )

• Add annotations to protocol buffers indicating request parameters (via synth). ( #7550 )

0.2.0

01-25-2019 13:54 PST

New Features

• Add option to choose dtypes by column in to_dataframe. ( #7126 )

Internal / Testing Changes

• Update copyright headers

• Protoc-generated serialization update. ( #7076 )

• BigQuery Storage: run ‘blacken’ during synth ( #7047 )

0.1.1

12-17-2018 18:03 PST

Implementation Changes

• Import iam.policy from google.api_core . ( #6741 )

• Pick up fixes in GAPIC generator. ( #6708 )

Documentation

• Document Python 2 deprecation ( #6910 )

Internal / Testing Changes

• Blacken all gen’d libs ( #6792 )

• Correct release_status for bigquery_storage ( #6767 )

0.1.0

11-29-2018 13:45 PST

• Initial release of BigQuery Storage API client.