CHANGELOG.md

Changelog

4.0.0 (2021-02-17)

⚠ BREAKING CHANGES

• Point In Time Recovery (PITR) (#452)
• add support for CommitStats (#544)

Features

• add option for returning Spanner commit stats (#817) (80d3585)
• add support for CommitStats (#544) (44aa384)
• allow session pool settings in connection url (#821) (e1e9152)
• generate sample code in the Java microgenerator (#859) (7cdfb82)
• Point In Time Recovery (PITR) (#452) (ab14a5e)

Bug Fixes

• allows user-agent header with header provider (#871) (3de7e2a)
• make compiled statements immutable (#843) (118d1b3)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.0.12 (#854) (58cebd8)
• update dependency com.google.cloud:google-cloud-trace to v1.2.11 (#825) (49c8c5d)

Documentation

• libraries-bom 16.4.0 (#867) (5af3673)

3.3.2 (2021-01-18)

Bug Fixes

• closes pool maintainer on invalidation (#784) (d122ed9)
• UNAVAILABLE error on first query could cause transaction to get stuck (#807) (c7dc6e6), closes #799

Dependencies

• update opencensus.version to v0.28.3 (#806) (77910a0)

3.3.1 (2021-01-14)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Bug Fixes

• blanks span for session keepAlive traces (#797) (1a86e4f)
• mark transaction as invalid if no tx is returned before RS is closed (#791) (e02e5a7)
• remove time series before adding it (#766) (90255ea), closes #202
• safeguard against statements errors when requesting tx (#800) (c4776e4)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.17.1 (#794) (f0beabb)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.18.0 (#796) (1a71e50)

3.3.0 (2021-01-07)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Features

• attempt DirectPath by default (#770) (dc02244)

Bug Fixes

• Set up DirectPath e2e tests correctly (#780) (9b94c6e)

3.2.1 (2021-01-06)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Bug Fixes

• grpc-alts is used not only in tests (#761) (72d93d5)

Dependencies

• grpc-alts is only used for tests (#757) (c8ef46f)
• update dependency com.google.cloud:google-cloud-monitoring to v2.0.11 (#754) (ee2de33)

Documentation

• add sample for timeout for one RPC (#707) (056f54f)
• cleanup inner region tags (#764) (90ad9d6)
• documents resume on update database ddl (#767) (aeb255d)

3.2.0 (2020-12-17)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Features

• include client version in user agent header (#747) (fc63bc3)
• introduce TransactionOptions and UpdateOptions (#716) (5c96fab)

Bug Fixes

• reduce the probability of RESOURCE_EXHAUSTED errors during tests (#734) (cd946d7), closes #733

Documentation

• homogenize region tags (#752) (2b3775a)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.17.0 (#751) (f52776f)
• update dependency com.google.cloud:google-cloud-trace to v1.2.10 (#759) (405c4cc)

3.1.3 (2020-12-14)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.16.1 (09968d5)

3.1.2 (2020-12-14)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.0.9 (#710) (37a636d)

3.1.1 (2020-12-10)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Dependencies

• update dependency com.google.cloud:google-cloud-trace to v1.2.8 (#699) (e3289bd)

3.1.0 (2020-12-10)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Features

• allow lenient mode for connection properties (#671) (f6a8ba6)
• retry admin request limit exceeded error (#669) (3f9f74a), closes #655

Bug Fixes

• fixes changelog of upgrade 2.0.0 (#672) (c035546)
• transaction retry could fail if tx contained failed statements (#688) (f78c64e), closes #685

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.16.0 (#680) (81cba9a)
• update dependency com.google.cloud:google-cloud-trace to v1.2.7 (#646) (0e17be0)
• update dependency org.openjdk.jmh:jmh-core to v1.27 (#691) (a2e82e4)
• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.27 (#692) (bca15c2)

3.0.5 (2020-11-19)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Bug Fixes

• delete stale sample databases (#622) (7584baa)
• does not generate codeowners (#631) (9e133a9)
• query could hang transaction if ResultSet#next() is not called (#643) (48f92e3), closes #641

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.0.8 (#644) (447a99b)

3.0.4 (2020-11-17)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Reverts

• Revert "fix: skip failing backup tests for now" (#634) (b22cd7d), closes #634

3.0.3 (2020-11-16)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Dependencies

• update dependency org.json:json to v20201115 (#624) (60e31d1)

3.0.2 (2020-11-13)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Bug Fixes

• adds api spanner team as samples code owners (#610) (35cc56c)
• make enums in the Connection API public (#579) (19b1629), closes #253
• session retry could cause infinite wait (#616) (8a66d84), closes #605
• updates project / instance for samples tests (#613) (2589e7d)

Documentation

• add descriptions for connection URL properties (#609) (34221d7)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.0.7 (#573) (5135e50)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.14.1 (#567) (2e9c133)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.15.0 (#614) (3fa7910)
• update dependency com.google.cloud:google-cloud-trace to v1.2.6 (#574) (efabe0f)

3.0.1 (2020-10-28)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

Bug Fixes

• adds assembly descriptor to snippets samples (#559) (d4ae85c)
• always delete all backups from an owned test instance (#557) (ff571b0), closes #542
• fixes the code of conduct document (#541) (7b9d1db)
• SessionNotFound was not retried for AsyncTransactionManager (#552) (5969f83)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.13.0 (#521) (0f4c017)

3.0.0 (2020-10-23)

⚠ IMPORTANT: Known issue with this version of the client

Since v3.0.0, transactions can get stuck if the Spanner backend returns a retryable error when consuming the first record of a read / query in a transaction.

A fix is submitted and available in version v3.3.2

Please use v3.3.2 instead of this version.

Apologies for the inconvenience.

⚠ BREAKING CHANGES

• initialize should be protected (#536)
• async connection API (#392)

Features

• adds options to the write operations (#531) (659719d)
• async connection API (#392) (3dd0675), closes #378
• inline begin transaction (#325) (d08d3de), closes #515

Bug Fixes

• AsyncTransactionManager did not propagate statement errors (#516) (4b8b845), closes #514
• AsyncTransactionManager should rollback on close (#505) (c580df8), closes #504
• close executor when closing pool (#501) (2086746)
• fixes javadocs for Key (#532) (768c19d)
• fixes sample tests (ed0665c)
• ignores failing backup operations (2ad0b7f)
• increase visibility of #get() (#486) (fa6d964)
• initialize should be protected (#536) (5c4c8c5)
• remove dependency on commons-lang (#494) (c99294b)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2 (#498) (3ab7348)
• update dependency com.google.cloud:google-cloud-monitoring to v2.0.5 (#525) (fb874ec)
• update dependency com.google.cloud:google-cloud-monitoring to v2.0.6 (#540) (ce3bed6)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.10.2 (#500) (eb59929)
• update dependency com.google.cloud:google-cloud-trace to v1.2.3 (#496) (0595a80)
• update dependency com.google.cloud:google-cloud-trace to v1.2.4 (#526) (1020989)
• update dependency com.google.cloud:google-cloud-trace to v1.2.5 (#539) (eddd6ad)
• update dependency org.openjdk.jmh:jmh-core to v1.26 (#506) (0f13c4c)
• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.26 (#507) (600f397)
• update opencensus.version to v0.27.1 (#497) (62fa39a)
• update opencensus.version to v0.28.1 (#533) (777f5fc)
• update opencensus.version to v0.28.2 (#538) (e1843ef)

2.0.2 (2020-10-02)

Bug Fixes

• improve numeric range checks (#424) (9f26785)
• ResultSet#close() should not throw exceptions from session creation (#487) (60fb986)
• skip failing backup tests for now (#463) (f037f2d)
• use credentials key in pool (#430) (28103fb)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.10.0 (#453) (e05ee0e)

2.0.1 (2020-09-18)

Bug Fixes

• do not close delegate rs in callback runnable (#425) (dce3ee7)
• re-adds method used in internal testing (#438) (c36e41b)

2.0.0 (2020-09-16)

⚠ BREAKING CHANGES

• Remove Guava ImmutableList from API surface (#411) (b35304e)

Features

• add lazy initializer (#423) (e8522b9)

Bug Fixes

• fix aborted handling of batchUpdateAsync (#421) (6154008)
• uses old version of gax-grpc method (#426) (fe6dc79)

Miscellaneous Chores

• ensure next release is major (#428) (bdae120)

1.61.0 (2020-09-09)

Features

• Add experimental DirectPath support (#396) (46264d1)
• support setting timeout per RPC (#379) (5d115d4), closes #378

Bug Fixes

• iterate over async result set in sync (#416) (45d8419)
• remove potential infinite loop in administrative requests (#398) (81d2c76)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.9.0 (#409) (ae43165)
• update dependency org.openjdk.jmh:jmh-core to v1.25.1 (#399) (52fc363)
• update dependency org.openjdk.jmh:jmh-core to v1.25.2 (#412) (86d18cd)
• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.25.2 (#400) (8a40a96)

Documentation

• updates bom and spanner version in readme (#415) (def7fdf)

1.60.0 (2020-08-18)

Features

• adds clirr check on pre-commit hook (#388) (bd5c93f)
• include SQL statement in error message (#355) (cc5ac48)

Bug Fixes

• enables emulator tests (#380) (f61c6d0)
• remove custom timeout and retry settings (#365) (f6afd21)
• remove unused kokoro files (#367) (6125c7d)
• retry pdml transaction on EOS internal error (#360) (a53d736)
• sets the project for the integration tests (#386) (c8fa458)

Dependencies

• stop auto updates of commons-lang3 (#362) (8f07ed6)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.6 (#374) (6f47b8a)
• update dependency org.openjdk.jmh:jmh-core to v1.24 (#375) (94f568c)
• update dependency org.openjdk.jmh:jmh-core to v1.25 (#382) (ec7888e)
• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.25 (#376) (8ffdc48)

1.59.0 (2020-07-16)

Features

• add support for NUMERIC data type (#193) (b38a91d)
• spanner NUMERIC type (#349) (78c3192)

Bug Fixes

• check if emulator is running if env var is set (#340) (597f501)
• fix potential unnecessary transaction retry (#337) (1a4f4fd), closes #327
• respect PDML timeout when using streaming RPC (#338) (d67f108)
• runs sample tests in java 8 and java 11 (#345) (b547e31)
• set gRPC keep-alive to 120 seconds (#339) (26be103)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.3 (#334) (45acd89)
• update shared config to 0.9.2 (#328) (75df62c)

1.58.0 (2020-07-07)

Features

• add async api (#81) (462839b)
• support setting compression option (#192) (965e95e)

Bug Fixes

• set default values for streaming retry (#316) (543373b)

Performance Improvements

• use streaming RPC for PDML (#287) (df47c13)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.2 (#315) (3d6fb9f)

1.57.0 (2020-06-29)

Features

• deps: adopt flatten plugin and google-cloud-shared-dependencies and update ExecutorProvider (#302) (5aef6c3)

1.56.0 (2020-06-17)

Features

• add num_sessions_in_pool metric (#128) (3a7a8ad)

Bug Fixes

• backend now supports optimizer version for DML (#252) (24b986b)
• include an explicit version for javax-annotations-api (#261) (e256d22)
• inconsistent json and yaml spanner configs (#238) (627fdc1)
• test allowed a too old staleness (#214) (f4fa6bf)
• use millis to prevent rounding errors (#260) (22ed458)

Dependencies

• include test-jar in bom (#253) (4e86a37)
• update dependency org.json:json to v20200518 (#239) (e3d7921)

1.55.1 (2020-05-21)

Bug Fixes

• PDML retry settings were not applied for aborted tx (#232) (308a465), closes #199
• remove the need for any env var in all tests (#235) (374fb40)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.4.0 (#224) (2cf04aa)

1.55.0 (2020-05-19)

Features

• mark when a Spanner client is closed (#198) (50cb174)

Bug Fixes

• make it possible to override backups methods (#195) (2d19c25)
• Partitioned DML timeout was not always respected (#203) (13cb37e), closes #199
• partitionedDml stub was not closed (#213) (a2d9a33)
• reuse clientId for invalidated databases (#206) (7b4490d)
• use nanos to prevent truncation errors (#204) (a608460), closes #200

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.3.1 (#190) (ad41a0d)

1.54.0 (2020-05-05)

Features

• deps: import shared-dependencies bom and use maven-flatten-plugin (#172) (060a81a)

Bug Fixes

• create filter in correct order (#180) (d80428a)
• remove error message checking (#183) (b477322), closes #175
• set resource type for database parameter of Backup (#174) (bb4d7cf)
• stop preparing session on most errors (#181) (d0e3d41), closes #177

1.53.0 (2020-04-22)

Features

• optimize maintainer to let sessions be GC'ed instead of deleted (#135) (d65747c)

Bug Fixes

• assign unique id's per test case (#129) (a553b6d)
• check for not null input for Id classes (#159) (ecf5826), closes #145
• clean up test instance if creation failed (#162) (ff571e1)
• fix flaky test and remove warnings (#153) (d534e35), closes #146
• increase test timeout and remove warnings (#160) (63a6bd8), closes #158
• retry non-idempotent long-running RPCs (#141) (4669c02)
• retry restore if blocked by pending restore (#119) (220653d), closes #118
• StatementParser did not accept multiple query hints (#170) (ef41a6e), closes #163
• wait for initialization to finish before test (#161) (fe434ff), closes #146

Performance Improvements

• increase sessions in the pool in batches (#134) (9e5a1cd)
• prepare sessions with r/w tx in-process (#152) (2db27ce), closes #151

Dependencies

• update core dependencies (#109) (5753f1f)
• update core dependencies (#132) (77c1558)
• update dependency com.google.api:api-common to v1.9.0 (#127) (b2c744f)
• update dependency com.google.guava:guava-bom to v29 (#147) (3fe3ae0)
• update dependency io.grpc:grpc-bom to v1.29.0 (#164) (2d2ce5c)
• update dependency org.threeten:threetenbp to v1.4.3 (#120) (49d1abc)

1.52.0 (2020-03-20)

Features

• add backup support (#100) (ed3874a)
• add Backups protos and APIs (#97) (5643c22)

Bug Fixes

• add client id to metrics to avoid collisions (#117) (338e136), closes #106
• ignore added interface methods for generated code (#101) (402cfa1), closes #99
• use grpc 1.27.2 to prevent version conflicts (#105) (37b7c88)

Dependencies

• update core dependencies (#94) (f3ca4c9)
• update opencensus.version to v0.26.0 (#116) (1b8db0b)

1.51.0 (2020-03-13)

Features

• add backend query options (#90) (e96e172)
• add QueryOptions proto (#84) (eb8fc37)

Bug Fixes

• never use credentials in combination with plain text (#98) (7eb8d49)

Dependencies

• update dependency com.google.cloud:google-cloud-core-bom to v1.93.1 (#91) (29d8db8)
• update dependency io.opencensus:opencensus-api to v0.25.0 (#95) (57f5fd0)

1.50.0 (2020-02-28)

Features

• add metrics to capture acquired and released sessions data (#67) (94d0557)
• add session timeout metric (#65) (8d84b53)
• instrument Spanner client with OpenCensus metrics (#54) (d9a00a8)

Bug Fixes

• multiple calls to end of span (#75) (3f32f51)

Dependencies

• update core dependencies (#87) (b096651)
• update dependency com.google.cloud:google-cloud-core-bom to v1.92.5 (56742c9)
• update dependency com.google.http-client:google-http-client-bom to v1.34.2 (#88) (628093d)
• update dependency com.google.protobuf:protobuf-bom to v3.11.4 (#77) (fb2c683)
• update dependency io.grpc:grpc-bom to v1.27.1 (054b7e7)
• update opencensus.version to v0.25.0 (#70) (26a3eff)

Documentation

• regen: update sample code to set total timeout, add API client header test (#66) (1178958)

1.49.2 (2020-02-06)

Bug Fixes

• stop sending RPCs on InstanceNotFound (#61) (7618ac8), closes #60
• use default retry settings for aborted tx (#48) (6709552)
• use resource type to identify type of error (#57) (89c3e77)
• use streaming retry settings for ResumableStreamIterator (#49) (63b33e9)

Dependencies

• update core dependencies (#59) (74b6b98)

1.49.1 (2020-01-24)

Bug Fixes

• stop sending RPCs to deleted database (#34) (11e4a90), closes #16

Performance Improvements

• close sessions async (#24) (ab25087), closes #19
• close sessions async revert revert (#46) (c9864e5), closes #24 #43 #24

Reverts

• Revert "perf: close sessions async (#24)" (#43) (809ed88), closes #24 #43

1.49.0 (2020-01-16)

Features

• add support for CallCredentials (#26) (1112357), closes #18

Bug Fixes

• add keepalives to GRPC channel (#11) (428a4a6)

Dependencies

• mockito scope should be test (#29) (9b0733d)
• update dependency com.google.truth:truth to v1.0.1 (#35) (fa2b471)
• update dependency org.threeten:threetenbp to v1.4.1 (c22c831)

1.48.0 (2020-01-10)

Features

• add public method to get gRPC status code (#25) (2dbe3cf), closes #14
• make repo releasable, add parent/bom (#4) (f0073ee)

Dependencies

• update dependency org.jacoco:jacoco-maven-plugin to v0.8.5 (#7023) (d8b6438)