[Internal] Change Feed: Adds change feed retention policy to container configuration

[ealsur]

Description

This PR adds the Change Feed policy retention configuration to a container. Change Feed retention is used in Full Fidelity Change Feed and allows the user to define the time length during which deleted documents will be retained in the Change Feed.

Creating a Container with change feed retention

ContainerProperties containerProperties = new ContainerProperties("myContainer", "/pk");
containerProperties.ChangeFeedPolicy.FullFidelityRetention = TimeSpan.FromMinutes(5);

CosmosContainerResponse containerCreateResponse = await database.CreateContainerAsync(containerProperties, 5000);

With the Fluent extensions:

string containerName = "myContainer";
string partitionKeyPath = "/pk";

ContainerResponse containerResponse =
    await database.DefineContainer(containerName, partitionKeyPath)
        .WithChangeFeedPolicy(retention: TimeSpan.FromMinutes(5))
            .Attach()
        .CreateAsync();

Type of change

• New feature (non-breaking change which adds functionality)

[kirankumarkolli]

Preview gates on JAVA availability

[ghost]

Closing due to in-activity, pease feel free to re-open.

[fazil1987]

@ealsur,

ChangefeedPolicy property is public only in preview mode, when can we expect this to be public in all modes?

[ealsur]

@fazil1987 This is related to the Full Fidelity feature, and it is currently in public preview. GA of SDK APIs aligns with GA of the service feature, when the service feature announces GA, then so will the SDKs. I don't have any specific dates that I am aware of and can share.

[fazil1987]

Thanks for the info @ealsur. Just want to know, is this feature stable and reliable enough to use it in production given this is been there for 2 years? Also would like to know what's stopping this feature from getting into GA given PR was merged 2 years ago? Is it overlooked?

[ealsur]

@fazil1987 Features like this are driven by the service, not the client SDKs. Client SDKs just implement the APIs that customers can call to access these features, hence, the reason for a particular feature to be still in preview or when it will GA is directly defined by the service feature (the SDK will just move these APIs to the GA package once GA is achieved). How long until this feature is GA or if the feature is reliable to be used in production is not something that can be addressed in this repository because it is not directly related to the code here. I would not advise using any preview feature in production until the team explicitly states otherwise.
I would think that once the feature is ready, it will be announced through the public channels.