---
title: Pre-release Archive Release Notes
description: Release notes for the 3.0 Alpha & Beta Releases
pubDate: 2026-08-17T09:53:44.266Z
antora:
  editUrl: https://github.com/couchbase/docs-sdk-dotnet/edit/temp/3.7/modules/project-docs/pages/3.0-pre-release-notes.adoc
  xref: xref:3.7@dotnet-sdk:project-docs:3.0-pre-release-notes.adoc[]
---

[Consult the llms.txt file for a full list of contents](/llms.txt)
[View original HTML](/dotnet-sdk/3.7/project-docs/3.0-pre-release-notes.html)

# Pre-release Archive Release Notes

> Release notes for the 3.0 Alpha & Beta Releases 

In the run-up to the SDK 3.0 API releases, several αλφα and βετα releases were made. Their release notes are maintained here for archive purposes. The 3.0 series release notes proper can be found [here](sdk-release-notes.md), along with install instructions for all supported platforms. Please note that none of the pre-releases listed below are supported; all _supported_ (GA) releases can be found [here](sdk-release-notes.md).

> [!WARNING]
> These are the pre-release α & β Release Notes maintained purely for archive and information purposes. These releases are unsupported. Supported (GA) releases can be found [on the general 3.x Release Notes page](sdk-release-notes.md).

# [](#version-3-0-0-beta4-21st-jan-2020)Version 3.0.0-beta4 (21st Jan 2020)

