ファイルからデータを取得する
データ インジェストは、1 つ以上のソースから Azure Data Explorer のテーブルにデータを読み込むプロセスです。 取り込まれたデータは、クエリに使用できるようになります。 この記事では、ローカル ファイルから新しいテーブルまたは既存のテーブルにデータを取得する方法について説明します。
データ インジェストの一般的な情報については、「Azure Data Explorer データ インジェストの概要」を参照してください。
前提条件
- Microsoft アカウントまたはMicrosoft Entraユーザー ID。 Azure サブスクリプションは不要です。
- Azure Data Explorer Web UI にサインインします。
- Azure Data Explorer クラスターとデータベース。 クラスターとデータベースを作成します。
データを取得
左側のメニューから [クエリ] を選択 します。
データを取り込むデータベースを右クリックします。 [データの取得] を選択します。
![データベースを右クリックし、[オプションの取得] ダイアログが開いているクエリ タブのスクリーンショット。](media/get-data-file/get-data.png)
![データベースを右クリックし、[オプションの取得] ダイアログが開いているクエリ タブのスクリーンショット。](media/get-data-file/get-data.png#lightbox)
source
[ データの取得 ] ウィンドウで、[ ソース ] タブが選択されています。
使用可能な一覧からデータ ソースを選択します。 この例では、 ローカル ファイルからデータを取り込みます。
![[ソース] タブが選択されている [データの取得] ウィンドウのスクリーンショット。](media/get-data-file/select-data-source.png#lightbox)
注意
インジェストでは、最大で 6 GB のファイル サイズがサポートされます。 100 MB から 1 GB の間のファイルを取り込むことをお勧めします。
構成
ターゲット データベースとテーブルを選択します。 新しいテーブルにデータを取り込む場合は、[ + 新しいテーブル ] を選択し、テーブル名を入力します。
注意
テーブル名には、スペース、英数字、ハイフン、アンダースコアなど、最大 1024 文字を指定できます。 特殊文字はサポートされていません。
ファイルをウィンドウにドラッグするか、[ファイルの 参照] を選択します。
注意
最大 1,000 個のファイルを追加できます。 各ファイルには、圧縮されていない最大 1 GB を指定できます。
![新しいテーブルが入力され、1 つのサンプル データ ファイルが選択された [構成] タブのスクリーンショット。](media/get-data-file/configure-tab.png)
[次へ] を選択します
![新しいテーブルが入力され、1 つのサンプル データ ファイルが選択された [構成] タブのスクリーンショット。](media/get-data-file/configure-tab.png#lightbox)
検査
[ 検査 ] タブが開き、データのプレビューが表示されます。
インジェスト プロセスを完了するには、[完了] を選択 します。
![[検査] タブのスクリーンショット。](media/get-data-file/inspect-data.png#lightbox)
省略可能:
- [ コマンド ビューアー] を選択して、入力から生成された自動コマンドを表示およびコピーします。
- スキーマ定義ファイルドロップダウンを使用して、スキーマの推論元のファイルを変更します。
- ドロップダウンから目的の形式を選択して、自動的に推論されるデータ形式を変更します。 インジェストについては、「Azure Data Explorer でサポートされているデータ形式」を参照してください。
- 列を編集します。
- データ型に基づく詳細オプションについて調べる。
列の編集
注意
- 表形式 (CSV、TSV、PSV) の場合、列を 2 回マップすることはできません。 既存の列にマップするには、最初に新しい列を削除します。
- 既存の列の型を変更することはできません。 異なる形式の列にマップしようとすると、空の列になってしまう場合があります。
テーブルに加えることができる変更は、次のパラメーターによって異なります。
- テーブルの種類が新規かまたは既存か
- マッピングの種類が新規かまたは既存か
| テーブルの種類です。 | マッピングの種類 | 使用可能な調整 |
|---|---|---|
| 新しいテーブル | 新しいマッピング | 列の名前変更、データ型の変更、データ ソースの変更、 マッピング変換、列の追加、列の削除 |
| 既存のテーブル | 新しいマッピング | 列の追加 (データ型の変更、名前の変更、更新が可能) |
| 既存のテーブル | 既存のマッピング | なし |
マッピング変換
一部のデータ形式マッピング (Parquet、JSON、Avro) では、簡単な取り込み時の変換がサポートされています。 マッピング変換を適用するには、[ 列の編集] ウィンドウで列を作成または更新します。
マッピング変換は、string 型または datetime 型の列に対して実行でき、ソースのデータ型は int または long です。 サポートされているマッピング変換は次のとおりです。
- DateTimeFromUnixSeconds
- DateTimeFromUnixMilliseconds
- DateTimeFromUnixMicroseconds
- DateTimeFromUnixNanoseconds
データ型に基づく詳細オプション
表形式 (CSV、TSV、PSV):
既存のテーブルに表形式を取り込む場合は、[詳細]> [現在のテーブル スキーマを保持する] を選択できます。 表形式データには、ソース データを既存の列にマップするために使用される列名が必ずしも含まれるとは限りません。 このオプションをオンにすると、マッピングは順番に行われ、テーブル スキーマは変わりません。 このオプションをオフにすると、データ構造に関係なく、受信データに対して新しい列が作成されます。
最初の行を列名として使用するには、[詳細設定>] [最初の行は列ヘッダー] の順に選択します。
JSON:
JSON データの列分割を決定するには、1 から 100 までの 高度な>入れ子になったレベルを選択します。
[詳細]>[データ形式のエラーを無視する] を選択した場合、データは JSON 形式で取り込まれます。 このチェック ボックスをオフのままにすると、データは multijson 形式で取り込まれます。
まとめ
[データ準備] ウィンドウでは、3 つの手順はすべて、データ インジェストが正常に完了したときに緑色のチェックマークでマークされます。 各ステップで使用されたコマンドを表示したり、取り込まれたデータのクエリ、視覚化、または削除を行うカードを選択できます。
関連コンテンツ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示