次の方法で共有

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 で使用できるアプリケーションの展開コマンドについて説明します。

コマンド 説明
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 ビッグ データ クラスターとは」を参照してください。