[Download](https://packages.couchbase.com/clients/net/3.0/Couchbase-Net-Client-3.0.0-beta4.zip) | [API Reference](https://docs.couchbase.com/sdk-api/couchbase-net-client-3.0.0-beta4) | [Nuget](https://www.nuget.org/packages/CouchbaseNetClient/3.0.0-beta4)

### [](#known-issues)Known Issues

* [NCBC-2187](https://issues.couchbase.com/browse/NCBC-2187): CollectionManager — 400: Not allowed on this version of cluster.
* [NCBC-2168](https://issues.couchbase.com/browse/NCBC-2168): QueryException does not provide textual details coming from the server.
* [NCBC-2153](https://issues.couchbase.com/browse/NCBC-2153): Fix failing integration tests for SDK3.
* [NCBC-2214](https://issues.couchbase.com/browse/NCBC-2214): N1QL situational test failure - SvcRestartQuery.
* [NCBC-2213](https://issues.couchbase.com/browse/NCBC-2213): N1QL situational test failure — Rb1SwapQuery.

### [](#fixed-issues)Fixed Issues

* [NCBC-2229](https://issues.couchbase.com/browse/NCBC-2229): Client context ID should be a UUID
* [NCBC-2231](https://issues.couchbase.com/browse/NCBC-2231): Remove Rows from the QueryResults
* [NCBC-2239](https://issues.couchbase.com/browse/NCBC-2239): CollectionNotFoundException when collections enabled as DP in CB 6.5-beta
* [NCBC-2240](https://issues.couchbase.com/browse/NCBC-2240): Cluster constructor duplicates Cluster connect
* [NCBC-2242](https://issues.couchbase.com/browse/NCBC-2242): Cluster exposes deferred analytics queries
* [NCBC-2243](https://issues.couchbase.com/browse/NCBC-2243): Cluster exposes "ClusterManager"
* [NCBC-2246](https://issues.couchbase.com/browse/NCBC-2246): QueryOptions do not align with the RFC
* [NCBC-2247](https://issues.couchbase.com/browse/NCBC-2247): QueryResult must have metadata not at the toplevel
* [NCBC-2249](https://issues.couchbase.com/browse/NCBC-2249): Bucket#views must be called Bucket#viewIndexes
* [NCBC-2250](https://issues.couchbase.com/browse/NCBC-2250): View MetaData must be called ViewMetaData
* [NCBC-2251](https://issues.couchbase.com/browse/NCBC-2251): AnalyticsOptions do not align with RFC
* [NCBC-2252](https://issues.couchbase.com/browse/NCBC-2252): AnalyticsResult must not expose deferred handle
* [NCBC-2253](https://issues.couchbase.com/browse/NCBC-2253): Analytics "MetaData" must be called "AnalyticsMetaData"
* [NCBC-2254](https://issues.couchbase.com/browse/NCBC-2254): Analytics MetaData does not align with the RFC
* [NCBC-2257](https://issues.couchbase.com/browse/NCBC-2257): GetAndLock argument not called expiry but lockTime
* [NCBC-2258](https://issues.couchbase.com/browse/NCBC-2258): Unlock must have cas as mandatory argument
* [NCBC-2259](https://issues.couchbase.com/browse/NCBC-2259): MutateIn must return MutateInResult
* [NCBC-2261](https://issues.couchbase.com/browse/NCBC-2261): GetOptions must not have WithCreatePath
* [NCBC-2262](https://issues.couchbase.com/browse/NCBC-2262): UpsertOptions must not take cas
* [NCBC-2263](https://issues.couchbase.com/browse/NCBC-2263): InsertOptions must not take cas
* [NCBC-2264](https://issues.couchbase.com/browse/NCBC-2264): GetAndTouchOptions must not take cas
* [NCBC-2265](https://issues.couchbase.com/browse/NCBC-2265): TouchOptions must not take cas
* [NCBC-2269](https://issues.couchbase.com/browse/NCBC-2269): BucketManager#UpsertBucketAsync should be UpdateBucketAsync
* [NCBC-2281](https://issues.couchbase.com/browse/NCBC-2281): Cannot bootstrap when cluster contains a non-k/v node
* [NCBC-2283](https://issues.couchbase.com/browse/NCBC-2283): missing not\_bounded in view stale consistency
* [NCBC-2296](https://issues.couchbase.com/browse/NCBC-2296): InvalidCastException in RetryOrchestrator

### [](#new-features-and-behavioral-changes)New Features and Behavioral Changes.

* [NCBC-2133](https://issues.couchbase.com/browse/NCBC-2133): Implement Retry Handling API - FTS, Analytics, Query, Views
* [NCBC-2208](https://issues.couchbase.com/browse/NCBC-2208): Add Circuit Breakers per RFC for KV
* [NCBC-2228](https://issues.couchbase.com/browse/NCBC-2228): Add Circuit Breakers per RFC for Services
* [NCBC-2020](https://issues.couchbase.com/browse/NCBC-2020): Use IAsyncEnumerable For Streaming Queries
* [NCBC-2223](https://issues.couchbase.com/browse/NCBC-2223): Update xUnit.net 2.4.0 to a later version
* [NCBC-2224](https://issues.couchbase.com/browse/NCBC-2224): Remove .netcoreapp2.1 from Couchbase.csproj
* [NCBC-2225](https://issues.couchbase.com/browse/NCBC-2225): Update Microsoft.NET.Test.Sdk to v16.4.0 in tests
* [NCBC-2226](https://issues.couchbase.com/browse/NCBC-2226): Add .NET Standard 2.1 Target
* [NCBC-2248](https://issues.couchbase.com/browse/NCBC-2248): All (non-default) collection APIs must be marked as volatile
* [NCBC-2255](https://issues.couchbase.com/browse/NCBC-2255): Use IAsyncEnumerable for View Queries
* [NCBC-2256](https://issues.couchbase.com/browse/NCBC-2256): Use IAsyncEnumerable for Analytics Queries
* [NCBC-2271](https://issues.couchbase.com/browse/NCBC-2271): Align QueryMetaData with the RFC
* [NCBC-2278](https://issues.couchbase.com/browse/NCBC-2278): Support asynchronous stream custom deserializers
* [NCBC-2284](https://issues.couchbase.com/browse/NCBC-2284): Convert IByteConverter from an interface to static implementation
* [NCBC-2285](https://issues.couchbase.com/browse/NCBC-2285): Public API Pre-3.0 Cleanup
* [NCBC-2291](https://issues.couchbase.com/browse/NCBC-2291): Add CancellationToken to ISaslMechanism.AuthenticateAsync
* [NCBC-2292](https://issues.couchbase.com/browse/NCBC-2292): Remove Optional<T> experiment
* [NCBC-2294](https://issues.couchbase.com/browse/NCBC-2294): Remove sync overloads for FTS search
* [NCBC-2295](https://issues.couchbase.com/browse/NCBC-2295): Replace Cluster.Connect with Cluster.ConnectAsync

# [](#version-3-0-0-beta3-20th-dec-2019)Version 3.0.0-beta3 (20th Dec 2019)

[Download](https://packages.couchbase.com/clients/net/3.0/Couchbase-Net-Client-3.0.0-beta3.zip) | [API Reference](https://docs.couchbase.com/sdk-api/couchbase-net-client-3.0.0-beta3) | [Nuget](https://www.nuget.org/packages/CouchbaseNetClient/3.0.0-beta3)

### [](#known-issues-2)Known Issues

* [NCBC-2187](https://issues.couchbase.com/browse/NCBC-2187): CollectionManager — 400: Not allowed on this version of cluster.
* [NCBC-2168](https://issues.couchbase.com/browse/NCBC-2168): QueryException does not provide textual details coming from the server.
* [NCBC-2153](https://issues.couchbase.com/browse/NCBC-2153): Fix failing integration tests for SDK3.
* [NCBC-2214](https://issues.couchbase.com/browse/NCBC-2214): N1QL situational test failure - SvcRestartQuery.
* [NCBC-2213](https://issues.couchbase.com/browse/NCBC-2213): N1QL situational test failure — Rb1SwapQuery.

### [](#fixed-issues-2)Fixed Issues

* [NCBC-2185](https://issues.couchbase.com/browse/NCBC-2185): Issue getting cluster map after Fo/Rebalance.
* [NCBC-2190](https://issues.couchbase.com/browse/NCBC-2190): Error returned on bucket.DefaultCollection().
* [NCBC-2191](https://issues.couchbase.com/browse/NCBC-2191): Services failing due to GetRandomNodeForService error.
* [NCBC-2205](https://issues.couchbase.com/browse/NCBC-2205): No View service found after failover EP node.
* [NCBC-2210](https://issues.couchbase.com/browse/NCBC-2210): Make EnableDnsSrveResolution be EnableDnsSrvResolution in ClusterOptions.
* [NCBC-2215](https://issues.couchbase.com/browse/NCBC-2215): KV port missing when bootstrapping with GCCCP.

### [](#new-features-and-behavioral-changes-2)New Features and Behavioral Changes.

* [NCBC-2206](https://issues.couchbase.com/browse/NCBC-2206): Support custom logging factories via ILoggerFactory.
* [NCBC-2207](https://issues.couchbase.com/browse/NCBC-2207): Remove all instances of 'master' to \`active'.
* [NCBC-2211](https://issues.couchbase.com/browse/NCBC-2211): Need to ensure that ClusterOptions properties are same as Foundation RFC.
* [NCBC-2212](https://issues.couchbase.com/browse/NCBC-2212): Align exception names with changes made to Error Handling RFC.
* [NCBC-2195](https://issues.couchbase.com/browse/NCBC-2195): Fix typo on cluster connect string validation.
* [NCBC-2196](https://issues.couchbase.com/browse/NCBC-2196): Correct typo on view query internal variable.
* [NCBC-2203](https://issues.couchbase.com/browse/NCBC-2203): Make all XxxOptions parameters optional and use defaults.
* [NCBC-2221](https://issues.couchbase.com/browse/NCBC-2221): NotImplementedException thrown by PersistentListTests.

# [](#version-3-0-0-beta2-20th-nov-2019)Version 3.0.0-beta2 (20th Nov 2019)

[Download](https://packages.couchbase.com/clients/net/3.0/CouchbaseNetClient.3.0.0-beta2.zip) | [API Reference](https://docs.couchbase.com/sdk-api/couchbase-net-client-3.0.0-beta2) | [Nuget](https://www.nuget.org/packages/CouchbaseNetClient/3.0.0-beta2)

### [](#known-issues-3)Known Issues

* .NET Client 3.0.0-beta2 only works with Couchbase Server 6.5 beta releases, and will not work with Couchbase 6.0 and earlier. This will be fixed in the upcoming .NET CLient 3.0.0-beta3.
* [NCBC-2187](https://issues.couchbase.com/browse/NCBC-2187): CollectionManager - 400: Not allowed on this version of cluster
* [NCBC-2168](https://issues.couchbase.com/browse/NCBC-2168): QueryException does not provide textual details coming from the server
* [NCBC-2153](https://issues.couchbase.com/browse/NCBC-2153): Fix failing integration tests for SDK3

### [](#fixed-issues-3)Fixed Issues

* [NCBC-1977](https://issues.couchbase.com/browse/NCBC-1977): LogManager.Test\_LogLevel\_Debug unit test intermittently fails CI
* [NCBC-2123](https://issues.couchbase.com/browse/NCBC-2123): FTS queries using wrong REST endpoint
* [NCBC-2136](https://issues.couchbase.com/browse/NCBC-2136): SDK doesn't apply updated cluster map during rebalance
* [NCBC-2137](https://issues.couchbase.com/browse/NCBC-2137): SDK does not retry NMVB responses
* [NCBC-2138](https://issues.couchbase.com/browse/NCBC-2138): NetworkType.Default should not use external hostname / ports
* [NCBC-2140](https://issues.couchbase.com/browse/NCBC-2140): Getting a document as a POCO doesn't serialize content properly
* [NCBC-2142](https://issues.couchbase.com/browse/NCBC-2142): Make ConfigPollInterval default to 2.5 Seconds
* [NCBC-2149](https://issues.couchbase.com/browse/NCBC-2149): ConfigConext throws NullReferenceException when processing new cluster maps
* [NCBC-2150](https://issues.couchbase.com/browse/NCBC-2150): BootstrapUri is null for non-bootstrapped nodes
* [NCBC-2160](https://issues.couchbase.com/browse/NCBC-2160): PublishDesignDocument should not remove \_dev version
* [NCBC-2161](https://issues.couchbase.com/browse/NCBC-2161): Update ViewQuery API to match SDK3 RFC
* [NCBC-2162](https://issues.couchbase.com/browse/NCBC-2162): Fix build warnings in CouchbaseCollectionTests.SendAsync
* [NCBC-2173](https://issues.couchbase.com/browse/NCBC-2173): Bootstrapping via config.json ignores connectionString property
* [NCBC-2186](https://issues.couchbase.com/browse/NCBC-2186): Fix regression where collection support is not detected on the server.
* [NCBC-2188](https://issues.couchbase.com/browse/NCBC-2188): When bootstrapping with GC3P the bootflag completed flag is not set
* [NCBC-2189](https://issues.couchbase.com/browse/NCBC-2189): Fix view unit test where design doc name does not match what is expected

### [](#new-features-and-behavioral-changes-3)New Features and Behavioral Changes

* [NCBC-2061](https://issues.couchbase.com/browse/NCBC-2061): Implement Retry Handling API - Config and K/V only
* [NCBC-1802](https://issues.couchbase.com/browse/NCBC-1802): CI Feature/Integration Test Completion for .NET SDK
* [NCBC-1869](https://issues.couchbase.com/browse/NCBC-1869): Support TLS/SSL encryption
* [NCBC-2065](https://issues.couchbase.com/browse/NCBC-2065): Review interface to verify "SDK 3" sdk-rfc compliance
* [NCBC-2134](https://issues.couchbase.com/browse/NCBC-2134): Add support for SSL/TLS connections
* [NCBC-2143](https://issues.couchbase.com/browse/NCBC-2143): Make config polling enabled by default
* [NCBC-2144](https://issues.couchbase.com/browse/NCBC-2144): Make NMVB publish config returned in body
* [NCBC-2145](https://issues.couchbase.com/browse/NCBC-2145): Update README with reference to release27 branch info
* [NCBC-2155](https://issues.couchbase.com/browse/NCBC-2155): Consolidate Cluster constructors
* [NCBC-2174](https://issues.couchbase.com/browse/NCBC-2174): Port Error Map from 2.X and integrate into 3.x
* [NCBC-2175](https://issues.couchbase.com/browse/NCBC-2175): Port diagnostics API from SDK 2 and update to 3.0 RFC
* [NCBC-2181](https://issues.couchbase.com/browse/NCBC-2181): Refactor exceptions and error handling to current RFC revision
* [NCBC-1846](https://issues.couchbase.com/browse/NCBC-1846): .NET Core configuration support for multiple providers
* [NCBC-2046](https://issues.couchbase.com/browse/NCBC-2046): Create zip and push to S3 during publishing
* [NCBC-2139](https://issues.couchbase.com/browse/NCBC-2139): Update View Index manager
* [NCBC-2154](https://issues.couchbase.com/browse/NCBC-2154): Add support for DNS-SRV
* [NCBC-2157](https://issues.couchbase.com/browse/NCBC-2157): Refactor cluster and bucket internals into a Context class
* [NCBC-2158](https://issues.couchbase.com/browse/NCBC-2158): Refactor Dispose pattern on cluster and context
* [NCBC-2171](https://issues.couchbase.com/browse/NCBC-2171): Make scope and collection definitions sync with RFC
* [NCBC-2184](https://issues.couchbase.com/browse/NCBC-2184): Exists should use getMeta instead of observe

# [](#version-3-0-0-beta1-3rd-oct-2019)Version 3.0.0-beta1 (3rd Oct 2019)

[Download](https://packages.couchbase.com/clients/net/3.0/CouchbaseNetClient.3.0.0-beta1.zip) | [API Reference](https://docs.couchbase.com/sdk-api/couchbase-net-client-3.0.0-beta1) | [Nuget](https://www.nuget.org/packages/CouchbaseNetClient/3.0.0-beta1)

### [](#known-issues-4)Known Issues

* [NCBC-2137](https://issues.couchbase.com/browse/NCBC-2137): SDK does not retry NMVB responses

### [](#fixed-issues-4)Fixed Issues

* [NCBC-1992](https://issues.couchbase.com/browse/NCBC-1992): Query fails if bucket does not bootstrap when G3CP not supported
* [NCBC-2035](https://issues.couchbase.com/browse/NCBC-2035): Default transcoder is having issues with deserialize
* [NCBC-2043](https://issues.couchbase.com/browse/NCBC-2043): Make IBucketInternal.Send implicit (hidden) in CouchbaseBucket
* [NCBC-2048](https://issues.couchbase.com/browse/NCBC-2048): Get and Exist return do not return CAS with result
* [NCBC-2067](https://issues.couchbase.com/browse/NCBC-2067): SDK3 LookupIn doesn't support retrieving full doc
* [NCBC-2068](https://issues.couchbase.com/browse/NCBC-2068): Add ClusterOptions to Cluster Ctor and static Connect method per RFC
* [NCBC-2070](https://issues.couchbase.com/browse/NCBC-2070): ConnectionExtension doesn't print bucket name when failing auth
* [NCBC-2073](https://issues.couchbase.com/browse/NCBC-2073): Add Collection accessor methods to IBucket w/CollectionOptions
* [NCBC-2074](https://issues.couchbase.com/browse/NCBC-2074): No way to get default Scope from the bucket
* [NCBC-2076](https://issues.couchbase.com/browse/NCBC-2076): Couchbase.Management.User name property does not match RFC
* [NCBC-2078](https://issues.couchbase.com/browse/NCBC-2078): Manager method names don't match RFC
* [NCBC-2079](https://issues.couchbase.com/browse/NCBC-2079): UserManager.create should be called upsert, and not throw UserAlreadyExistsException
* [NCBC-2080](https://issues.couchbase.com/browse/NCBC-2080): IUserManager.upsertUser signature doesn't match RFC
* [NCBC-2081](https://issues.couchbase.com/browse/NCBC-2081): User manager doesn't distinguish between innate roles and roles inherited from groups
* [NCBC-2082](https://issues.couchbase.com/browse/NCBC-2082): User Manager needs to be updated for latest RFC changes
* [NCBC-2083](https://issues.couchbase.com/browse/NCBC-2083): BucketSettings field names diverge from RFC
* [NCBC-2085](https://issues.couchbase.com/browse/NCBC-2085): Off-by-one error in subdoc threshold calculation
* [NCBC-2086](https://issues.couchbase.com/browse/NCBC-2086): Projections with more than 16 fields not implemented
* [NCBC-2088](https://issues.couchbase.com/browse/NCBC-2088): Fix bootstrapping isssues introduced by refactoring
* [NCBC-2089](https://issues.couchbase.com/browse/NCBC-2089): Unable to bootstrap if more than one scope/collection defined
* [NCBC-2091](https://issues.couchbase.com/browse/NCBC-2091): Sub-Document ArrayAppend and others stores each element as a JSON array
* [NCBC-2092](https://issues.couchbase.com/browse/NCBC-2092): Add array overloads to ArrayAppend, ArrayPrepend and ArrayInsert
* [NCBC-2095](https://issues.couchbase.com/browse/NCBC-2095): AggregateException when timeouts occur
* [NCBC-2096](https://issues.couchbase.com/browse/NCBC-2096): Fix build warnings
* [NCBC-2101](https://issues.couchbase.com/browse/NCBC-2101): There are no XXXOptions for Sub-Doc Operations/Specs
* [NCBC-2110](https://issues.couchbase.com/browse/NCBC-2110): Don't reorder bucket config nodeExts during bootstrap
* [NCBC-2126](https://issues.couchbase.com/browse/NCBC-2126): Update Query parameter types
* [NCBC-2132](https://issues.couchbase.com/browse/NCBC-2132): Bucket manager performing racey operations
* [NCBC-2135](https://issues.couchbase.com/browse/NCBC-2135): Extras are not correctly read for all operations
* [NCBC-2136](https://issues.couchbase.com/browse/NCBC-2136): SDK doesn't apply updated cluster map during rebalance

### [](#new-features-and-behavioral-changes-4)New Features and Behavioral Changes

* [NCBC-2063](https://issues.couchbase.com/browse/NCBC-2063): Add Datastructures v2 for "SDK3"
* [NCBC-2027](https://issues.couchbase.com/browse/NCBC-2027): Port HTTP Streaming from SDK 2.0
* [NCBC-2029](https://issues.couchbase.com/browse/NCBC-2029): Integrate HTTP streaming into Bootstrapping process when CCCP/GC3P not supported
* [NCBC-2099](https://issues.couchbase.com/browse/NCBC-2099): Add Scope accessor overloads to IBucket
* [NCBC-2100](https://issues.couchbase.com/browse/NCBC-2100): Add Collection accessor to IScope w/CollectionOptions
* [NCBC-2102](https://issues.couchbase.com/browse/NCBC-2102): GetAsync lacks ability to include expiry in result via Sub-Doc
* [NCBC-1930](https://issues.couchbase.com/browse/NCBC-1930): Decrease the default 'TcpKeepAliveTime' for SDK3
* [NCBC-1938](https://issues.couchbase.com/browse/NCBC-1938): Implement GetAnyReplica and GetAllReplicas methods
* [NCBC-2001](https://issues.couchbase.com/browse/NCBC-2001): Unify Nodes and NodesExt into a single structure
* [NCBC-2006](https://issues.couchbase.com/browse/NCBC-2006): Implement Search Index Manager
* [NCBC-2009](https://issues.couchbase.com/browse/NCBC-2009): Add Collection Manager
* [NCBC-2020](https://issues.couchbase.com/browse/NCBC-2020): Use IAsyncEnumerable For Streaming Queries
* [NCBC-2023](https://issues.couchbase.com/browse/NCBC-2023): Implement Memcached bucket
* [NCBC-2052](https://issues.couchbase.com/browse/NCBC-2052): Make SDK components support Unit Testing with Mocks
* [NCBC-2060](https://issues.couchbase.com/browse/NCBC-2060): Update enhanced prepared statements to use combined prepare & execute
* [NCBC-2064](https://issues.couchbase.com/browse/NCBC-2064): Add query service fast prepare support
* [NCBC-2066](https://issues.couchbase.com/browse/NCBC-2066): Refactor ConfigContext and Unit Tests
* [NCBC-2077](https://issues.couchbase.com/browse/NCBC-2077): Suggestion: separate namespaces for each management service
* [NCBC-2087](https://issues.couchbase.com/browse/NCBC-2087): Suggestion: separate namespace for KV service
* [NCBC-2093](https://issues.couchbase.com/browse/NCBC-2093): Move QueryClient with Action<QueryOptions> to extension method
* [NCBC-2104](https://issues.couchbase.com/browse/NCBC-2104): Add Transcoder/Serializer to options for all CRUD method on ICollection
* [NCBC-2108](https://issues.couchbase.com/browse/NCBC-2108): Refactor StaleState to ScanConsistency in ViewOptions
* [NCBC-2111](https://issues.couchbase.com/browse/NCBC-2111): Cluster implementation class should be internal
* [NCBC-2112](https://issues.couchbase.com/browse/NCBC-2112): Reorganise services into simplified structure
* [NCBC-2121](https://issues.couchbase.com/browse/NCBC-2121): Move expiry from IResult to IGetResult as it is now specific to Get operations.
* [NCBC-2124](https://issues.couchbase.com/browse/NCBC-2124): Replace bool flag values for StoreSemantics enum
* [NCBC-2125](https://issues.couchbase.com/browse/NCBC-2125): Refactor Parameters param to QueryOptions

# [](#version-3-0-0-alpha5-30th-july-2019)Version 3.0.0-alpha5 (30th July 2019)

[Download](https://packages.couchbase.com/clients/net/3.0/CouchbaseNetClient.3.0.0-alpha5.zip) | API Reference — N/A | [Nuget](https://www.nuget.org/packages/CouchbaseNetClient/3.0.0-alpha5)

### [](#known-issues-5)Known Issues

NA

### [](#fixed-issues-5)Fixed Issues

* [NCBC-1970](https://issues.couchbase.com/browse/NCBC-1970): Implementations of IOperation.GetValue hide XError response
* [NCBC-1987](https://issues.couchbase.com/browse/NCBC-1987): Add JsonProperty to Term
* [NCBC-1988](https://issues.couchbase.com/browse/NCBC-1988): Ensure only single XAttr commands are used with Sub-Doc
* [NCBC-1994](https://issues.couchbase.com/browse/NCBC-1994): Remove thread.sleep from unit tests
* [NCBC-1996](https://issues.couchbase.com/browse/NCBC-1996): Random LogManagerTests bug - Key Not Found thrown
* [NCBC-1998](https://issues.couchbase.com/browse/NCBC-1998): Invalid Encoding parameter causes HTTP 400 bad request in Query
* [NCBC-2011](https://issues.couchbase.com/browse/NCBC-2011): Allow LogManager's LoggerFactory to be set
* [NCBC-2014](https://issues.couchbase.com/browse/NCBC-2014): Don't throw PlatformNotSupported when unable to set KeepAlives
* [NCBC-2015](https://issues.couchbase.com/browse/NCBC-2015): Configuration loses values when chaining fluent methods together
* [NCBC-2032](https://issues.couchbase.com/browse/NCBC-2032): Single node cluster doesn't have nodeExt.Hostname set properly
* [NCBC-2034](https://issues.couchbase.com/browse/NCBC-2034): Cluster fails to bootstrap because cluster config is null
* [NCBC-2042](https://issues.couchbase.com/browse/NCBC-2042): JSON.NET uses Pascal casing instead of Camel casing on Ubuntu16

### [](#new-features-and-behavioral-changes-5)New Features and Behavioral Changes

* [NCBC-1960](https://issues.couchbase.com/browse/NCBC-1960): Add support for enhanced prepared queries
* [NCBC-1944](https://issues.couchbase.com/browse/NCBC-1944): Add cluster config manager component
* [NCBC-1985](https://issues.couchbase.com/browse/NCBC-1985): Provide config polling configuration settings and wireup
* [NCBC-1986](https://issues.couchbase.com/browse/NCBC-1986): Enable cluster map update changes to refresh client state
* [NCBC-1997](https://issues.couchbase.com/browse/NCBC-1997): Support G3CP bootstrapping
* [NCBC-1630](https://issues.couchbase.com/browse/NCBC-1630): Investigate JSON.NET async API
* [NCBC-1959](https://issues.couchbase.com/browse/NCBC-1959): Suffix all public asynchronous methods with 'Async'
* [NCBC-1990](https://issues.couchbase.com/browse/NCBC-1990): Support refreshing connections when terminated
* [NCBC-1991](https://issues.couchbase.com/browse/NCBC-1991): analytics using the .NET SDK at draft level
* [NCBC-1993](https://issues.couchbase.com/browse/NCBC-1993): Throw NetworkErrorException when connection broken
* [NCBC-1995](https://issues.couchbase.com/browse/NCBC-1995): Refresh error map and server features when creating new connection
* [NCBC-2000](https://issues.couchbase.com/browse/NCBC-2000): Allow SDKD to view SDK internals
* [NCBC-2003](https://issues.couchbase.com/browse/NCBC-2003): Add View Manager implementation
* [NCBC-2004](https://issues.couchbase.com/browse/NCBC-2004): Implement Bucket Manager
* [NCBC-2005](https://issues.couchbase.com/browse/NCBC-2005): Implement User Manager
* [NCBC-2007](https://issues.couchbase.com/browse/NCBC-2007): Implement Query Index Manger
* [NCBC-2010](https://issues.couchbase.com/browse/NCBC-2010): Fix build warnings
* [NCBC-2012](https://issues.couchbase.com/browse/NCBC-2012): Make DefaultCollection a function, not property
* [NCBC-2039](https://issues.couchbase.com/browse/NCBC-2039): Allow easy discoverability of configured services
* [NCBC-2040](https://issues.couchbase.com/browse/NCBC-2040): Query fails if no GCCCP and don't open a bucket
* [NCBC-2041](https://issues.couchbase.com/browse/NCBC-2041): Query API requires optional parameters
* [NCBC-2045](https://issues.couchbase.com/browse/NCBC-2045): Cluster service clients / manager should be lazily loaded

## [](#version-3-0-0-alpha4-11th-june-2019)Version 3.0.0-alpha4 (11th June 2019)

[Download](https://packages.couchbase.com/clients/net/3.0/CouchbaseNetClient.3.0.0-alpha4.zip) | API Reference — N/A | [Nuget](https://www.nuget.org/packages/CouchbaseNetClient/3.0.0-alpha4)

### [](#known-issues-6)Known Issues

NA

### [](#fixed-issues-6)Fixed Issues

* [NCBC-1958](https://issues.couchbase.com/browse/NCBC-1958): Couchbase.LoadTests can now build on on non-Windows platforms
* [NCBC-1962](https://issues.couchbase.com/browse/NCBC-1962): Connection used to bootstrap is returned to pool correctly
* [NCBC-1963](https://issues.couchbase.com/browse/NCBC-1963): Friend assemblies are ignored during packaging allowing solution to pack correctly
* [NCBC-1968](https://issues.couchbase.com/browse/NCBC-1968): XATTR parameter name in MutateIn now matches RFC
* [NCBC-1977](https://issues.couchbase.com/browse/NCBC-1977): InMemoryLog can add missing categories to prevent intermittent unit test failure
* [NCBC-1982](https://issues.couchbase.com/browse/NCBC-1982): FTS term unit test is no longer case sensitive to prevent intermittent unit test failure on Ubuntu

### [](#new-features-and-behavioral-changes-6)New Features and Behavioral Changes

* [NCBC-1950](https://issues.couchbase.com/browse/NCBC-1950): Improved support for automatic release publishing with CI
* [NCBC-1979](https://issues.couchbase.com/browse/NCBC-1979): Spatial view queries are no longer available on the bucket API, as they are not supported from Couchbase Data Platform 6.0, upwards
* [NCBC-1917](https://issues.couchbase.com/browse/NCBC-1917): Added support for ingesting Analytics queries into KV
* [NCBC-1961](https://issues.couchbase.com/browse/NCBC-1961): Improved bootstrapping, based upon the SDK 3.0 Bootstrapping RFC
* [NCBC-1972](https://issues.couchbase.com/browse/NCBC-1972): IConnection now has a single identity field

## [](#version-3-0-0-alpha3-26th-april-2019)Version 3.0.0-alpha3 (26th April 2019)

[Download](https://packages.couchbase.com/clients/net/3.0/CouchbaseNetClient.3.0.0-alpha3.zip) | API Reference — N/A | [Nuget](https://www.nuget.org/packages/CouchbaseNetClient/3.0.0-alpha3)

### [](#known-issues-7)Known Issues

NA

### [](#fixed-issues-7)Fixed Issues

* [NCBC-1893](https://issues.couchbase.com/browse/NCBC-1893): SDK 3.0 requires C# version 7.2 or greater
* [NCBC-1919](https://issues.couchbase.com/browse/NCBC-1919): Full Text Search Conjunctive Query - .Boost Type Mismatch
* [NCBC-1941](https://issues.couchbase.com/browse/NCBC-1941): Remove IntervalsVisibleTo ref for LoadTests project in Release mode

### [](#new-features-and-behavioral-changes-7)New Features and Behavioral Changes

* [NCBC-1940](https://issues.couchbase.com/browse/NCBC-1940): DotNet: Pathfind-author docs for SubDocument MutateIn
* [NCBC-1841](https://issues.couchbase.com/browse/NCBC-1841): Compatibility for 3.0
* [NCBC-1867](https://issues.couchbase.com/browse/NCBC-1867): Support pluggable logging w/default of MS
* [NCBC-1876](https://issues.couchbase.com/browse/NCBC-1876): Improve Query error handling
* [NCBC-1862](https://issues.couchbase.com/browse/NCBC-1862): Implement Binary operations
* [NCBC-1872](https://issues.couchbase.com/browse/NCBC-1872): Port and integrate Analytics client
* [NCBC-1873](https://issues.couchbase.com/browse/NCBC-1873): Port and integrate View client
* [NCBC-1874](https://issues.couchbase.com/browse/NCBC-1874): Port and integrate Search client
* [NCBC-1875](https://issues.couchbase.com/browse/NCBC-1875): Add Couchbase Connection string protocol support per RFC
* [NCBC-1881](https://issues.couchbase.com/browse/NCBC-1881): LEB128 algorithm performs unnecessary heap allocations
* [NCBC-1882](https://issues.couchbase.com/browse/NCBC-1882): Implement DefaultConverter Unit Tests In v3
* [NCBC-1884](https://issues.couchbase.com/browse/NCBC-1884): Reduce Heap Allocations In DefaultConverter
* [NCBC-1885](https://issues.couchbase.com/browse/NCBC-1885): Provide Span<T> based implementations on IByteConverter
* [NCBC-1886](https://issues.couchbase.com/browse/NCBC-1886): Replace init of empty byte arrays with Array.Empty
* [NCBC-1887](https://issues.couchbase.com/browse/NCBC-1887): Convert ReadExtras To Use ReadOnlySpan<T>
* [NCBC-1888](https://issues.couchbase.com/browse/NCBC-1888): Update ITypeSerialize To Deserialize From Memory<byte>
* [NCBC-1889](https://issues.couchbase.com/browse/NCBC-1889): Convert ITypeTranscoder.Decode To Use ReadOnlyMemory<byte>
* [NCBC-1890](https://issues.couchbase.com/browse/NCBC-1890): Update OperationHeaderExtensions To Use ReadOnlySpan<byte>
* [NCBC-1894](https://issues.couchbase.com/browse/NCBC-1894): Use Spans For Parsing SubDoc Operations
* [NCBC-1895](https://issues.couchbase.com/browse/NCBC-1895): Use Spans For GetValue on Operations
* [NCBC-1896](https://issues.couchbase.com/browse/NCBC-1896): Use Shared Memory Buffers For Operation Response Data
* [NCBC-1897](https://issues.couchbase.com/browse/NCBC-1897): Use Shared Memory Buffers For Result Objects
* [NCBC-1898](https://issues.couchbase.com/browse/NCBC-1898): SDK Load Test Framework
* [NCBC-1900](https://issues.couchbase.com/browse/NCBC-1900): Use OperationBuilder For OperationBase.CreateExtras
* [NCBC-1901](https://issues.couchbase.com/browse/NCBC-1901): Refactor ITypeTranscoder.Encode and ITypeSerializer.Serialize To Use Streams
* [NCBC-1902](https://issues.couchbase.com/browse/NCBC-1902): Drop Deprecated IByteConverter.ToXXX byte array based overloads
* [NCBC-1903](https://issues.couchbase.com/browse/NCBC-1903): Refactor IOperation.Write to IOperation.SendAsync
* [NCBC-1908](https://issues.couchbase.com/browse/NCBC-1908): Create OperationBuilder for building K/V operations
* [NCBC-1909](https://issues.couchbase.com/browse/NCBC-1909): Remove OperationBase.SendAsync Overrides For Non-SubDoc Operations
* [NCBC-1910](https://issues.couchbase.com/browse/NCBC-1910): Remove OperationBase.SendAsync Overrides For SubDoc Operations
* [NCBC-1911](https://issues.couchbase.com/browse/NCBC-1911): Use OperationBuilder For OperationBase.CreateKey
* [NCBC-1912](https://issues.couchbase.com/browse/NCBC-1912): Use OperationBuilder For OperationBase.CreateFramingExtras
* [NCBC-1914](https://issues.couchbase.com/browse/NCBC-1914): Use OperationBuilder For OperationBase.CreateBody
* [NCBC-1916](https://issues.couchbase.com/browse/NCBC-1916): Enhance OperationBuilder For SubDoc Operations
* [NCBC-1918](https://issues.couchbase.com/browse/NCBC-1918): Phase out ByteConverter.FromXXX byte array overloads
* [NCBC-1920](https://issues.couchbase.com/browse/NCBC-1920): Create Operation Write Performance Tests
* [NCBC-1921](https://issues.couchbase.com/browse/NCBC-1921): Optimize OperationBuilder.Write For MemoryPool On .Net Core 2.0 and Full Framework
* [NCBC-1922](https://issues.couchbase.com/browse/NCBC-1922): Fix Load Test Rate Limiter Performance
* [NCBC-1923](https://issues.couchbase.com/browse/NCBC-1923): Replace Enum.IsDefined in OperationBuilder.AdvanceToSegment
* [NCBC-1924](https://issues.couchbase.com/browse/NCBC-1924): Create Load Tests For OperationBase.ReadAsync
* [NCBC-1925](https://issues.couchbase.com/browse/NCBC-1925): Replace Enum.IsDefined In OperationHeaderExtensions.GetResponseStatus
* [NCBC-1928](https://issues.couchbase.com/browse/NCBC-1928): Use Bit Shifting For NBO Swap Where Possible
* [NCBC-1929](https://issues.couchbase.com/browse/NCBC-1929): Replace SemaphoreSlim In LoadTests RateLimiter
* [NCBC-1935](https://issues.couchbase.com/browse/NCBC-1935): Address GC Interference In Operation Read Tests
* [NCBC-1936](https://issues.couchbase.com/browse/NCBC-1936): Make Large Document Load Tests More Realistic
* [NCBC-1937](https://issues.couchbase.com/browse/NCBC-1937): Use Shared ArrayPool To Support Serialization/Deserialization

## [](#version-3-0-0-alpha2-20th-march-2019)Version 3.0.0-alpha2 (20th March 2019)

[Download](https://packages.couchbase.com/clients/net/3.0/CouchbaseNetClient.3.0.0-alpha2.zip) | NA\[API Reference\] | [Nuget](https://www.nuget.org/packages/CouchbaseNetClient/3.0.0-alpha2)

### [](#known-issues-8)Known Issues

NA

### [](#fixed-issues-8)Fixed Issues

* [NCBC-1878](https://issues.couchbase.com/browse/NCBC-1878): NullException when using a collection-less server version

### [](#new-features-and-behavioral-changes-8)New Features and Behavioral Changes

NA

## [](#version-3-0-0-alpha-12th-march-2019-do-not-use-use-3-0-0-alpha2-or-greater)Version 3.0.0-alpha (12th March 2019) DO NOT USE - USE 3.0.0-alpha2 or greater

[Download](https://packages.couchbase.com/clients/net/3.0/CouchbaseNetClient.3.0.0-alpha1.zip) | NA\[API Reference\] | [Nuget](https://www.nuget.org/packages/CouchbaseNetClient/3.0.0-alpha1)

### [](#known-issues-9)Known Issues

This release has the following known issues: \* [NCBC-1878](https://issues.couchbase.com/browse/NCBC-1878): NullException when using a collection-less server version

### [](#fixed-issues-9)Fixed Issues

* [NCBC-1851](https://issues.couchbase.com/browse/NCBC-1851): Fix struct immutability issues when using options/actions
* [NCBC-1852](https://issues.couchbase.com/browse/NCBC-1852): Use 'http' scheme for Query when 'couchbase://' scheme is used
* [NCBC-1854](https://issues.couchbase.com/browse/NCBC-1854): Query does not throw execeptions, but returns them as a property and a status
* [NCBC-1855](https://issues.couchbase.com/browse/NCBC-1855): Remove CouchbaseCollection2.cs
* [NCBC-1856](https://issues.couchbase.com/browse/NCBC-1856): Default parameter value for 'options' must be a compile-time constant
* [NCBC-1858](https://issues.couchbase.com/browse/NCBC-1858): LookupIn results in a Task canceled on every operation
* [NCBC-1865](https://issues.couchbase.com/browse/NCBC-1865): Error CS0579: Duplicate attributes

### [](#new-features-and-behavioral-changes-9)New Features and Behavioral Changes

* [NCBC-1789](https://issues.couchbase.com/browse/NCBC-1789): Add .NET KV Collections Protocol Plumbing
* [NCBC-1790](https://issues.couchbase.com/browse/NCBC-1790): Add new volatile Collections API to .NET
* [NCBC-1811](https://issues.couchbase.com/browse/NCBC-1811): Add Basic CRUD for SDK 3.0
* [NCBC-1812](https://issues.couchbase.com/browse/NCBC-1812): Add Basic Query for SDK 3.0
* [NCBC-1840](https://issues.couchbase.com/browse/NCBC-1840): Add Synchronous Durability Operations
* [NCBC-1857](https://issues.couchbase.com/browse/NCBC-1857): Migrate temp SDK 3.0 repo to github.com/couchbase/couchbase-net-client
* [NCBC-1864](https://issues.couchbase.com/browse/NCBC-1864): Update SDK 3.0 csproj Nuget information \*https://issues.couchbase.com/browse/NCBC-1850\[NCBC-1850\]: Remove CouchbaseCollectionsTests.cs - used as a POC for interface design
* [NCBC-1833](https://issues.couchbase.com/browse/NCBC-1833): Update Error Handling for SDK3
* [NCBC-1847](https://issues.couchbase.com/browse/NCBC-1847): Move integration tests into Couchbase.IntergrationTests project
* [NCBC-1848](https://issues.couchbase.com/browse/NCBC-1848): Remove all named parameters
* [NCBC-1849](https://issues.couchbase.com/browse/NCBC-1849): Discussion: Make Options consistent - use either properties or methods
* [NCBC-1853](https://issues.couchbase.com/browse/NCBC-1853): Make VBucket.VBucketIndex a short
* [NCBC-1859](https://issues.couchbase.com/browse/NCBC-1859): Update Cluster creation / initialization
* [NCBC-1860](https://issues.couchbase.com/browse/NCBC-1860): Fix Jenkins build scripts post v3 migration to gerrit/master
* [NCBC-1861](https://issues.couchbase.com/browse/NCBC-1861): Don't reference Couchbase.UnitTests in Release mode