2.58.0-rc1 (2025-12-17)

Features

• Add ability to specify RetryOptions and BigQueryRetryConfig when create job and waitFor (#3398) (1f91ae7)
• add additional parameters to CsvOptions and ParquetOptions (#3370) (34f16fb)
• add columnNameCharacterMap to LoadJobConfiguration (#3356) (2f3cbe3)
• add max staleness to ExternalTableDefinition (#3499) (f1ebd5b)
• add MetadataCacheMode to ExternalTableDefinition (#3351) (2814dc4)
• add remaining Statement Types (#3381) (5f39b19)
• add WRITE_TRUNCATE_DATA as an enum value for write disposition (#3752) (acea61c)
• bigquery: Add custom ExceptionHandler to BigQueryOptions (#3937) (de0914d)
• bigquery: Add OpenTelemetry Samples (#3899) (e3d9ed9)
• bigquery: Add OpenTelemetry support to BQ rpcs (#3860) (e2d23c1)
• bigquery: Add otel metrics to request headers (#3900) (4071e4c)
• bigquery: Add support for custom timezones and timestamps (#3859) (e5467c9)
• bigquery: Add support for reservation field in jobs. (#3768) (3e97f7c)
• bigquery: Implement getArray in BigQueryResultImpl (#3693) (e2a3f2c)
• bigquery: Integrate Otel in client lib (#3747) (6e3e07a)
• bigquery: Integrate Otel into retries, jobs, and more (#3842) (4b28c47)
• bigquery: job creation mode GA (#3804) (a21cde8)
• bigquery: Support Fine Grained ACLs for Datasets (#3803) (bebf1c6)
• bigquery: support IAM conditions in datasets in Java client. (#3602) (6696a9c)
• bigquery: Support resource tags for datasets in java client (#3647) (01e0b74)
• configure rc releases to be on prerelease mode (93700c8)
• Enable Lossless Timestamps in BQ java client lib (#3589) (c0b874a)
• Enable maxTimeTravelHours in BigQuery java client library (#3555) (bd24fd8)
• implement wasNull for BigQueryResultSet (#3650) (c7ef94b)
• introduce java.time methods and variables (#3586) (31fb15f)
• new queryWithTimeout method for customer-side wait (#3995) (9c0df54)
• next release from main branch is 2.49.0 (#3706) (b46a6cc)
• next release from main branch is 2.53.0 (#3879) (c47a062)
• Relax client-side validation for BigQuery entity IDs (#4000) (c3548a2)
• update with latest from main (#4034) (ec447b5)

Bug Fixes

• adapt graalvm config to arrow update (#3928) (ecfabc4)
• add clustering value to ListTables result (#3359) (5d52bc9)
• Add labels to converter for listTables method (#3735) (#3736) (8634822)
• bigquery: Add MY_VIEW_DATASET_NAME_TEST_ to resource clean up sample (#3838) (b1962a7)
• bigquery: Remove ReadAPI bypass in executeSelect() (#3624) (fadd992)
• Close bq read client (#3644) (8833c97)
• executeSelect now use provided credentials instead of GOOGLE_APP… (#3465) (cd82235)
• load jobs preserve ascii control characters configuration (#3876) (5cfdf85)
• next release candidate (d01971e)
• NPE for executeSelect nonFast path with empty result (#3445) (d0d758a)
• NPE when reading BigQueryResultSet from empty tables (#3627) (9a0b05a)
• null field mode inconsistency (#2863) (b9e96e3)
• retry ExceptionHandler not retrying on IOException (#3668) (83245b9)
• test: Force usage of ReadAPI (#3625) (5ca7d4a)
• test: Update schema for broken ConnImplBenchmark test (#3574) (8cf4387)
• Update experimental methods documentation to @internalapi (#3552) (20826f1)

Dependencies

• exclude io.netty:netty-common from org.apache.arrow:arrow-memor… (#3715) (11b5809)
• fix update dependency com.google.cloud:google-cloud-bigquerystorage-bom to v3.17.2 (b25095d)
• remove version declaration of open-telemetry-bom (#3855) (6f9f77d)
• rollback netty.version to v4.1.119.Final (#3827) (94c71a0)
• update actions/checkout action to v4.1.6 (#3309) (c7d6362)
• update actions/checkout action to v4.1.7 (#3349) (0857234)
• update actions/checkout action to v4.2.0 (#3495) (b57fefb)
• update actions/checkout action to v4.2.1 (#3520) (ad8175a)
• update actions/checkout action to v4.2.2 (#3541) (c36c123)
• update actions/upload-artifact action to v4.3.4 (#3382) (efa1aef)
• update actions/upload-artifact action to v4.3.5 (#3420) (d5ec87d)
• update actions/upload-artifact action to v4.3.5 (#3422) (c7d07b3)
• update actions/upload-artifact action to v4.3.5 (#3424) (a9d6869)
• update actions/upload-artifact action to v4.3.5 (#3427) (022eb57)
• update actions/upload-artifact action to v4.3.5 (#3430) (c7aacba)
• update actions/upload-artifact action to v4.3.5 (#3432) (b7e8244)
• update actions/upload-artifact action to v4.3.5 (#3436) (ccefd6e)
• update actions/upload-artifact action to v4.3.5 (#3440) (916fe9a)
• update actions/upload-artifact action to v4.3.5 (#3443) (187f099)
• update actions/upload-artifact action to v4.3.5 (#3444) (04aea5e)
• update actions/upload-artifact action to v4.3.5 (#3449) (c6e93cd)
• update actions/upload-artifact action to v4.3.5 (#3455) (fbfc106)
• update actions/upload-artifact action to v4.3.5 (#3456) (f00977c)
• update actions/upload-artifact action to v4.3.5 (#3462) (e1c6e92)
• update actions/upload-artifact action to v4.3.6 (#3463) (ba91227)
• update actions/upload-artifact action to v4.4.0 (#3467) (08b28c5)
• update actions/upload-artifact action to v4.4.1 (#3521) (dc21975)
• update actions/upload-artifact action to v4.4.2 (#3524) (776a554)
• update actions/upload-artifact action to v4.4.3 (#3530) (2f87fd9)
• update actions/upload-artifact action to v4.5.0 (#3620) (cc25099)
• update actions/upload-artifact action to v4.6.0 (#3633) (ca20aa4)
• update actions/upload-artifact action to v4.6.1 (#3691) (9c0edea)
• update actions/upload-artifact action to v4.6.2 (#3724) (426a59b)
• update actions/upload-artifact action to v4.6.2 (#3724) (483f930)
• update bigquerystorage-bom to 3.20.0-rc1 (#4035) (cb44b5f)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.46.0 (#3328) (a6661ad)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.47.0 (#3342) (79e34c2)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.48.0 (#3374) (45b7f20)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.49.0 (#3417) (66336a8)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.50.0 (#3448) (2c12839)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.51.0 (#3480) (986b036)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.53.0 (#3504) (57ce901)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.54.0 (#3532) (25be311)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.55.0 (#3559) (950ad0c)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.56.0 (#3582) (616ee2a)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.57.0 (#3617) (51370a9)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.58.0 (#3631) (b0ea0d5)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.59.0 (#3660) (3a6228b)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.60.0 (#3680) (6d9a40d)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.61.0 (#3703) (53b07b0)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.62.0 (#3726) (38e004b)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.63.0 (#3770) (934389e)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.65.0 (#3787) (0574ecc)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.66.0 (#3835) (69be5e7)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.68.0 (#3858) (d4ca353)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.69.0 (#3870) (a7f1007)
• update dependency com.google.api.grpc:proto-google-cloud-bigqueryconnection-v1 to v2.70.0 (#3890) (84207e2)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240602-2.0.0 (#3273) (7b7e52b)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240616-2.0.0 (#3368) (ceb270c)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240623-2.0.0 (#3384) (e1de34f)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240629-2.0.0 (#3392) (352562d)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240714-2.0.0 (#3412) (8a48fd1)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240727-2.0.0 (#3421) (91d780b)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240727-2.0.0 (#3423) (16f350c)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240727-2.0.0 (#3428) (9ae6eca)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240803-2.0.0 (#3435) (b4e20db)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240815-2.0.0 (#3454) (8796aee)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240905-2.0.0 (#3483) (a6508a2)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20240919-2.0.0 (#3514) (9fe3829)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20241013-2.0.0 (#3544) (0c42092)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20241027-2.0.0 (#3568) (b5ccfcc)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20241111-2.0.0 (#3591) (3eef3a9)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20241115-2.0.0 (#3601) (41f9adb)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20241222-2.0.0 (#3623) (4061922)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250112-2.0.0 (#3651) (fd06100)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250128-2.0.0 (#3667) (0b92af6)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250216-2.0.0 (#3688) (e3beb6f)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250302-2.0.0 (#3720) (c0b3902)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250313-2.0.0 (#3723) (b8875a8)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250404-2.0.0 (#3754) (1381c8f)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250427-2.0.0 (#3773) (c0795fe)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250511-2.0.0 (#3794) (d3bf724)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250615-2.0.0 (#3872) (f081589)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20250706-2.0.0 (#3910) (ae5c971)
• update dependency com.google.apis:google-api-services-bigquery to v2-rev20251012-2.0.0 (#3923) (1d8977d)
• update dependency com.google.cloud:google-cloud-bigquerystorage-bom to v3.10.0 (0bd3c86)
• update dependency com.google.cloud:google-cloud-bigquerystorage-bom to v3.10.1 (c03a63a)
• update dependency com.google.cloud:google-cloud-bigquerystorage-bom to v3.10.2 (19fc184)
• update dependency com.google.cloud:google-cloud-bigquerystorage-bom to v3.17.0 (#3954) (e73deed)
• update dependency com.google.cloud:google-cloud-bigquerystorage-bom to v3.9.0 (c4afbef)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.50.0 (#3330) (cabb0ab)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.51.0 (#3343) (e3b934f)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.52.0 (#3375) (2115c04)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.53.0 (#3418) (6cff7f0)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.54.0 (#3450) (cc9da95)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.55.0 (#3481) (8908cfd)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.57.0 (#3505) (6e78f56)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.58.0 (#3533) (cad2643)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.59.0 (#3561) (1bd24a1)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.60.0 (#3583) (34dd8bc)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.61.0 (#3618) (6cba626)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.62.0 (#3632) (e9ff265)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.63.0 (#3661) (9bc8c01)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.64.0 (#3681) (9e4e261)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.65.0 (#3704) (53b68b1)
• update dependency com.google.cloud:google-cloud-datacatalog-bom to v1.66.0 (#3727) (7339f94)
• update dependency com.google.cloud:sdk-platform-java-config to v3.31.0 (#3335) (0623455)
• update dependency com.google.cloud:sdk-platform-java-config to v3.32.0 (#3360) (4420996)
• update dependency com.google.cloud:sdk-platform-java-config to v3.33.0 (#3405) (a4a9999)
• update dependency com.google.cloud:sdk-platform-java-config to v3.34.0 (#3433) (801f441)
• update dependency com.google.cloud:sdk-platform-java-config to v3.35.0 (#3472) (fa9ac5d)
• update dependency com.google.cloud:sdk-platform-java-config to v3.36.0 (#3490) (a72c582)
• update dependency com.google.cloud:sdk-platform-java-config to v3.36.1 (#3496) (8f2e5c5)
• update dependency com.google.cloud:sdk-platform-java-config to v3.37.0 (bf4d37a)
• update dependency com.google.cloud:sdk-platform-java-config to v3.38.0 (#3542) (16448ee)
• update dependency com.google.cloud:sdk-platform-java-config to v3.39.0 (#3548) (616b2f6)
• update dependency com.google.cloud:sdk-platform-java-config to v3.40.0 (#3576) (d5fa951)
• update dependency com.google.cloud:sdk-platform-java-config to v3.41.0 (#3607) (11499d1)
• update dependency com.google.cloud:sdk-platform-java-config to v3.41.1 (#3628) (442d217)
• update dependency com.google.cloud:sdk-platform-java-config to v3.42.0 (#3653) (1a14342)
• update dependency com.google.cloud:sdk-platform-java-config to v3.43.0 (#3669) (4d9e0ff)
• update dependency com.google.cloud:sdk-platform-java-config to v3.44.0 (#3694) (f69fbd3)
• update dependency com.google.cloud:sdk-platform-java-config to v3.45.1 (#3714) (e4512aa)
• update dependency com.google.cloud:sdk-platform-java-config to v3.46.0 (#3753) (a335927)
• update dependency com.google.cloud:sdk-platform-java-config to v3.46.2 (#3756) (907e39f)
• update dependency com.google.cloud:sdk-platform-java-config to v3.46.3 (#3772) (ab166b6)
• update dependency com.google.cloud:sdk-platform-java-config to v3.47.0 (#3779) (b27434b)
• update dependency com.google.cloud:sdk-platform-java-config to v3.48.0 (#3790) (206f06d)
• update dependency com.google.cloud:sdk-platform-java-config to v3.49.0 (#3811) (2c5ede4)
• update dependency com.google.cloud:sdk-platform-java-config to v3.49.2 (#3853) (cf864df)
• update dependency com.google.cloud:sdk-platform-java-config to v3.50.0 (#3861) (eb26dee)
• update dependency com.google.cloud:sdk-platform-java-config to v3.50.1 (#3878) (0e971b8)
• update dependency com.google.cloud:sdk-platform-java-config to v3.50.2 (#3901) (8205623)
• update dependency com.google.cloud:sdk-platform-java-config to v3.51.0 (#3924) (cb66be5)
• update dependency com.google.cloud:sdk-platform-java-config to v3.52.0 (#3939) (794bf83)
• update dependency com.google.cloud:sdk-platform-java-config to v3.52.1 (#3952) (79b7557)
• update dependency com.google.cloud:sdk-platform-java-config to v3.52.2 (#3964) (6775fce)
• update dependency com.google.cloud:sdk-platform-java-config to v3.52.3 (#3971) (f8cf508)
• update dependency com.google.cloud:sdk-platform-java-config to v3.53.0 (#3980) (a961247)
• update dependency com.google.cloud:sdk-platform-java-config to v3.54.1 (#3994) (4e09f6b)
• update dependency com.google.oauth-client:google-oauth-client-java6 to v1.36.0 (#3305) (d05e554)
• update dependency com.google.oauth-client:google-oauth-client-java6 to v1.37.0 (#3614) (f5faa69)
• update dependency com.google.oauth-client:google-oauth-client-java6 to v1.38.0 (#3685) (53bd7af)
• update dependency com.google.oauth-client:google-oauth-client-java6 to v1.39.0 (#3710) (c0c6352)
• update dependency com.google.oauth-client:google-oauth-client-jetty to v1.36.0 (#3306) (0eeed66)
• update dependency com.google.oauth-client:google-oauth-client-jetty to v1.37.0 (#3615) (a6c7944)
• update dependency com.google.oauth-client:google-oauth-client-jetty to v1.38.0 (#3686) (d71b2a3)
• update dependency com.google.oauth-client:google-oauth-client-jetty to v1.39.0 (#3711) (43b86e9)
• update dependency io.opentelemetry:opentelemetry-api to v1.52.0 (#3902) (772407b)
• update dependency io.opentelemetry:opentelemetry-bom to v1.51.0 (#3840) (51321c2)
• update dependency io.opentelemetry:opentelemetry-bom to v1.52.0 (#3903) (509a6fc)
• update dependency io.opentelemetry:opentelemetry-context to v1.52.0 (#3904) (96c1bae)
• update dependency io.opentelemetry:opentelemetry-exporter-logging to v1.52.0 (#3905) (28ee4c9)
• update dependency node to v22 (#3713) (251def5)
• update dependency org.graalvm.buildtools:junit-platform-native to v0.10.2 (#3311) (3912a92)
• update dependency org.graalvm.buildtools:native-maven-plugin to v0.10.2 (#3312) (9737a5d)
• update dependency org.junit.vintage:junit-vintage-engine to v5.10.3 (#3371) (2e804c5)
• update dependency ubuntu to v24 (#3498) (4f87ade)
• update github/codeql-action action to v2.25.10 (#3348) (8b6feff)
• update github/codeql-action action to v2.25.11 (#3376) (f1e0014)
• update github/codeql-action action to v2.25.12 (#3387) (af60b30)
• update github/codeql-action action to v2.25.13 (#3395) (95c8d6f)
• update github/codeql-action action to v2.25.15 (#3402) (a61ce7d)
• update github/codeql-action action to v2.25.6 (#3307) (8999d33)
• update github/codeql-action action to v2.25.7 (#3334) (768342d)
• update github/codeql-action action to v2.25.8 (#3338) (8673fe5)
• update github/codeql-action action to v2.26.10 (#3506) (ca71294)
• update github/codeql-action action to v2.26.11 (#3517) (ac736bb)
• update github/codeql-action action to v2.26.12 (#3522) (fdf8dc4)
• update github/codeql-action action to v2.26.13 (#3536) (844744f)
• update github/codeql-action action to v2.26.2 (#3426) (0a6574f)
• update github/codeql-action action to v2.26.3 (#3438) (390e182)
• update github/codeql-action action to v2.26.5 (#3446) (58aacc5)
• update github/codeql-action action to v2.26.6 (#3464) (2aeb44d)
• update github/codeql-action action to v2.26.7 (#3482) (e2c94b6)
• update github/codeql-action action to v2.26.8 (#3488) (a6d75de)
• update github/codeql-action action to v2.26.9 (#3494) (8154043)
• update github/codeql-action action to v2.27.0 (#3540) (1616a0f)
• update github/codeql-action action to v2.27.1 (#3567) (e154ee3)
• update github/codeql-action action to v2.27.3 (#3569) (3707a40)
• update github/codeql-action action to v2.27.4 (#3572) (2c7b4f7)
• update github/codeql-action action to v2.27.5 (#3588) (3f94075)
• update github/codeql-action action to v2.27.6 (#3597) (bc1f3b9)
• update github/codeql-action action to v2.27.7 (#3603) (528426b)
• update github/codeql-action action to v2.27.9 (#3608) (567ce01)
• update github/codeql-action action to v2.28.0 (#3621) (e0e09ec)
• update github/codeql-action action to v2.28.1 (#3637) (858e517)
• update netty.version to v4.1.119.final (#3717) (08a290a)
• update netty.version to v4.2.0.final (#3745) (bb811c0)
• update netty.version to v4.2.1.final (#3780) (6dcd858)
• update ossf/scorecard-action action to v2.4.0 (#3408) (66777a2)
• update ossf/scorecard-action action to v2.4.1 (#3690) (cdb61fe)
• update ossf/scorecard-action action to v2.4.2 (#3810) (414f61d)
• update sdk-platform-java-config to 3.55.0-rc1 (#4033) (580427d)

Documentation

• add short mode query sample (#3397) (6dca6ff)
• add simple query connection read api sample (#3394) (d407baa)
• bigquery: Add javadoc description of timestamp() parameter. (#3604) (6ee0c10)
• bigquery: Update TableResult.getTotalRows() docstring (#3785) (6483588)
• fix BigQuery documentation formating (#3565) (552f491)
• reformat javadoc (#3545) (4763f73)
• update CONTRIBUTING.md for users without branch permissions (#3670) (009b9a2)
• update error handling comment to be more precise in samples (#3712) (9eb555f)
• update iam policy sample user to be consistent with other languages (#3429) (2fc15b3)
• update maven format command (#3877) (d2918da)
• Update SimpleApp to explicitly set project id (#3534) (903a0f7)