Azure Data Explorer API の概要

  • [アーティクル]

Azure Data Explorer サービスは、次の通信エンドポイントをサポートしています。

  1. REST API エンドポイント。これを使用して、Azure Data Explorer でデータのクエリと管理を行うことができます。 このエンドポイントは、クエリと管理コマンドのKusto 照会言語をサポートします。
  2. MS-TDS エンドポイント。これは、Microsoft SQL Server 製品で使用される Microsoft の表形式データ ストリーム (TDS) プロトコルのサブセットを実装します。 エンドポイントでは、TDS バージョン 7.x と 8.0 がサポートされています。 このエンドポイントは、クエリのための SQL Server エンドポイントとの通信方法を認識しているツールで役立ちます。
  3. Azure サービスの標準的な手段である Azure Resource Manager (ARM) エンドポイント。 このエンドポイントは、Azure Data Explorer クラスターなどのリソースを管理するために使用されます。

REST API

Azure Data Explorer サービスと通信する主な手段は、サービスの REST API を使うことです。 この完全に文書化されたエンドポイントにより、呼び出し元は次のことが可能です。

  • クエリ データ
  • メタデータのクエリと変更
  • データの取り込み
  • サービスの正常性状態のクエリの実行
  • リソースの管理

異なる Azure Data Explorer サービスが、一般に提供されている同じ REST API を使って相互に通信しています。

REST API プロトコルを処理せずにサービスを使用する、クライアント ライブラリも多数用意されています。

MS-TDS

Azure Data Explorerでは、Microsoft SQL Server通信プロトコル (MS-TDS) がサポートされており、T-SQL クエリの実行に対する制限付きサポートが含まれています。 MS-TDS のサポートされているバージョンには、7.x と 8.0 が含まれます。 このプロトコルにより、ユーザーは、よく知られているクエリ構文 (T-SQL) とデータベース クライアント ツール (LINQPad、sqlcmd、Tableau、Excel、Power BI など) を使用して、Azure Data Explorer でクエリを実行できます。

詳細については、MS-TDS を参照してください。

クライアント ライブラリ

Azure Data Explorer には、上記のエンドポイントを使用してプログラムによるアクセスを容易にする多数のクライアント ライブラリが用意されています。

  • .NET SDK
  • Python SDK
  • R
  • Java SDK
  • Node SDK
  • Go SDK
  • PowerShell

ヒント

サンプル アプリ ジェネレーター ウィザードを使うと、クラスターに合わせて調整された作業アプリを作成し、好みのプログラミング言語でデータを取り込み、クエリを実行できます。 生成されたコードをベースラインとして使い、自由にコードを変更して、独自のアプリを作成できます。また、コードのセクションを独自のアプリにコピーすることもできます。 詳細については、サンプル アプリ ジェネレーター ウィザードに関するページを参照してください。

.NET Framework ライブラリ

.NET Framework ライブラリは、クラスターをプログラムで操作するための推奨される方法です。 多数の異なるライブラリが用意されています。

上記のライブラリでは、Azure Storage API や Microsoft Entra API などの Azure API が使用されています。

Python ライブラリ

Python クライアント ライブラリを使用すると、呼び出し元はデータ クエリと管理コマンドを送信できます。 詳細については、「 Kusto Python SDK」を参照してください。

R ライブラリ

R クライアント ライブラリを使用すると、呼び出し元はデータ クエリと管理コマンドを送信できます。 詳細については、「 Kusto R SDK」を参照してください。

Java SDK

Java クライアント ライブラリには、Java を使用してクラスターにクエリを実行する機能が用意されています。 詳細については、「 Kusto Java SDK」を参照してください。

Node SDK

Node SDK は Node LTS (現在 v6.14) と互換性があり、ES6 で構築されています。 詳細については、「 Kusto Node SDK」を参照してください。

Go SDK

Go クライアント ライブラリには、Go を使用してクラスターにクエリを実行、制御、取り込む機能が用意されています。 詳細については、「 Kusto Golang SDK」を参照してください。

PowerShell

.NET Framework ライブラリは、PowerShell スクリプトで使用できます。 詳細については、「 PowerShell から Kusto .NET クライアント ライブラリを使用する」を参照してください。

Monaco IDE の統合

monaco-kusto パッケージは、Monaco Web エディターとの統合をサポートしています。 Microsoft によって開発された Monaco エディターは、Visual Studio Code の基礎となります。 詳細については、monaco-kusto パッケージに関する記事を参照してください。