release 0.111.7

Makefile

@@ -11,7 +11,7 @@ all:
 	@echo execute tests on latest go version	
 	go test ./...
 	@echo execute tests on older supported go versions
-	go1.18.8 test ./...
+	go1.18.9 test ./...
 	@echo "reuse (license) check"
 	reuse lint
 
@@ -26,8 +26,8 @@ tools:
 
 #install additional go versions
 go:
-	go install golang.org/dl/go1.18.8@latest
-	go1.18.8 download
+	go install golang.org/dl/go1.18.9@latest
+	go1.18.9 download
 
 #install fsfe reuse tool (https://git.fsfe.org/reuse/tool)
 # pre-conditions:

README.md

@@ -10,13 +10,9 @@ For the official SAP HANA client Go support (not this database driver) please se
 
 ## Version 1.0
 
-go-hdb version 1.0 is going to be released after Go 1.20 is available which is expected to be released in February 2023. The migration should be pretty straight forward. For details please refer to [Version 1.0](https://github.com/SAP/go-hdb/blob/main/VERSION1.0.md).
+go-hdb version 1.0 is going to be released after Go 1.20 is available which is expected to be released in February 2023. For migration details please refer to [Version 1.0](https://github.com/SAP/go-hdb/blob/main/VERSION1.0.md).
 
-When starting newly with this driver whether:
-- use the latest version (main branch)
-  - without switching to legacy mode
-  - without using any deprecated type
-- or use the latest 1.0 release candidate branch of this repository
+When starting newly with this driver please use the latest 1.0 release candidate branch of this repository
 
 ## Installation
 

RELEASENOTES.md

@@ -3,6 +3,10 @@ Release Notes
 
 ## Release 0.111
 
+Release 0.111.7 (upgrade urgency: no need for upgrade)
+
+- Changed version 1.0 migration description
+
 Release 0.111.6 (upgrade urgency: medium)
 
 - Fixed issue in reporting wrong number of affected rows using LOBs (https://github.com/SAP/go-hdb/pull/100)

VERSION1.0.md

@@ -1,16 +1,18 @@
-
 ## Version 1.0 Migration
 
 go-hdb version 1.0 is going to be released after Go 1.20 is available which is expected to be released in February 2023. The minimal Go version for go-hdb 1.0 is [Go 1.19](https://go.dev/doc/devel/release#go1.19).
 
-__To migrate to version 1.0 from the current latest version please switch off the connector 'legacy' mode (which is the default since version 0.107) and please replace the already deprecated type driver.NullTime by sql.NullTime.__
+### Migration to version 1.0 from the current latest version
+
+- Please switch off the connector 'legacy' mode (which is off by default since version 0.107).
+- Please replace the already deprecated type driver.NullTime by sql.NullTime.
+- Please replace all procedure calls using sql.Query methods with sql.Exec methods.
 
 ### Incompatible changes
 
-Removal of already deprecated driver.NullTime alias (please use sql.NullTime instead)
+Removal of already deprecated driver.NullTime alias (please use sql.NullTime instead).
 
 Bulk operations:
-
 - The following bulk operations available via legacy mode are no longer supported:
   - via query ("bulk insert ...")
   - via named arguments (Flush / NoFlush)
@@ -19,19 +21,16 @@ Bulk operations:
   - via extended parameter list with (len(args)%'#of paramerters' == 0
   - via function argument (func(args []any) error)
 
-Stored procedures with table output parameters:
-
-- Retrieving table output parameter content via separate query call is no longer supported (legacy mode)
-- Please use [sql.Rows](https://golang.org/pkg/database/sql/#Rows) instead (available since version 0.99)
+Stored procedures:
+- Calling stored procedures with sql.Query methods are no longer supported.
+- Please use sql.Exec methods instead and [sql.Rows](https://golang.org/pkg/database/sql/#Rows) for table output parameters.
 
 ### New features:
 
-- Stored procedures with parameters can now be executed by sql.Exec
-  - Support of [named](https://pkg.go.dev/database/sql#Named) parameters and
-  - Support of [out](https://pkg.go.dev/database/sql#Out) output parameters
+- Stored procedures executed by sql.Exec with parameters do
+  - support [named](https://pkg.go.dev/database/sql#Named) parameters and
+  - support [out](https://pkg.go.dev/database/sql#Out) output parameters
 
-   Exception: Stored procedures with table output parameters need further to be called by sql.Query ([example](https://github.com/SAP/go-hdb/blob/main/driver/example_call_test.go)).
-
 - Custom types for reading Lobs
 
   Whereas string and []byte types are supported as Lob input parameters for output parameters and query results (scan) the driver.Lob type was needed.

driver/driver.go

@@ -10,7 +10,7 @@ import (
 )
 
 // DriverVersion is the version number of the hdb driver.
-const DriverVersion = "0.111.6"
+const DriverVersion = "0.111.7"
 
 // DriverName is the driver name to use with sql.Open for hdb databases.
 const DriverName = "hdb"

go.mod

@@ -5,7 +5,7 @@ go 1.19
 require (
 	github.com/prometheus/client_golang v1.14.0
 	golang.org/x/crypto v0.4.0
-	golang.org/x/exp v0.0.0-20221208044002-44028be4359e
+	golang.org/x/exp v0.0.0-20221208152030-732eee02a75a
 	golang.org/x/text v0.5.0
 )
 

go.sum

@@ -22,8 +22,8 @@ github.com/prometheus/procfs v0.8.0 h1:ODq8ZFEaYeCaZOJlZZdJA2AbQR98dSHSM1KW/You5
 github.com/prometheus/procfs v0.8.0/go.mod h1:z7EfXMXOkbkqb9IINtpCn86r/to3BnA0uaxHdg830/4=
 golang.org/x/crypto v0.4.0 h1:UVQgzMY87xqpKNgb+kDsll2Igd33HszWHFLmpaRMq/8=
 golang.org/x/crypto v0.4.0/go.mod h1:3quD/ATkf6oY+rnes5c3ExXTbLc8mueNue5/DoinL80=
-golang.org/x/exp v0.0.0-20221208044002-44028be4359e h1:lTjJJUAuWTLRn0pXoNLiVZIFYOIpvmg3MxmZxgO09bM=
-golang.org/x/exp v0.0.0-20221208044002-44028be4359e/go.mod h1:CxIveKay+FTh1D0yPZemJVgC/95VzuuOLq5Qi4xnoYc=
+golang.org/x/exp v0.0.0-20221208152030-732eee02a75a h1:4iLhBPcpqFmylhnkbY3W0ONLUYYkDAW9xMFLfxgsvCw=
+golang.org/x/exp v0.0.0-20221208152030-732eee02a75a/go.mod h1:CxIveKay+FTh1D0yPZemJVgC/95VzuuOLq5Qi4xnoYc=
 golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sys v0.3.0 h1:w8ZOecv6NaNa/zC8944JTU3vz4u6Lagfk4RPQxv92NQ=
 golang.org/x/sys v0.3.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=