Azure Data Explorer Web UI ウィザードを使用して外部テーブルを作成する

外部テーブルは、Azure Data Explorer データベースの外部に格納されているデータを参照するスキーマ エンティティです。 Azure Data Explorer Web UI を使用すると、ストレージ コンテナーからサンプル ファイルを取得し、これらのサンプルに基づいてスキーマを作成することで、外部テーブルを作成できます。 その後、Azure Data Explorer に取り込まずに、データの分析やクエリを実行できます。 概要については、「外部テーブル」を参照してください。 外部テーブルを作成するさまざまな方法については、「Azure Storage の外部テーブルを作成および変更する」を参照してください。 この記事では、作成ウィザード エクスペリエンスを使用して外部テーブルを作成する方法について説明します。

前提条件

• Azure サブスクリプション。 無料の Azure アカウントを作成します。
• Azure Data Explorer クラスターとデータベース。 クラスターとデータベースを作成します。
• Azure Data Explorer Web UI にサインインして、クラスターへの接続を追加します。

外部テーブルを作成する

1. 左側のメニューで [クエリ] を選択します。

2. 外部テーブルを作成するデータベースを右クリックします。 [外部テーブル 作成を選択します。

   

[配信先] タブが選択された状態で [Create external table]\(外部テーブルの作成\) ウィンドウが開きます。

[配信先] タブ

1. [クラスター] と [データベース] の各フィールドには、値が事前に設定されています。 ドロップダウン メニューから別の配信先を選択できます。
2. [テーブル名] に、お使いのテーブルの名前を入力します。

   ヒント

   テーブル名には、英数字、ハイフン、およびアンダースコアを含む最大 1024 文字を使用できます。 特殊文字はサポートされていません。

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

[ソース] タブ

[コンテナーへのリンク] でコンテナーを追加するには 2 つの方法があります。[コンテナーの選択] ボタンでコンテナーを追加する方法と、[URL の追加] または [コンテナーの追加] ボタンでコンテナーを追加する方法です。

最大 10 個のソース コンテナーを追加できます。

[コンテナーの選択] ボタンを使用してコンテナーを追加する

1. [コンテナーの選択] を選択します。

   

2. お使いのコンテナーに関連付けられているサブスクリプションとストレージ アカウントを選択します。

   

3. 追加 ボタンを選択します。 検証が完了すると、コンテナー リンクの右側に緑色のチェックマークが表示されます。

   

[URL の追加] または [コンテナーの追加] ボタンを使用してコンテナーを追加する

1. [URL の追加] または [コンテナーの追加] ボタンを選択します。

   

2. 読み取りアクセス許可と一覧アクセス許可を持つソース コンテナーにstorage 接続文字列を入力します。 検証が完了すると、コンテナー リンクの右側に緑色のチェックマークが表示されます。

   

ファイル フィルター

[File filters]\(ファイル フィルター\) を使用して、テーブルに含める必要のあるファイルをフィルター処理します。 ファイルは、フォルダーのパス、ファイルの先頭、またはファイル拡張子に従ってフィルター処理できます。

スキーマ定義ファイル

最初のソース コンテナーによって、[File filters]\(ファイル フィルター\) の下にファイルが表示されます。

1. ファイルの左側にある円を選択して、スキーマ定義ファイルを選択します。 このファイルは、テーブル スキーマを生成するために使用されます。
2. [Next: Schema]\(次へ: スキーマ\) を選択します。 [スキーマ] タブが開きます。

スキーマ タブ

タブの右側で、データをプレビューできます。 左側では、ソース データにすばやくアクセスして、より優れたパフォーマンスを実現するために、テーブル定義にパーティションを追加できます。

Note

マッピングは外部テーブルの定義には含まれないため、このウィザードではサポートされていません。 マッピングは、必要に応じて後で構成できます。 CSV ファイル内の最後の列を削除したり、JSON ファイル内の列名を変更したりするための一部の機能では、正しく機能するためにマッピングが必要です。

1. [Add partition]\(パーティションの追加\) を選択します。

   

2. パーティションのウィンドウが開きます。 パーティションは、ファイルのサブパスに対して定義されます。これは、[パス プレフィックス] フィールドを使用して変更できます。 適用するパーティションごとに、次のようにフィールドに入力します。

   フィールド	説明	必須/省略可能
   パーティション名	パーティションの識別に使用されます。 任意の名前を入力できます。	必須
   Type	データ パーティション分割列のデータ型です。	必須
   データ列	パーティション分割に使用される列です。 仮想列は URL パスに従ってパーティション分割されます。	必須
   機能	パーティション分割に使用されるデータ列に適用される関数です。	省略可能
   Function argument (関数の引数)	パーティション関数で使用される引数です。	関数を使用する場合は必須です。
   パス プレフィックス	パーティション分割が定義されているファイルのサブパスです。 このプレフィックスによって、[Uri preview]\(URI プレビュー\) ボックスに表示されるように、外部テーブルの URL が変更されます。これは、スキーマ定義ファイルの URI と一致している必要があります。	省略可能
   Datetime pattern (日時パターン)	テーブルの URI パスを作成するために使用される日付の形式。	省略可能

   

   たとえば、CustomerName というパーティション名は、パーティション分割する値が、URL の顧客名の部分であることを示しています。 上の例では、2 つのパーティションが宣言されています。1 つは顧客名に対するパーティションで、もう 1 つは URL に埋め込まれた日付に対するパーティションです。

   Note

   仮想列は、ファイル パスから抽出された列データとしてスキーマの一部として表示されます。このデータは、後でクエリで使用できます。

3. [Add partition]\(パーティションの追加\) を選択して、もう 1 つのパーティションを追加します。

4. [保存] を選択します。 これで、追加したパーティションが左ペインの [パーティション] の一覧に表示されます。 パーティション分割された列は、プレビューでは変更できません。

   

5. [Next: Create table]\(次へ: テーブルの作成\) を選択します。 テーブルが作成されると、[External table successfully created]\(外部テーブルが正常に作成されました\) ウィンドウが開きます。

6. テーブルを作成するために使用されたコマンドを表示するには、[コマンドの表示] を選択します。

   

7. 外部テーブルの作成を元に戻すには、[ツール]>[元に戻す] を選択します。

外部テーブルにクエリを実行する

結果のテーブルには、上で定義した条件に一致するすべてのファイルのデータが含まれます。 external_table() 関数を使用して、このテーブルにクエリを実行できます。 外部テーブルにクエリを実行する方法の詳細については、「外部テーブルに対するクエリの実行」を参照してください。

関連するコンテンツ

• 外部テーブルの概要
• Azure Storage の外部テーブルを作成および変更する
• external_table() 関数
• チュートリアル: 一般的な演算子について学習する