Skip to content

Commit cf46451

Browse files
committed
Release Spanner libraries version 5.0.0
Changes in Google.Cloud.Spanner.Data version 5.0.0: ### New features Note: V5.0.0 contains all the new features added in previous beta versions V5.0.0-beta0x. Here, we highlight those that introduced breaking changes with respect to previous stable versions V4.x.x. - Transactions support SpannerTransactionCreationOptions and SpannerTransactionOptions. BREAKING CHANGE: SpannerConection methods that open a transaction, like BeginTransacion, Open and RunWithRetriableTransaction sets of methods now accept both option types as parameter, while some of the previously existing methods have been deprecated and will be removed on the next major version. - After a successfull commit or rollback, the transaction is disposed. BREAKING CHANGE: Attempting to use a disposed transaction will result in a client side error. See the Google.Cloud.Spanner.Data.SpannerTransaction.DisposeBehavior documentation for more information. - Add support for FLOAT32 BREAKING CHANGE: The default mapping for values of CLR type decimal was FLOAT64 and it is now Numeric. The default mapping for values of CLR type float was FLOAT64 and it is now FLOAT32. - Support inline transactions. BREAKING CHANGE: In supporting inline transactions the main breaking change is behavioral: transactions are not prewarmed, instead they are acquired as needed, mainly through inlining transaction creation in the first command that attempts to use a transaction. The method `Google.Cloud.Spanner.V1.PooledSession.WithFreshTransactionOrNewAsync` has been removed, as a transaction is not created by the session until command execution. Use instead `Google.Cloud.Spanner.V1.PooledSession.RefreshedOrNewAsync` which returns a new PooledSession instance that either represents the same session but with no transaction associated to it or a newly acquired session. Since transactions are not prewarmed, the session pool does not need to distinguish between read-only and read-write session/transaction pairs. In the statistics classes that may be used for diagnostic purposes all properties distinguishing between read-only and read-write statistics have been removed. Similarly, `Google.Cloud.Spanner.V1.SessionPoolOptions.WriteSessionsFraction` has bee removed. - BREAKING CHANGE: Remove Obsolete code that had been introduced before v5.0.0-beta01. Packages in this release: - Release Google.Cloud.Spanner.Admin.Database.V1 version 5.0.0 - Release Google.Cloud.Spanner.Admin.Instance.V1 version 5.0.0 - Release Google.Cloud.Spanner.Common.V1 version 5.0.0 - Release Google.Cloud.Spanner.Data version 5.0.0 - Release Google.Cloud.Spanner.V1 version 5.0.0
1 parent b3fa6be commit cf46451

File tree

7 files changed

+37
-11
lines changed

7 files changed

+37
-11
lines changed

apis/Google.Cloud.Spanner.Admin.Database.V1/Google.Cloud.Spanner.Admin.Database.V1/Google.Cloud.Spanner.Admin.Database.V1.csproj

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<Project Sdk="Microsoft.NET.Sdk">
33
<PropertyGroup>
4-
<Version>5.0.0-beta06</Version>
4+
<Version>5.0.0</Version>
55
<TargetFrameworks>netstandard2.0;net462</TargetFrameworks>
66
<GenerateDocumentationFile>true</GenerateDocumentationFile>
77
<Description>Recommended Google client library to access the Google Cloud Spanner Database Admin API.</Description>

apis/Google.Cloud.Spanner.Admin.Instance.V1/Google.Cloud.Spanner.Admin.Instance.V1/Google.Cloud.Spanner.Admin.Instance.V1.csproj

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<Project Sdk="Microsoft.NET.Sdk">
33
<PropertyGroup>
4-
<Version>5.0.0-beta06</Version>
4+
<Version>5.0.0</Version>
55
<TargetFrameworks>netstandard2.0;net462</TargetFrameworks>
66
<GenerateDocumentationFile>true</GenerateDocumentationFile>
77
<Description>Recommended Google client library to access the Google Cloud Spanner Instance Admin API.</Description>

