All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog.
- Cloud only: Added the capability to determine region metadata from OCI configuration. This enables using new regions that may not have been added to the SDK code yet, without having to specify a full NoSQL endpoint parameter. See Adding Regions for more information.
- Cloud only: Internal OCI
Regiondefinitions have been updated to be consistent. Some previous shorthandRegions have been removed, for exampleRegionPHXandRegionIAD. This should not affect any external usage, as theRegiondefinitions are intended for internal logic only. Interaction with the NoSQL APIs should always use region identifier strings, such asus-phoenix-1, or full endpoint strings, such asnosql.us-phoenix-1.oci.oraclecloud.com.
- Internal: updated tests for upcoming new "return existing row" semantics
- Native Structs: Added capability to use native structs in get/put/query. See Native Structs for details.
- Now requires Go 1.18 or higher
note: releases 1.4.4 and 1.4.5 were removed due to version incompatibilities.
- Cloud only: added support for Global Active Tables. This includes new requests and structs:
- AddReplicaRequest
- DropReplicaRequest
- ReplicaStatsRequest/Result
- ReplicaStats
- Replica as well as additional replica-related information in TableResult
- Latest Oracle Cloud Infrastructure regions and region codes: TYO, ABH, DAC, DOH, IZQ, UKY, XSP, RKT, SHJ, RUH, EBB, EBL
- Added support for array_collect() and count(distinct) in queries. These require server side support which is only available in Oracle NoSQL releases 23.3 and higher and will not be immediately available in the cloud service
- Changed copyrights to 2024
- Modified internal query processing to better support elasticity operations
- Added capability to use Session Token based authentication:
- NewSessionTokenSignatureProvider
- NewSessionTokenSignatureProviderFromFile
- Cloud only: added support to read region from system environment variable OCI_REGION if using user principal or session token authentication
- On premise only: Added support for default namespaces in requests
- Latest Oracle Cloud Infrastructure regions and region codes: OZZ, DRS
- Updated realm domain for OC22/NAP
- Latest Oracle Cloud Infrastructure regions and region codes: MTY, STR, BEG, VLL, YUM, VAP, BOG, AGA, NAP, AVZ
- Added new signature provider methods to allow for delegation (OBO) tokens to be used
with Instance Principals:
- NewSignatureProviderWithInstancePrincipalDelegation
- NewSignatureProviderWithInstancePrincipalDelegationFromFile
- On-premise only: added support for default namespace in config and namespace in requests.
- Updated yaml.v2 to 2.4.0
- Updated copyrights to 2023
- Changed Version tests to be tolerant of serial versions
Support for new, flexible wire protocol (V4):
The previous protocol is still supported for communication with servers that do not yet support V4. The version negotation is internal and automatic; however, use of V4 features will fail at runtime when attempted with an older server. Failure may be an empty or undefined result or an exception if the request cannot be serviced at all. The following new features or interfaces depend on the new protocol version:
-
added Durability to QueryRequest for queries that modify data
-
added pagination information to TableUsageResult and TableUsageRequest
-
added shard percent usage information to TableUsageResult
-
added IndexInfo.FieldTypes to return the type information on an index on a JSON field
-
added the ability to ask for and receive the schema of a query using
- PrepareRequest.GetQuerySchema
- PreparedStatement.GetQuerySchema
-
Cloud only: added use of ETags, DefinedTags and FreeFormTags in TableRequest and TableResult
-
Latest Oracle Cloud Infrastructure regions and region codes: SGU, IFP, GCN
- New GetBinary() convenience function
- Latest Oracle Cloud Infrastructure regions and region codes: TIW, ORD, BGY, MXP, DUS, DTM, ORK, SNN
- Fix for ARM64 compatibility issue #8
- Support for session persistence. If a Set-Cookie HTTP header is present the SDK will now set a Cookie header using the requested session value.
- Support for PKCS8 format private keys.
- Added latest Oracle Cloud Infrastructure regions and region codes: CDG, MAD, QRO.
- Added latest Oracle Cloud Infrastructure regions and region codes: LIN, MTZ, VCP, BRS, UKB, JNB, SIN, MRS, ARN, AUH, MCT, WGA.
- Cloud only: Added support for creating on-demand tables
- On-Prem only: Added support for setting Durability in put/delete operations
- Added support for returning row modification time in get operations
- TableLimits now includes a CapacityMode field, to allow for specifying OnDemand. The default is Provisioned. This may affect existing code if the TableLimits struct was created without using named fields.
- Internal logic now detects differences in server protocol version, and decrements its internal serial version to match. This is to maintain compatibility when a new driver is used with an old server.
- Added latest Oracle Cloud Infrastructure regions and region codes.
- Added support for ISO 8601 date strings with "Z" appended
- Added lint option to Makefile
- Rate Limiting (cloud only):
- New boolean nosqldb.Config.RateLimitingEnabled can enable automatic internal rate limiting based on table read and write throughput limits.
- If rate limiting is enabled:
- nosqldb.Config.RateLimiterPercentage can control how much of a table's full limits this client handle can consume (default = 100%).
- Result classes now have a GetRateLimitDelayed() method to return the amount of time an operation was delayed due to internal rate limiting.
- Now uses SHA256 for OCI IAM instance principal fingerprint
- Added generic GROUP BY and SELECT DISTINCT. These features will only work with servers that also support generic GROUP BY.
- Added support for creating a signature provider with Instance Principal and Resource Principal. These can be used to access NoSQL cloud service from within Oracle Compute Instances or Oracle Functions. Cloud only.
- Changed nosqldb.Region type to common.Region. Cloud applications need
to specify a value of
common.Regiontype for theRegionfield ofnosqldb.Configwhen initialize client configurations. This is a breaking change.
- Fixed a problem where the HTTP Host header was not being added in all request cases. This prevented use of an intermediate proxy such as Nginx, which validates headers. On-premise only.
This is the initial release of the Go SDK for the Oracle NoSQL Database. It supports both the on-premise product and the Oracle NoSQL Database Cloud Service.