Azure / azure-sdk-for-net

This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
MIT License
5.47k stars 4.8k forks source link

[QUERY] Why were index aliases removed from Azure.Search.Documents 11.6.0? #46003

Closed vanzegbroecke closed 1 month ago

vanzegbroecke commented 1 month ago

Library name and version

Azure.Search.Documents 11.6.0

Query/Question

Could you please explain to me what the reasoning is behind removing index aliases from version 11.6.0?

What is the proposed approach to rebuild an index without index aliases and without downtime?

Environment

No response

github-actions[bot] commented 1 month ago

Thank you for your feedback. Tagging and routing to the team member best able to assist.

jsquire commented 1 month ago

Hi @vanzegbroecke. Thanks for reaching out and we regret that you're experiencing difficulties. The reason that index aliases were removed for the v11.6.0 release is because they are a preview feature that is not supported in the stable version of the Azure Search service. This is discussed in Create an index alias in Azure AI Search and detailed in the REST API documentation Aliases - Create Or Update

A stable version of the client library is unable to depend on a preview version of the service. Should the feature progress to stable and support is added to the Search service, the client library will also support it. Likewise, should the feature continue to exist in the preview version of the Search service, the next preview release of the client library will support it.

Please be aware that our beta releases should be considered unstable and potentially disruptive changes should be expected from release-to-release. We do not guarantee that the public API will not change in our beta releases nor are those changes considered breaking. Our stable releases, on the other hand, do follow the .NET Breaking Change Rules per the Azure Design Guidelines.

Additional resources

github-actions[bot] commented 1 month ago

Hi @vanzegbroecke. Thank you for opening this issue and giving us the opportunity to assist. We believe that this has been addressed. If you feel that further discussion is needed, please add a comment with the text "/unresolve" to remove the "issue-addressed" label and continue the conversation.

github-actions[bot] commented 1 month ago

Hi @vanzegbroecke, since you haven’t asked that we /unresolve the issue, we’ll close this out. If you believe further discussion is needed, please add a comment /unresolve to reopen the issue.