{"id":10128,"date":"2021-02-10T04:06:49","date_gmt":"2021-02-10T12:06:49","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=10128"},"modified":"2023-05-18T05:31:36","modified_gmt":"2023-05-18T12:31:36","slug":"new-features-in-couchbase-sdk-3-1","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/new-features-in-couchbase-sdk-3-1\/","title":{"rendered":"New Features in Couchbase SDK 3.1!"},"content":{"rendered":"

In the spring of 2020, we released the latest revamp of the Couchbase SDK: 3.0. Shipping alongside Couchbase Server 6.5.0 and offering early, experimental support for Scopes and Collections, it also included a completely new API and consistency across the different platforms. While SDK 3.0 was a significant milestone in the Couchbase history, it was just another incremental improvement for developers working with Couchbase Server. Couchbase Server continues to evolve adding new features and that is why we are now releasing Couchbase SDK 3.1.0 with even more improvements for things such as FTS Geo Polygon support and Bucket Durability Management amongst others.<\/p>\n

This post reviews each new feature added across all Couchbase SDKs. The examples are in C# but expect similar idiomatic implementations across all the SDKs whether it be Java, Go or another language.<\/p>\n

FTS Geo Polygon Support<\/h3>\n

To augment the two types of Geo queries, Point Distance<\/a> and Bounded Rectangle<\/a>, already supported by Couchbase, in 6.5.0 Geo Bounded Polygon queries<\/a> support was added. Point Distance queries are useful for finding things like restaurants near you and sorted distance near you. Bounded Rectangle Queries help find restaurants within a specific rectangular boundary near you, such as a city block. Geo Bounded Polygon Queries allows you to find restaurants within a random bounded polygon using an array of coordinate pairs as input parameters.<\/p>\n

 var query = new GeoPolygonQuery(new List<Coordinate>\r\n {\r\n    Coordinate.OfLatLon(37.79393211306212, -122.44234633404847),\r\n    Coordinate.OfLatLon(37.779958817339967, -122.43977141339417),\r\n    Coordinate.OfLatLon(37.788031092020155, -122.42925715405579),\r\n    Coordinate.OfLatLon(37.79026946582319, -122.41149020154114),\r\n    Coordinate.OfLatLon(37.79571192027403, -122.40735054016113),\r\n    Coordinate.OfLatLon(37.79393211306212, -122.44234633404847)\r\n }).Field(\"geo\");\r\n\r\n var results = await cluster.SearchQueryAsync(\"food-idx\", query);\r\n foreach (var result in results)\r\n {\r\n     \/\/do something with the results.\r\n }\r\n<\/pre>\n
You can read more about Geo Polygon queries in this blog post.<\/a><\/p>\n
Bucket Durability Management<\/h3>\n
Durability level guarantees<\/a> persistence for documents; whether or not a document has been persisted to disk and how many replicas it has been written to.<\/p>\n
In the older versions of Couchbase Server and SDK, durability level settings could only be provided via K\/V Operation, this could quickly turn into a repetitive and mundane process especially in the case where persistence guarantees were to be the same across all documents within a Bucket. Starting Couchbase Server 6.6 we can now add Durability as a setting on the Bucket level. This feature is now available for you via SDK 3.1 Couchbase Server 6.6 adds Bucket level durability which allows for a certain durability to be applied to all documents within a bucket. In Couchbase SDK 3.1.0 we continue the support into the SDKs using the Bucket Management API.<\/p>\n
var settings = new BucketSettings\r\n            {\r\n                Name = name,\r\n                BucketType = BucketType.Couchbase,\r\n                RamQuotaMB = 100,\r\n                EvictionPolicy = EvictionPolicyType.FullEviction,\r\n                DurabilityMinimumLevel = DurabilityLevel.Majority\r\n            };\r\n \r\n\/\/ create\r\nawait bucketManager.CreateBucketAsync(settings).ConfigureAwait(false);\r\n<\/pre>\n
The supported Durability levels are:<\/p>\n