Consumir um aplicativo implantado em Clusters de Big Data do SQL Server usando um serviço Web RESTful

Aplica-se a: SQL Server 2019 (15.x)

Este artigo descreve como consumir um aplicativo implantado em um cluster de Big Data do SQL Server usando um serviço Web RESTful.

Pré-requisitos

• Cluster de Big Data do SQL Server
• CLI de Dados do Azure (azdata)
• Um aplicativo implantado usando azdata ou a Extensão de implantação de aplicativo

Funcionalidades

Depois de implantar um aplicativo em seu Clusters de Big Data do SQL Server 2019, você pode acessar e consumir esse aplicativo usando um serviço Web RESTful. Isso permite a integração desse aplicativo usando outros aplicativos ou serviços (por exemplo, um aplicativo móvel ou site). A tabela a seguir descreve os comandos de implantação do aplicativo que você pode usar com azdata para obter informações sobre o serviço Web RESTful para seu aplicativo.

Obtenha ajuda com o parâmetro --help como no seguinte exemplo:

azdata app describe --help

As seções a seguir descrevem como recuperar um ponto de extremidade para um aplicativo e como trabalhar com o serviço Web RESTful para integração de aplicativos.

Recuperar o ponto de extremidade

Os Clusters de Big Data fornecem pontos de extremidade que você pode acessar e consumir o aplicativo usando um serviço Web RESTful. O principal objetivo é facilitar a interação com outros aplicativos Web ou móveis e ser mais proativo para essas arquiteturas de microsserviços. O comando azdata app describe fornece informações detalhadas sobre o aplicativo, incluindo o ponto de extremidade no cluster. Normalmente, isso é usado por um desenvolvedor de aplicativos para criar um aplicativo usando o cliente do Swagger e usando o serviço Web para interagir com o aplicativo de maneira semelhante ao RESTful.

Descreva seu aplicativo executando um comando semelhante ao seguinte exemplo:

azdata app describe --name add-app --version v1

{
  "input_param_defs": [
    {
      "name": "x",
      "type": "int"
    },
    {
      "name": "y",
      "type": "int"
    }
  ],
  "links": {
    "app": "https://10.1.1.3:30080/app/addpy/v1",
    "swagger": "https://10.1.1.3:30080/app/addpy/v1/swagger.json"
  },
  "name": "add-app",
  "output_param_defs": [
    {
      "name": "result",
      "type": "int"
    }
  ],
  "state": "Ready",
  "version": "v1"
}

Observe o endereço IP (neste exemplo, 10.1.1.3) e o número da porta (30080) na saída.

Uma das outras maneiras de obter essas informações é clicar com o botão direito do mouse em Gerenciar no servidor no Azure Data Studio, em que você encontrará os pontos de extremidade dos serviços listados.

Gerar um token de acesso JWT

Para acessar o serviço Web RESTful do aplicativo que você implantou, primeiro é preciso gerar um token de acesso JWT. A URL para o token de acesso depende da versão do cluster de Big Data.

Considerando a saída do exemplo anterior, a versão CU4 e o endereço IP do controlador (10.1.1.3 no exemplo) e o número da porta (30080), a URL seria assim:

   https://10.1.1.3 :30080/api/v1/swagger.json

Para obter informações sobre a versão, confira Histórico de versões.

Abra a URL adequada em seu navegador usando o endereço IP e a porta que você recuperou executando o comando describe. Entre com as mesmas credenciais usadas para o azdata login.

Cole o conteúdo de swagger.json no Editor de Swagger para entender quais métodos estão disponíveis:

Observe que o app é o método GET e para obter o token usaria o método POST. Como a autenticação para aplicativos usa tokens JWT, você precisará obter um token usando sua ferramenta favorita a fim de fazer uma chamada POST para o método token. Com o mesmo exemplo, a URL para obter o token JWT se pareceria com o seguinte:

   https://10.1.1.3 :30080/api/v1/token

A saída dessa solicitação fornecerá um access_token JWT, que será necessário para chamar a URL e executar o aplicativo.

Executar o aplicativo usando o serviço Web RESTful

Há várias maneiras de consumir um aplicativo nos Clusters de Big Data do SQL Server: você pode optar por usar o comando azdata app run.

Você pode abrir a URL para o swagger que foi retornado quando você executou azdata app describe --name [appname] --version [version] em seu navegador, que deve ser semelhante a https://[IP]:[PORT]/app/[appname]/[version]/swagger.json.

   azdata app describe --name add-app --version v1

Próximas etapas

Explore como Monitorar aplicativos em clusters de Big Data para obter mais informações. Confira também mais amostras em Amostras de implantação de aplicativo.

Para saber mais sobre Clusters de Big Data do SQL Server, confira O que são Clusters de Big Data do SQL Server 2019.