Git Product home page Git Product logo

Comments (2)

brjohnstmsft avatar brjohnstmsft commented on May 22, 2024

Hi @anweiss

I'm on the Azure Search team and I work on the REST API and Azure Search SDK.

I'd like to clarify a few things about the state of the Azure Search SDKs as they relate to Swagger and AutoRest.

  • There is no shipping Azure Search Management SDK at this time. The Swagger spec under arm-search is used to generate a partial management client library that is used only for testing the main Search SDK. Eventually we will ship a Management SDK, but there has been very little customer demand for it to date, so it is not a priority for us right now.
  • The main Search SDK has no dependency on ARM because it is a data-plane SDK, not a management SDK. A customer would use the Search SDK to call directly to their Search service, not to ARM. If you opened this issue to track work strictly related to ARM, we should close it because it doesn't apply to the Search SDK that we're actually shipping today.
  • For various reasons, it is not possible (and will likely never be possible) to use AutoRest to generate all of the Search SDK code. There are a lot of details here, but the general problem is that Search returns a lot of structured data with schemas that aren't known until run-time. For strongly-typed languages that support generics, we'd like to provide our customers with ways to use their own model types. AutoRest was not designed to generate code that can do this. This means...
  • ...that in order for us to ship a Go SDK for Azure Search, it requires some effort on our part (it's not just a matter of running AutoRest on a Swagger spec and presto, there's a new SDK). Right now we're in the process of migrating our .NET SDK to AutoRest. After that, we'll evaluate which languages/platforms to support next. If there is real customer demand for Go, that would be great to hear about and I'd encourage you to contact me offline.

from azure-rest-api-specs.

anweiss avatar anweiss commented on May 22, 2024

Thanks for the insight @brjohnstmsft! I can reach out to you offline for more details.

from azure-rest-api-specs.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.