Condividi tramite

Eseguire le applicazioni con azdata - Cluster Big Data di SQL Server

  • Articolo

Questo articolo descrive come eseguire un'applicazione in cluster Big Data di SQL Server.

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

Funzionalità

In SQL Server 2019 è possibile creare, eliminare, descrivere, inizializzare, elencare, eseguire e aggiornare l'applicazione. La tabella seguente descrive i comandi per la distribuzione di applicazioni che è possibile usare con azdata.

Comando Descrizione
azdata app describe Descrive un'applicazione.
azdata app run Esegue un'applicazione.

Le sezioni seguenti descrivono più dettagliatamente questi comandi.

Eseguire un'app

Se lo stato dell'app è Ready, è possibile usarla eseguendola con i parametri di input specificati. Usare la sintassi seguente per eseguire un'app:

azdata app run --name <app_name> --version <app_version> --inputs <inputs_params>

L'esempio seguente mostra il comando run:

azdata app run --name add-app --version v1 --inputs x=1,y=2

Se l'esecuzione riesce, l'output sarà lo stesso di quello specificato quando è stata creata l'app. Di seguito è riportato un esempio di risultato.

{
  "changedFiles": [],
  "consoleOutput": "",
  "errorMessage": "",
  "outputFiles": {},
  "outputParameters": {
    "result": 3
  },
  "success": true
}

Descrivere un'app

Il comando 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. Per altre informazioni, vedere Utilizzare applicazioni in cluster Big Data.

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

Contenuto correlato

Per altre informazioni su come integrare nelle proprie applicazioni le app distribuite in cluster Big Data di SQL Server, vedere Utilizzare 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 Introduzione ai cluster Big Data di SQL Server 2019.