使用 azdata 运行应用 - SQL Server 大数据群集

本文介绍如何在 SQL Server 大数据群集内运行应用程序。

重要

Microsoft SQL Server 2019 大数据群集附加产品将停用。 对 SQL Server 2019 大数据群集的支持将于 2025 年 2 月 28 日结束。 具有软件保障的 SQL Server 2019 的所有现有用户都将在平台上获得完全支持,在此之前,该软件将继续通过 SQL Server 累积更新进行维护。 有关详细信息,请参阅公告博客文章Microsoft SQL Server 平台上的大数据选项

先决条件

功能

在 SQL Server 2019 中,可以创建、删除、描述、初始化、列出运行和更新应用程序。 下表介绍了可以与 azdata 一起使用的应用程序部署命令。

Command 描述
azdata app describe 描述应用程序。
azdata app run 运行应用程序。

下面各部分详细说明了这些参数。

运行应用

如果应用处于 Ready 状态,则可以使用指定的输入参数运行它。 使用以下语法运行应用:

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

下面的示例命令演示了 run 命令:

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

如果运行成功,应会看到创建应用时所指定的输出。 以下输出是一个示例。

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

描述应用

describe 命令提供有关应用程序的详细信息,包括群集中的终结点。 应用开发人员通常使用此命令通过 swagger 客户端来生成应用,并使用 Web 服务以 RESTful 的方式与应用进行交互。 有关详细信息,请参阅在大数据群集上使用应用程序

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

如需了解如何将部署在 SQL Server 大数据群集 上的应用集成到自己的应用程序中,请参阅使用大数据群集上的应用程序获取详细信息。 有关其他示例,请参阅应用部署示例

有关 SQL Server 大数据群集的详细信息,请参阅 SQL Server 2019 大数据群集简介