Go Proxy Client Library Release Notes

• Minor Release.

New Features

• Add TaskId() to ExecuteTask.
• [CLIENT-2721] - Make PartitionFilter.Retry public.

Improvements

• Clean up documentation and remove dependency of examples to the v6 version of the client.

Bug Fixes

• [CLIENT-2725] - QueryExecute (background query) does not work without operations.
• [CLIENT-2726] - Proxy does not handle invalid filter expression error in query.
• [CLIENT-2727] - Go proxy: Query Pagination never complete.
• [CLIENT-2728] - Fix an issue where Bin names were ignored if a FilterExpression was passed to the Query.
• [CLIENT-2732] - Go proxy: Not able to multiple query calls with the same statement.
• [CLIENT-2759] - Go proxy: Background query with Expression does not filter records.

• CAUTION
  • This is a breaking release. It is required to allow upgrading your programs to the Aerospike Server v7. This program upgrade process required as a prerequisite to upgrading your cluster, otherwise seemless cluster upgrade will not be possible. The changes and their rationale are documented in the following section.

Breaking Changes

• [CLIENT-2713] - Handle Normalized Integers in Maps and Lists.

  • Aerospike Server v7 normalizes all positive integers in Maps and Lists into unsigned values for various efficiency reasons, and returns them as uint64. This effectively means that the type of positive int64 values will be lost. Go client supported uint64 types in lists and maps, and this change breaks that functionality by normalizing the values and removing the sign bits in case they are not needed. To support all versions of the server before and after the v7 consistently, the Go client will now behave like other Aerospike smart clients and automatically convert all unsigned int64 values inside maps and lists into signed values. This means a math.MaxUint64 value in a List or Map will return as two's compliment: -1.

  • Example:

    client.Put(wpolicy, key, BinMap{"map": map[any]any{"max": uint64(math.MaxUint64), "typed": uint64(0)}})
    

    will return as:

    rec, err := client.Get(rpolicy, key)
    // rec.Bins will be:
    // BinMap{"map": map[any]any{"max": int64(-1), "typed": int64(0)}}
    

    • This will break all code that used to cast rec.Bins["map"].(map[any]any)["max].(uin64). As a result, all such code should cast to int64 and then convert back to uint64 via a sign switch.
    • If you didn't use uint64 values in Maps and Lists, you should not be affected by this change.
    • All the test cases that depended on the old behavior have been adapted to the new behavior.
• [CLIENT-2719] - Typed GeoJSON and HLL deserialization.
  • The Go client would read GeoJSON and HLL values back as string and []byte respectively. So if you read a record with bins of these types and wrote it directly back to the database, the type of these fields would be lost.
  • The new version addresses this issue, but could be a breaking change if you have code that casts the values to the old string and []byte. You now need to cast these values to GeoJSONValue and HLLValue types respectively.
• [CLIENT-2484] - Add returnType to supported ExpMapRemoveBy* and ExpListRemoveBy* methods.
• [CLIENT-2319] - Revise BatchReadAPIs to accept BatchReadPolicy argument. NewBatchReadOps no longer takes binNames and changes ops parameter to variadic for consistency.
  • Changes the following Public API:

    func NewBatchRead(key *Key, binNames []string) *BatchRead {
    func NewBatchReadOps(key *Key, binNames []string, ops []*Operation) *BatchRead {
    func NewBatchReadHeader(key *Key) *BatchRead {
    

    to

    func NewBatchRead(policy *BatchReadPolicy, key *Key, binNames []string) *BatchRead {
    func NewBatchReadOps(policy *BatchReadPolicy, key *Key, ops ...*Operation) *BatchRead {
    func NewBatchReadHeader(policy *BatchReadPolicy, key *Key) *BatchRead {
    

• Replace WritePolicy with InfoPolicy in client.Truncate.
• Remove the deprecated ClientPolicy.RackId. Use Policy.RackIds instead.

New Features

• [CLIENT-2712] [CLIENT-2710] - Support read replica policy in scan/query.
  • This includes PREFER_RACK which allows scan/query to be directed at local rack nodes when possible.
• [CLIENT-2434] - Use 'sindex-exists' command in DropIndexTask.
• [CLIENT-2573] - Support ExpRecordSize().
• [CLIENT-2588] - SINDEX Support for 'Blob' Type Elements.

Improvements

• [CLIENT-2694] - Use RawURLEncoding instead of RawStdEncoding in proxy authenticator.
• [CLIENT-2616] - Update dependencies to the latest, require Go 1.21.
• Remove HyperLogLog tests from the Github Actions suite.
• Remove Go v1.18-v1.20 from the Github Actions Matrix.
• Rename grpc proto definition files due to compiler limitations. Resolves #414

Bug Fixes

• [CLIENT-2318] - Fixes an issue where Expression in BatchPolicy takes precedence rather than BatchDeletePolicy in BatchDelete.

• This release updates the dependencies to mitigate security issues.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in an upcoming client release.

Bug Fixes

• [CLIENT-2869] - Update modules. Fix Allocation of Resources Without Limits or Throttling for golang.org/x/net/http2.

• Backport fix release.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in an upcoming client release.

New Features

• [CLIENT-2712], [CLIENT-2710] - Support read replica policy in scan/query.
  • This includes PREFER_RACK which allows scan/query to be directed at local rack nodes when possible.

Improvements

• Format all the code in the repository.

Bug Fixes

• [CLIENT-2759] - Go proxy: Background query with Expression does not filter records.
  • The filter expressions of wither policies will be used.
  • Priority is with the Query Policy for backwards compatibility.
• [CLIENT-2616] - Update more dependencies to the latest.
• [CLIENT-2618] - Support persistent map indexes.
• [CLIENT-2726] - Proxy does not handle invalid filter expression error in query.
• [CLIENT-2725] - QueryExecute (background query) does not work without operations.
• [CLIENT-2727] - Go proxy: Query Pagination never complete.
• [CLIENT-2732] - Go proxy: Not able to multiple query calls with the same statement.
• [CLIENT-2728] - Fix an issue where Bin names were ignored if a FilterExpression was passed to the Query.
• [CLIENT-2318] - Expression in BatchPolicy takes precedence rather than BatchDeletePolicy.
• [CLIENT-2434] - Use 'sindex-exists' command in DropIndexTask.
• [CLIENT-2694] - Use RawURLEncoding instead of RawStdEncoding in proxy authenticator.
• Rename GRPC proto definition files due to compiler limitations. Resolves #414

• Major feature release.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in an upcoming client release.

New Features

• Adds support for the Aerospike Proxy Server and DBaaS service.

• Major feature release.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in an upcoming client release.

New Features

• Adds support for the Aerospike Proxy Server and DBaaS service.