apis/Google.Cloud.Spanner.Common.V1/Google.Cloud.Spanner.Common.V1/Google.Cloud.Spanner.Common.V1.csproj

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<Project Sdk="Microsoft.NET.Sdk">
33
<PropertyGroup>
4-
<Version>5.0.0-beta06</Version>
4+
<Version>5.0.0</Version>
55
<TargetFrameworks>netstandard2.0;net462</TargetFrameworks>
66
<GenerateDocumentationFile>true</GenerateDocumentationFile>
77
<Description>Common resource names used by all Spanner V1 APIs</Description>

apis/Google.Cloud.Spanner.Data/Google.Cloud.Spanner.Data/Google.Cloud.Spanner.Data.csproj

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<Project Sdk="Microsoft.NET.Sdk">
33
<PropertyGroup>
4-
<Version>5.0.0-beta06</Version>
4+
<Version>5.0.0</Version>
55
<TargetFrameworks>netstandard2.1;net462</TargetFrameworks>
66
<GenerateDocumentationFile>true</GenerateDocumentationFile>
77
<Description>Google ADO.NET Provider for Google Cloud Spanner.</Description>

apis/Google.Cloud.Spanner.Data/docs/history.md

Lines changed: 27 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,31 @@
11
# Version history
22

3+
## Version 5.0.0, released 2025-04-16
4+
5+
### New features
6+
7+
Note: V5.0.0 contains all the new features added in previous beta versions V5.0.0-beta0x.
8+
Here, we highlight those that introduced breaking changes with respect to previous stable versions V4.x.x.
9+
10+
- Transactions support SpannerTransactionCreationOptions and SpannerTransactionOptions.
11+
BREAKING CHANGE: SpannerConection methods that open a transaction, like BeginTransacion, Open and RunWithRetriableTransaction sets of methods now
12+
accept both option types as parameter, while some of the previously existing methods have been deprecated and will be removed on the next major version.
13+
- After a successfull commit or rollback, the transaction is disposed.
14+
BREAKING CHANGE: Attempting to use a disposed transaction will result in a client side error. See the Google.Cloud.Spanner.Data.SpannerTransaction.DisposeBehavior documentation for more information.
15+
- Add support for FLOAT32
16+
BREAKING CHANGE: The default mapping for values of CLR type decimal was FLOAT64 and it is now Numeric.
17+
The default mapping for values of CLR type float was FLOAT64 and it is now FLOAT32.
18+
- Support inline transactions.
19+
BREAKING CHANGE: In supporting inline transactions the main breaking change is behavioral: transactions are not prewarmed, instead they are acquired
20+
as needed, mainly through inlining transaction creation in the first command that attempts to use a transaction. The method
21+
`Google.Cloud.Spanner.V1.PooledSession.WithFreshTransactionOrNewAsync` has been removed, as a transaction is not created by the session until command execution.
22+
Use instead `Google.Cloud.Spanner.V1.PooledSession.RefreshedOrNewAsync` which returns a new PooledSession instance that either represents the same
23+
session but with no transaction associated to it or a newly acquired session. Since transactions are not prewarmed, the session pool does not need
24+
to distinguish between read-only and read-write session/transaction pairs. In the statistics classes that may be used for diagnostic purposes all
25+
properties distinguishing between read-only and read-write statistics have been removed. Similarly, `Google.Cloud.Spanner.V1.SessionPoolOptions.WriteSessionsFraction`
26+
has bee removed.
27+
- BREAKING CHANGE: Remove Obsolete code that had been introduced before v5.0.0-beta01.
28+
329
## Version 5.0.0-beta06, released 2025-04-14
430

