Ausführen von Apps mit azdata – Big Data-Cluster in SQL Server

  • Artikel

In diesem Artikel wird beschrieben, wie Sie eine Anwendung in einem Big Data-Cluster in SQL Server ausführen.

Wichtig

Das Microsoft SQL Server 2019-Big Data-Cluster-Add-On wird eingestellt. Der Support für SQL Server 2019-Big Data-Clusters endet am 28. Februar 2025. Alle vorhandenen Benutzer*innen von SQL Server 2019 mit Software Assurance werden auf der Plattform vollständig unterstützt, und die Software wird bis zu diesem Zeitpunkt weiterhin über kumulative SQL Server-Updates verwaltet. Weitere Informationen finden Sie im Ankündigungsblogbeitrag und unter Big Data-Optionen auf der Microsoft SQL Server-Plattform.

Voraussetzungen

Funktionen

In SQL Server 2019 können Sie Ihre Anwendung erstellen, löschen, beschreiben, initialisieren, auflisten und aktualisieren. In der folgenden Tabelle werden die Befehle für die Anwendungsbereitstellung beschrieben, die Sie mit azdata verwenden können.

Get-Help BESCHREIBUNG
azdata app describe Beschreiben einer Anwendung.
azdata app run Ausführen einer Anwendung.

In den folgenden Abschnitten werden diese Parameter eingehender beschrieben.

Ausführen einer App

Wenn sich die App in einem Ready-Status befindet, können Sie sie verwenden, indem Sie sie mit den angegebenen Eingabeparametern ausführen. Verwenden Sie die folgende Syntax zum Ausführen einer App:

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

Der folgende Beispielbefehl veranschaulicht den run-Befehl:

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

Wenn die Ausführung erfolgreich war, sollte die Ausgabe angezeigt werden, wie Sie beim Erstellen der App angegeben haben. Die folgende Ausgabe dient als Beispiel.

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

Beschreiben einer Anwendung

Der describe-Befehl stellt ausführliche Informationen zur App bereit, darunter auch den Endpunkt in Ihrem Cluster. Dieser wird in der Regel von einem App-Entwickler dazu verwendet, eine App mithilfe des Swagger-Clients zu erstellen und mithilfe des Webdiensts RESTful mit der App zu interagieren. Weitere Informationen finden Sie unter Nutzen von Anwendungen in Big Data-Clustern.

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

Zugehöriger Inhalt

Im Artikel Nutzen von Anwendungen auf Big Data-Clustern erfahren Sie, wie Sie Apps, die in Big Data-Cluster für SQL Server bereitgestellt wurden, in Ihre eigenen Anwendungen integrieren können. Weitere Beispiele finden Sie außerdem unter den Beispielen zur App-Bereitstellung.

Weitere Informationen zu Big Data-Cluster für SQL Server finden Sie unter Einführung in SQL Server 2019: Big Data-Cluster.