Version 6.24.0

• 6.83.0 (latest)
• 6.82.0
• 6.80.1
• 6.79.0
• 6.77.0
• 6.74.1
• 6.72.0
• 6.71.0
• 6.69.0
• 6.68.0
• 6.66.0
• 6.65.1
• 6.62.0
• 6.60.0
• 6.58.0
• 6.57.0
• 6.56.0
• 6.55.0
• 6.54.0
• 6.53.0
• 6.52.1
• 6.51.0
• 6.50.1
• 6.49.0
• 6.25.1
• 6.24.0
• 6.23.4
• 6.22.0
• 6.21.2
• 6.20.0
• 6.19.1
• 6.18.0
• 6.17.4
• 6.14.1

Changelog

6.24.0 (2022-05-05)

Features

• Copy backup samples (#1802) (787ccad)
• support CREATE DATABASE in Connection API (#1845) (40110fe)
• support CredentialsProvider in Connection API (#1869) (f1d2d3e)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.2.8 (#1831) (088fb50)
• update dependency com.google.cloud:google-cloud-monitoring to v3.2.9 (#1851) (4d6bb2d)
• update dependency com.google.cloud:google-cloud-trace to v2.1.11 (#1799) (049635d)

Documentation

• add samples for PostgresSQL (#1781) (e832298)

6.23.3 (2022-04-21)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.10.0 (#1830) (3c55eb3)

Documentation

• add samples for PostgreSQL (#1700) (a024483)

6.23.2 (2022-04-11)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.2.7 (#1810) (0acb53d)
• update dependency org.openjdk.jmh:jmh-core to v1.35 (#1789) (3511fe6)

6.23.1 (2022-03-29)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.2.6 (#1797) (48097de)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.9.0 (#1791) (603e91c)

6.23.0 (2022-03-28)

Features

• Copy Backup Support (#1778) (dc79366)

6.22.0 (2022-03-25)

Features

• Cross Region backup proto changes (#1754) (6d64104)
• support PG show transaction isolation level (#1777) (111f74c)

Bug Fixes

• Correct recording values in opencensus measureMap in HeaderInterceptor (#1726) (bdb2b89)
• return errors from BatchCreateSession to dialect detection (#1760) (6550a9d), closes #1759

Dependencies

• update dependency com.google.cloud:google-cloud-trace to v2.1.7 (#1748) (a794387)
• update dependency com.google.cloud:google-cloud-trace to v2.1.8 (#1757) (2b54949)
• update dependency com.google.cloud:google-cloud-trace to v2.1.9 (#1782) (d623b7e)
• update dependency org.json:json to v20220320 (#1761) (6eee5eb)

6.21.2 (2022-03-10)

Dependencies

• update dependency com.google.cloud:google-cloud-trace to v2.1.6 (#1743) (6b0f813)

6.21.1 (2022-03-09)

Dependencies

• update dependency com.google.cloud:google-cloud-trace to v2.1.5 (#1739) (b553c03)

6.21.0 (2022-03-08)

Features

• parse query parameters in PostgreSQL query (#1732) (7357ac6)
• Track PG Adapter usage from user-agent headers (#1711) (cb640ab)

Bug Fixes

• annotating some fields as REQUIRED (#1695) (8b90b6c)
• catch ExecutionException for op.getName (#1729) (8ea3ac0)
• PostgreSQL supports newline in quoted literals and identifiers (#1731) (f403d99)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.2.4 (#1719) (20336cd)
• update dependency com.google.cloud:google-cloud-monitoring to v3.2.5 (#1727) (92a9f14)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.8.0 (#1722) (9704974)
• update dependency com.google.cloud:google-cloud-trace to v2.1.4 (#1728) (d193a26)

6.20.0 (2022-02-22)

Features

• allows for getting json columns using getValue (#1699) (a51973b)

Bug Fixes

• java: make system property accessible for native image compilation (#1694) (e3fb2b2)
• use information_schema instead of pg_catalog for dialect detection (#1708) (91e157a)

6.19.1 (2022-02-18)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.2.3 (#1698) (cd4f4ca)
• update dependency com.google.cloud:google-cloud-trace to v2.1.3 (#1684) (e70e5c4)

6.19.0 (2022-02-16)

Features

• automatically detect database dialect (#1677) (9eccfc4)
• PostgreSQL dialect databases (#1673) (5f156f2)

Bug Fixes

• allow getting metadata without calling next() (#1691) (4cfe74e)
• do not delete session in close method for BatchReadOnlyTransactionImpl (#1688) (5dc3e19)
• untyped null parameters would cause NPE (#1680) (7095f94), closes #1679

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.2.2 (#1666) (8ea2220)
• update dependency com.google.cloud:google-cloud-trace to v2.1.2 (#1664) (4f46635)

6.18.0 (2022-02-03)

Features

• add database dialect (#1657) (269f090)
• Updating readme with new gfe latency metrics (#1630) (d02601a)

Dependencies

• java: update actions/github-script action to v5 (#1339) (#1659) (203b346)
• update actions/github-script action to v5 (#1658) (a2f3790)
• update dependency com.google.cloud:google-cloud-monitoring to v3.2.1 (#1637) (73c9434)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.7.0 (#1662) (ece31c0)
• update opencensus.version to v0.31.0 (#1661) (1e86a3a)

6.17.4 (2022-01-07)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.6.0 (#1632) (c7d4d4d)
• update dependency com.google.cloud:google-cloud-trace to v2.1.1 (#1633) (4607c21)

6.17.3 (2021-12-17)

Bug Fixes

• re-adds test-jar to bom definition (#1596) (5accdcd)

Dependencies

• bump OpenCensus API to 0.30.0 (#1598) (b953363)

6.17.2 (2021-12-15)

Dependencies

• update opencensus.version to v0.29.0 (#1589) (7abf7ff)

6.17.1 (2021-12-08)

Dependencies

• update dependency com.google.cloud:google-cloud-trace to v2.1.0 (#1574) (eaf2831)

6.17.0 (2021-12-06)

Features

• NaNs in Mutations are equal and have the same hashcode (#1554) (91a18fc)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.2.0 (#1571) (0e0d9f7)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.5.1 (#1570) (563879e)
• update dependency org.json:json to v20211205 (#1572) (59593bd)

6.16.0 (2021-11-15)

Features

• support RPC priority for JDBC connections and statements (#1548) (b61a0d4)

6.15.2 (2021-11-10)

Bug Fixes

• java: java 17 dependency arguments (#1537) (0e30ebf)

6.15.1 (2021-10-27)

Dependencies

• upgrade Mockito to version 4.x (#1498) (09bd561)

6.15.0 (2021-10-27)

Features

• next release from main branch is 6.15.0 (#1518) (9e5e27e)

6.14.0 (2021-10-25)

Features

• Introduce Native Image testing build script changes (#1500) (7a034c9)

Bug Fixes

• java: java 17 dependency arguments (#1512) (4cebefa)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.1.0 (#1506) (ea35b27)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.4.0 (#1501) (d5a37b8)
• update dependency com.google.cloud:google-cloud-trace to v2.0.6 (#1504) (667b8b1)

6.13.0 (2021-10-07)

Features

• expose GFE latency metrics (#1473) (de82f78)

Bug Fixes

• keep track of any BeginTransaction option for a Read (#1485) (757d6ec)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.0.7 (#1491) (58f0e5a)

6.12.5 (2021-09-27)

Bug Fixes

• sessions were not always removed from checkedOutSessions (#1438) (49360b1)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.0.6 (#1443) (159c026)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.3.0 (#1439) (6bdeddf)
• update dependency com.google.cloud:google-cloud-trace to v2.0.5 (#1459) (2ce9a1b)

6.12.4 (2021-09-16)

Bug Fixes

• do not serialize unnecessary fields (#1426) (29209f8)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.0.5 (#1431) (32eee0a)

6.12.3 (2021-09-15)

Bug Fixes

• drop databases after sample tests (#1401) (c9f5048)
• fix JSON sample test (#1417) (dc1f9a9)
• revert test category refactoring (#1419) (fe2ad14)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.0.4 (#1422) (d57d47e)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.2.1 (#1420) (85b4f31)
• update dependency com.google.cloud:google-cloud-trace to v2.0.4 (#1425) (ce8776a)

6.12.2 (2021-09-01)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.0.3 (#1402) (417fc5a)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.2.0 (#1397) (cc543c7)
• update dependency com.google.cloud:google-cloud-trace to v2.0.3 (#1399) (2874720)

6.12.1 (2021-08-25)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3.0.2 (#1372) (8d08076)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.1.0 (#1369) (c94ad5b)
• update dependency com.google.cloud:google-cloud-trace to v2.0.2 (#1373) (1b7933d)

6.12.0 (2021-08-24)

Features

• add support for JSON data type (#872) (d7ff940)
• use dummy emulator-project when no project is set (#1363) (673855e), closes #1345

6.11.1 (2021-08-17)

Dependencies

• update dependency org.openjdk.jmh:jmh-core to v1.33 (#1338) (fa88b73)
• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.33 (#1339) (94cfecc)

6.11.0 (2021-08-12)

Features

• release gapic-generator-java v2.0.0 (#1334) (368fb80)

Documentation

• use 'latest' stats package in samples to prevent build failures (#1313) (6a8351c), closes #1273

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v3 (#1341) (de7b540)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2 (#1331) (cd1ad7b)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v2.0.1 (#1344) (300837f)
• update dependency com.google.cloud:google-cloud-trace to v2 (#1342) (d24886b)

6.10.1 (2021-07-21)

Dependencies

• update dependency com.google.cloud:grpc-gcp to v1.1.0 (#1306) (fa0c65d)

6.10.0 (2021-07-19)

Features

• exposes default leader in database, and leader options / replicas in instance config (#1283) (d72c2f7)

Bug Fixes

• shorten the test instance name (#1284) (07c3eae)

Dependencies

• update dependency com.google.cloud:google-cloud-trace to v1.4.2 (#1291) (c4208ed)

6.9.1 (2021-07-05)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.3.4 (#1278) (c692336)

6.9.0 (2021-07-05)

Features

• add support for tagging to Connection API (#623) (5722372)
• spanner: add leader_options to InstanceConfig and default_leader to Database (#1271) (f257671)
• support setting an async executor provider (#1263) (369c8a7)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v1.4.0 (#1269) (025e162)

6.8.0 (2021-06-29)

Features

• add gRPC-GCP channel pool as an option (#1227) (1fa95a9)
• spanner JSON type (#1260) (b2a56c6)

Bug Fixes

• Add shopt -s nullglob to dependencies script (#1256) (d1712f7)

6.7.0 (2021-06-21)

Features

• add support for instance processing units (#665) (9c1c8e9)
• spanner: add processing_units to Instance resource (#1248) (e3c7e8f)

Bug Fixes

• Update dependencies.sh to not break on mac (#1249) (1e1df84)

6.6.1 (2021-06-10)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.3.3 (#1241) (9816b3f)

6.6.0 (2021-06-07)

Features

• adds query optimizer statistics support (#385) (e294532)
• support encoded credentials in connection URL (#1223) (43d5d7e)

Documentation

• document retry settings in sample (#1214) (ab4592d)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.3.0 (#1225) (2023839)
• update dependency com.google.cloud:google-cloud-monitoring to v2.3.2 (#1229) (8a23ad0)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v1.3.0 (#1230) (db64451)
• update dependency com.google.cloud:google-cloud-trace to v1.4.0 (#1226) (da4407a)
• update dependency com.google.cloud:google-cloud-trace to v1.4.1 (#1231) (76af3ac)
• update dependency org.openjdk.jmh:jmh-core to v1.32 (#1221) (b009c9b)
• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.32 (#1222) (7ef76a9)

6.5.0 (2021-05-25)

Features

• add gcf-owl-bot[bot] to ignoreAuthors (#1196) (4f6e18d)
• add bufferAsync methods (#1145) (7d6816f)

Bug Fixes

• stop invoking callback after pausing and cancelling result set (#1192) (78e6784), closes #1191

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v1.2.0 (#1194) (9935066)

6.4.4 (2021-05-17)

Bug Fixes

• re-adds test verifyStatementsInFile (#1181) (7a715b4)

6.4.3 (2021-05-16)

Bug Fixes

• re-adds test utility method for connection (#1178) (0e0dcb7)

6.4.2 (2021-05-14)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.2.3 (#1170) (3bb6885)
• update dependency com.google.cloud:google-cloud-trace to v1.3.4 (#1171) (6faa310)

6.4.1 (2021-05-13)

Documentation

• close Spanner instance when it is no longer needed (#1116) (85bd0cf)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.2.2 (#1158) (63eed2e)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v1.1.0 (#1152) (2e7f18a)
• update dependency org.openjdk.jmh:jmh-core to v1.30 (#1137) (699a426)
• update dependency org.openjdk.jmh:jmh-core to v1.31 (#1160) (43a0fb9)
• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.30 (#1138) (ad6649d)
• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.31 (#1161) (4d17da2)

6.4.0 (2021-04-29)

Features

• adds getValue to ResultSet (#1073) (7792c90)

Bug Fixes

• allow using case-insensitive user-agent key (#1110) (f4f9e43)
• check for timeout in connection after last statement finished (#1086) (aec0b54), closes #1077
• check for timeout in connection after last statement finished (#1086) (51d753c), closes #1077
• do not keep references to invalidated clients (#1093) (b4595a6), closes #1089
• prevent potential NullPointerException in Struct with Array field that contains null elements (#1107) (c414abb), closes #1106

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.2.1 (#1104) (37ca990)
• update dependency com.google.cloud:google-cloud-trace to v1.3.3 (#1103) (b4327c0)

Documentation

• fix javadoc for Date type (#1102) (ce095f7)
• use default timeout for restore operation (#1109) (3f3c13e), closes #1019

6.3.3 (2021-04-24)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v1 (#1095) (a21e0bb)

6.3.2 (2021-04-20)

Dependencies

• update dependency com.google.cloud:google-cloud-trace to v1.3.2 (#1081) (e145c95)

6.3.1 (2021-04-20)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.21.1 (#1074) (ccd8cd1)

6.3.0 (2021-04-19)

Features

• async work as functional interface (#1068) (734fb60)
• spanner: add progress field to UpdateDatabaseDdlMetadata (#1063) (7992342)
• transaction callable as functional interface (#1066) (b036a77)

Bug Fixes

• release scripts from issuing overlapping phases (#1064) (2f6fe5e)

Dependencies

• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.29 (#1014) (81ee9b0)

6.2.1 (2021-04-13)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.2.0 (#1054) (0b59b94)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.21.0 (#1045) (94dcb46)
• update dependency com.google.cloud:google-cloud-trace to v1.3.1 (#1050) (cbb1038)

6.2.0 (2021-04-07)

Features

• add support for tagging (#576) (2a9086f)
• Support query hints for DML statements (#1030) (6a58433)

Bug Fixes

• local connection checker ignores exceptions (#1036) (2d61bc4)

6.1.0 (2021-03-31)

Features

• support RPC priority (#676) (0bc9972)

Bug Fixes

• plain text when testing emulator connection (#1020) (1e6e23f)
• retry cancelled error on first statement in transaction (#999) (a95f6f8), closes #938
• transaction retries should not timeout (#1009) (6d9c3b8), closes #1008
• update link and directory (#1012) (865bf01)

Dependencies

• update dependency org.openjdk.jmh:jmh-core to v1.29 (#1013) (a71079f)

Documentation

• improve error messages (#1011) (7dacfdc)
• new libraries-bom (#1025) (3485252)

6.0.0 (2021-03-21)

⚠ BREAKING CHANGES

• add closeAsync() method to Connection (#984)
• drops support of Java 7 (#946)
• customer-managed encryption keys for Spanner (#666)

Features

• add closeAsync() method to Connection (#984) (e7ec96e)
• customer-managed encryption keys for Spanner (#666) (8338116)
• drops support of Java 7 (#946) (7af1951)

5.2.0 (2021-03-18)

Features

• add autoConfigEmulator connection option (#931) (32fdd60)

Bug Fixes

• all throwables should be ignored in shutdown hook (#950) (213dddc), closes #949

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.1.0 (#953) (f991c87)
• update dependency com.google.cloud:google-cloud-trace to v1.3.0 (#947) (c1d560b)
• update dependency org.openjdk.jmh:jmh-generator-annprocess to v1.28 (#924) (693fe5d)

5.1.0 (2021-03-10)

Features

• add client lib token for Liquibase (#925) (0d93d92)
• adds samples for PITR (#837) (55fa0cc)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.0.14 (#919) (178500c)
• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.20.1 (#944) (b74b764)
• update dependency org.json:json to v20210307 (#943) (4088981)
• update dependency org.openjdk.jmh:jmh-core to v1.28 (#923) (b4d6e5a)

5.0.0 (2021-02-26)

⚠ BREAKING CHANGES

• add CommitStats to Connection API (#608)

Features

• add CommitStats to Connection API (#608) (b2b1191)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.20.0 (#917) (aca9d45)
• update dependency com.google.cloud:google-cloud-trace to v1.2.13 (#918) (8843998)

4.0.2 (2021-02-23)

Dependencies

• update dependency com.google.cloud:google-cloud-monitoring to v2.0.13 (#901) (10749c7)
• update dependency com.google.cloud:google-cloud-trace to v1.2.12 (#896) (84ee6e0)

4.0.1 (2021-02-22)

Bug Fixes

• wrong use of getRetryDelayInMillis() / 1000 in documentation and retry loops (#885) (a55d7ce), closes #874

Documentation

• Add OpenCensus to OpenTelemetry shim to README (#879) (b58d73d)

Dependencies

• update dependency com.google.cloud:google-cloud-shared-dependencies to v0.19.0 (#895) (e3e2c95)

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)