次の方法で共有

ファイルからデータを取得する

データ インジェストは、1 つ以上のソースから Azure Data Explorer のテーブルにデータを読み込むプロセスです。 取り込まれたデータはクエリに使用できます。 この記事では、ローカル ファイルから新しいテーブルまたは既存のテーブルにデータを取得する方法について説明します。

データ インジェストの一般的な情報については、「 Azure Data Explorer データ インジェストの概要を参照してください。

前提条件

データを取得する

  1. 左側のナビゲーション ウィンドウで、[クエリ] を選択 します。

  2. データを取り込むデータベースを右クリックします。 データの取得を選択します。

    データベースを右クリックし、[オプションの取得] ダイアログが開いている [クエリ] タブのスクリーンショット。

データ ソースの選択

[データの取り込み] ウィンドウで [ソース] タブが選択されます。

使用可能な一覧からデータ ソースを選択します。 この例では、 ローカル ファイルからデータを取り込みます。

[ソース] タブが選択されている [データの取得] ウィンドウのスクリーンショット。

Note

インジェストでは、最大で 6 GB のファイル サイズがサポートされます。 100 MB から 1 GB の間のファイルを取り込むことをお勧めします。

データ インジェストを構成する

  1. ターゲット データベースとテーブルを選択します。 新しいテーブルにデータを取り込むには、[ + 新しいテーブル ] を選択し、テーブル名を入力します。

    Note

    テーブル名は、スペース、英数字、ハイフン、アンダースコアなど、最大 1,024 文字まで指定できます。 特殊文字はサポートされていません。

  2. ファイルをウィンドウにドラッグするか、[ ファイルの参照] を選択します。

    Note

    1,000 ファイルまで追加できます。 各ファイルは、最大 1 GB の非圧縮にすることができます。

    新しいテーブルが入力され、1 つのサンプル データ ファイルが選択されている [構成] タブのスクリーンショット。

  3. [次へ] を選択します。

検査

[検査] タブが開き、データのプレビューが表示されます。

インジェスト プロセスを完了するには、[完了] を選択します。

[検査] タブのスクリーンショット。

必要に応じて、次の操作を行います。

列の編集

Note

  • 表形式 (CSV、TSV、PSV) では、列を 2 回マップすることはできません。 既存の列にマップするには、最初に新しい列を削除します。
  • 既存の列の型を変更することはできません。 異なる形式の列にマップしようとすると、空の列になってしまう場合があります。

テーブルに加えることができる変更は、次のパラメーターによって異なります。

  • テーブルの種類が新規かまたは既存か
  • マッピングの種類が新規かまたは既存か
テーブルの種類です。 マッピングの種類 使用可能な調整
新しいテーブル 新しいマッピング 列の名前変更、データ型の変更、データ ソースの変更、マッピング変換、列の追加、列の削除
既存のテーブル 新しいマッピング 新しい列の追加 (その後、データ型の変更、名前変更、更新が可能)
既存のテーブル 既存のマッピング なし

編集のために開いている列のスクリーンショット。

マッピング変換

一部のデータ形式マッピング (Parquet、JSON、Avro) では、簡単な取り込み時の変換がサポートされています。 マッピング変換を適用するには、[列の編集] ウィンドウで列を作成または更新します。

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

  • DateTimeFromUnixSeconds
  • DateTimeFromUnixMilliseconds
  • DateTimeFromUnixMicroseconds
  • DateTimeFromUnixNanoseconds

データ型に基づく [詳細] オプション

表形式 (CSV、TSV、PSV):

  • 既存のテーブルに表形式を取り込む場合は、テーブル マッピング ドロップダウンを選択し、[既存のマッピングを使用] を選択できます。 表形式データには、ソース データを既存の列にマップするために使用される列名が必ずしも含まれるとは限りません。 このオプションをオンにすると、マッピングは順番に行われ、テーブル スキーマは同じままになります。

  • それ以外の場合は、新しいマッピングを作成します。

  • 最初の行を列名として使用するには、[ 先頭行ヘッダー] を選択します。

    マッピング オプションのスクリーンショット。

JSON:

  • JSON データの列分割を決定するには、 入れ子になったレベルを 1 から 100 まで選択します。

まとめ

[データ準備] ウィンドウでは、データ インジェストが正常に完了すると、3 つのステップすべてが緑色のチェック マークを表示します。 各手順で使用したコマンドを表示したり、取り込まれたデータのクエリ、視覚化、削除を行うカードを選択したりできます。

データ インジェストが完了した概要ページのスクリーンショット。

関連するコンテンツ

  • Last updated on