サンプル アプリ ジェネレーター ウィザードを使用して、データの取り込みとクエリを実行するためのコードを作成する

サンプル アプリ ジェネレーター ウィザードは、好みのプログラミング言語でデータを取り込み、クエリを実行するための作業アプリを作成できるツールです。 生成されたコードは、関連する SDK フレームワークを参照し、クラスターとデータに合わせて調整されます。 このアプリは、自己完結型の実行可能ファイルの例であり、認証を使用したクラスターへの接続、SDK を使用したデータの管理、取り込み、クエリの実行の方法を示します。

生成されたコードをベースラインとして使用して、自由にコードを変更して、独自のアプリを作成できます。また、コードのセクションを独自のアプリにコピーすることもできます。 コードには、ヒント、ベスト プラクティス、リファレンス資料へのリンク、および必要に応じてコードを変更する際に推奨される TODO 変更に関するコメントが含まれています。

前提条件

• Microsoft アカウントまたは Microsoft Entra ユーザー ID。 Azure サブスクリプションは不要です。
• Azure Data Explorer クラスターとデータベース。 クラスターとデータベースを作成します。
• Azure Data Explorer Web UI にサインインして、クラスターへの接続を追加します。

ウィザードにアクセスする

サンプル アプリ ジェネレーター ウィザードを使用すると、データ取り込み手順を画面の指示に従って行うことができます。

Azure Data Explorer Web UI からウィザードにアクセスするには:

1. 左側のペインで [クエリ] を選択します。

2. 目的のテーブルを右クリックし、 Generate>Sample コードを選択します。

   

サンプル アプリを生成する

ここでは、ウィザード全般について説明します。 選択するオプションは、取り込むデータ形式、取り込み元のデータ ソースの種類、新規または既存のテーブルに取り込むかどうかによって異なります。

ウィザードの指示に従って、次のオプションを選択します。

• 既存のテーブルへの取り込み
• 新しいテーブルへの取り込み
• データの取り込み:
  • Blob Storage
  • ローカル ファイル

宛先

[送信先] タブで、次の手順を実行します。

1. Cluster と Database を選択します。

2. Existing テーブルまたは New テーブルのどちらを使用するかを選択。 既存のテーブルの場合は、オプションからテーブルを選択します。 新しいテーブルの場合は、テーブルに名前を付けます。

3. アプリの プログラミング言語 を選択します。

   

4. [Next: Source](次へ: ソース) を選択します。

ソース

[ソース] タブで:

1. 次のオプションを選択します。

   • クエリと取り込み: インジェスト用のデータをアップロードし、指定されたデータのインジェストとクエリの両方に対応するコードを受け取ります。
   • クエリのみ: 前のタブで選択したテーブルに対してクエリを実行するコードを取得します。

2. Query と取り込みを選択した場合は、インジェスト用のソース ファイルまたは BLOB を選択します。

3. [Next: Schema](次へ: スキーマ) を選択します。

[スキーマ]

Schema タブでは、サービスによってスキーマとインジェストのプロパティが自動的に生成され、必要に応じて変更できます。 スキーマを設定するには:

1. 自動生成された 圧縮の種類を確認します。

2. インジェストのために Azure Data Explorer でサポートされている形式からData 形式を選択します。 形式によって仕様が異なります。

3. Partial データ プレビュー ウィンドウで、必要に応じてスキーマを調整します。 これを行うには、列の上部にある矢印を選択して、データ型の変更、新しい列の作成、列の削除などのオプションを含むメニューを開きます。 データが Parquet、JSON、または Avro 形式の場合は、 マッピング変換を適用できます。

   

4. 次へ: サンプル アプリの生成を選択します。

マッピング変換

Parquet、JSON、Avro のデータ形式では、簡単な取り込み時間変換がサポートされます。 マッピング変換を適用するには、 Partial データ プレビュー ウィンドウで列を作成または更新します。

マッピング変換は、データ型が int または long のソース データを使用して、文字列型または datetime 型の列に対して実行できます。 サポートされているマッピング変換は次のとおりです。

• DateTimeFromUnixSeconds
• DateTimeFromUnixMilliseconds
• DateTimeFromUnixMicroseconds
• DateTimeFromUnixNanoseconds

詳細については、「 マッピング変換」を参照してください。

作成

スキーマのマッピングと列の操作が完了すると、サンプル アプリ ジェネレーター ウィザードによってコード生成プロセスが開始されます。 コードを生成した後、サンプル アプリ プロジェクトを ZIP ファイルとしてダウンロードできるようになります。

選択した SDK でプロジェクトを実行するための詳細な手順は、正常に生成されると、サンプル プロジェクト ファイル内で提供されます。 さらに、ウィザードには、データの初期探索に Quick クエリ を使用するオプションが用意されています。

関連するコンテンツ

• Kusto クライアント ライブラリを使用するように開発環境を設定する