531
### New features
@@ -206,7 +232,7 @@ as needed, mainly through inlining transaction creation in the first command tha
206232
Use instead `Google.Cloud.Spanner.V1.PooledSession.RefreshedOrNewAsync` which returns a new PooledSession instance that either represents the same
207233
session but with no transaction associated to it or a newly acquired session. Since transactions are not prewarmed, the session pool does not need
208234
to distinguish between read-only and read-write session/transaction pairs. In the statistics classes that may be used for diagnostic purposes all
209-
properties distinguising between read-only and read-write statistics have been removed. Similarly, `Google.Cloud.Spanner.V1.SessionPoolOptions.WriteSessionsFraction`
235+
properties distinguishing between read-only and read-write statistics have been removed. Similarly, `Google.Cloud.Spanner.V1.SessionPoolOptions.WriteSessionsFraction`
210236
has bee removed.
211237

212238
## Version 4.6.0, released 2023-06-26

apis/Google.Cloud.Spanner.V1/Google.Cloud.Spanner.V1/Google.Cloud.Spanner.V1.csproj

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<Project Sdk="Microsoft.NET.Sdk">
33
<PropertyGroup>
4-
<Version>5.0.0-beta06</Version>
4+
<Version>5.0.0</Version>
55
<TargetFrameworks>netstandard2.0;net462</TargetFrameworks>
66
<GenerateDocumentationFile>true</GenerateDocumentationFile>
77
<Description>Low-level Google client library to access the Google Cloud Spanner API. The ADO.NET provider (Google.Cloud.Spanner.Data) which depends on this package is generally preferred for Spanner access.</Description>

generator-input/apis.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5015,7 +5015,7 @@
50155015
"protoPath": "google/spanner/admin/database/v1",
50165016
"productName": "Google Cloud Spanner Database Administration",
50175017
"productUrl": "https://cloud.google.com/spanner/",
5018-
"version": "5.0.0-beta06",
5018+
"version": "5.0.0",
50195019
"commonResourcesConfig": "tweaks/Google.Cloud.Spanner.Common.V1/CommonResourcesConfig.json",
50205020
"type": "grpc",
50215021
"description": "Recommended Google client library to access the Google Cloud Spanner Database Admin API.",
@@ -5043,7 +5043,7 @@
50435043
"protoPath": "google/spanner/admin/instance/v1",
50445044
"productName": "Google Cloud Spanner Instance Administration",
50455045
"productUrl": "https://cloud.google.com/spanner/",
5046-
"version": "5.0.0-beta06",
5046+
"version": "5.0.0",
50475047
"commonResourcesConfig": "tweaks/Google.Cloud.Spanner.Common.V1/CommonResourcesConfig.json",
50485048
"type": "grpc",
50495049
"description": "Recommended Google client library to access the Google Cloud Spanner Instance Admin API.",
@@ -5068,7 +5068,7 @@
50685068
{
50695069
"id": "Google.Cloud.Spanner.Data",
50705070
"targetFrameworks": "netstandard2.1;net462",
5071-
"version": "5.0.0-beta06",
5071+
"version": "5.0.0",
50725072
"type": "other",
50735073
"metadataType": "INTEGRATION",
50745074
"description": "Google ADO.NET Provider for Google Cloud Spanner.",
@@ -5104,7 +5104,7 @@
51045104
{
51055105
"id": "Google.Cloud.Spanner.Common.V1",
51065106
"type": "other",
5107-
"version": "5.0.0-beta06",
5107+
"version": "5.0.0",
51085108
"description": "Common resource names used by all Spanner V1 APIs",
51095109
"tags": [
51105110
"Spanner"
@@ -5120,7 +5120,7 @@
51205120
"protoPath": "google/spanner/v1",
51215121
"productName": "Google Cloud Spanner",
51225122
"productUrl": "https://cloud.google.com/spanner/",
5123-
"version": "5.0.0-beta06",
5123+
"version": "5.0.0",
51245124
"commonResourcesConfig": "tweaks/Google.Cloud.Spanner.Common.V1/CommonResourcesConfig.json",
51255125
"type": "grpc",
51265126
"metadataType": "GAPIC_COMBO",

0 commit comments

Comments
 (0)