Usare un'app distribuita in un cluster Big Data di SQL Server tramite un servizio Web RESTful.

Articolo
08/08/2024

Si applica a: SQL Server 2019 (15.x)

Questo articolo descrive come usare un'applicazione distribuita in un cluster Big Data di SQL Server tramite un servizio Web RESTful.

Importante

Il componente aggiuntivo per i cluster Big Data di Microsoft SQL Server 2019 verrà ritirato. Il supporto per i cluster Big Data di SQL Server 2019 terminerà il 28 febbraio 2025. Tutti gli utenti esistenti di SQL Server 2019 con Software Assurance saranno completamente supportati nella piattaforma e fino a quel momento il software continuerà a ricevere aggiornamenti cumulativi di SQL Server. Per altre informazioni, vedere il post di blog relativo all'annuncio e Opzioni per i Big Data nella piattaforma Microsoft SQL Server.

Prerequisiti

Cluster Big Data di SQL Server
Interfaccia della riga di comando di Azure Data (azdata)
App distribuita tramite azdata o l'estensione per la distribuzione di app

Nota

Quando il file di specifiche YAML dell'applicazione definisce una pianificazione, l'applicazione viene attivata tramite un processo cron. Se il cluster Big Data viene distribuito in OpenShift, l'avvio del processo cron richiede funzionalità aggiuntive. Per istruzioni specifiche, vedere le considerazioni relative alla sicurezza in OpenShift.

Funzionalità

Dopo aver distribuito un'applicazione in un cluster Big Data di SQL Server 2019, è possibile accedervi e usarla tramite un servizio Web RESTful. In questo modo, è possibile integrare l'app da altri servizi o applicazioni, ad esempio un'app per dispositivi mobili o un sito Web. La tabella seguente descrive i comandi per la distribuzione di applicazioni che è possibile usare con azdata per ottenere informazioni sul servizio Web RESTful per l'app.

Comando	Descrizione
`azdata app describe`	Descrive un'applicazione.

È possibile ottenere informazioni con il parametro --help, come nell'esempio seguente:

azdata app describe --help

Le sezioni seguenti descrivono come recuperare un endpoint per un'applicazione e come usare il servizio Web RESTful per l'integrazione dell'applicazione.

Recuperare l'endpoint

I cluster Big Data offrono endpoint a cui è possibile accedere e che usano l'applicazione tramite un servizio Web RESTful. Lo scopo principale è quello di gestire l'interazione con altre applicazioni Web o applicazioni per dispositivi mobili ed essere più proattivi per tali architetture di microservizi. Il comando azdata app describe fornisce informazioni dettagliate sull'app, tra cui l'endpoint nel cluster. Viene usato in genere da uno sviluppatore di app per compilare un'app tramite il client Swagger e il servizio Web per interagire con l'app in modo RESTful.

Descrivere l'app eseguendo un comando simile all'esempio seguente:

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"
}

Prendere nota dell'indirizzo IP (10.1.1.3 in questo esempio) e del numero di porta (30080) nell'output.

In alternativa, è possibile trovare questa informazione facendo clic con il pulsante destro del mouse sull'opzione Gestisci nel server di Azure Data Studio, in cui sono visualizzati gli endpoint dei servizi elencati.

Generare un token di accesso JWT

Per accedere al servizio Web RESTful per l'app distribuita, prima di tutto è necessario generare un token di accesso JWT. L'URL per il token di accesso dipende dalla versione del cluster Big Data.

Versione	URL
GDR1	`https://[IP]:[PORT]/docs/swagger.json`
CU1 e versioni successive	`https://[IP]:[PORT]/api/v1/swagger.json`

In base all'output dell'esempio precedente, la versione CU4, l'indirizzo IP del controller (10.1.1.3 nell'esempio) e il numero di porta (30080), l'URL sarà simile al seguente:

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

Per informazioni sulle versioni, vedere Cronologia delle versioni.

Aprire l'URL appropriato nel browser usando l'indirizzo IP e la porta recuperati eseguendo il comando describe. Accedere con le stesse credenziali usate per azdata login.

Incollare il contenuto di swagger.json in Swagger Editor per determinare i metodi disponibili:

Swagger API

Si noti che l'app è costituita dal metodo GET e per ottenere il token userà il metodo POST. Poiché l'autenticazione per le app usa token JWT, è necessario ottenere un token usando lo strumento preferito per eseguire una chiamata POST al metodo token. Con lo stesso esempio, l'URL per ottenere il token JWT sarà simile al seguente:

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

L'output di questa richiesta genera un access_token JWT, necessario per chiamare l'URL per l'esecuzione dell'app.

Eseguire l'app usando il servizio Web RESTful

Esistono diversi modi per usare un'app in un cluster Big Data di SQL Server. È possibile, ad esempio, scegliere di usare il comando azdata app run.

È possibile aprire l'URL per l'oggetto swagger restituito durante l'esecuzione di azdata app describe --name [appname] --version [version] nel browser, che dovrebbe essere simile a https://[IP]:[PORT]/app/[appname]/[version]/swagger.json.

Nota

Sarà necessario accedere con le stesse credenziali usate per azdata login. Con lo stesso esempio, il comando sarà simile al seguente:

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

Passaggi successivi

Per altre informazioni, vedere Eseguire il monitoraggio delle applicazioni in cluster Big Data. È anche possibile fare riferimento ad altri esempi in Esempi di distribuzione di app.

Per altre informazioni sui cluster Big Data di SQL Server, vedere Che cosa sono i cluster Big Data di SQL Server 2019?.

Condividi tramite