使用 Azure Data Explorer Web UI 向导创建外部表

外部表是引用存储在Azure Data Explorer数据库外部的数据的架构实体。 Azure Data Explorer Web 用户界面可以通过从存储容器获取示例文件,并基于这些示例创建架构来创建外部表。 然后,可以在外部表中分析和查询数据,而无需引入Azure Data Explorer。 有关简要概览,请参阅外部表。 有关创建外部表的不同方法的信息,请参阅 创建和更改Azure Storage外部表。 本文介绍如何使用创建向导体验创建外部表。

先决条件

创建外部表

  1. 在左侧菜单中,选择“查询”。

  2. 右键点击要在其中创建外部表的数据库。 选择“创建外部表”。

    屏幕截图显示从查询页面创建外部表的选项。

随即将打开“创建外部表”窗口,其中已选中“目标”选项卡 。

“目标”选项卡

  1. 系统会预填充“群集”和“数据库”字段。 可以从下拉菜单中选择其他目标。
  2. 在“表名称”中,输入表的名称。

    提示

    表名最多可包含 1,024 个字符,包括字母数字、连字符和下划线。 不支持特殊字符。

  3. 选择“下一步: 源”。

“目标”选项卡的屏幕截图,其中包含“群集”、“数据库”和“表名称”字段。

“源”选项卡

“链接到容器”中,可以通过两种方式添加容器:使用“选择容器”按钮添加容器,并使用“添加 URL”或“添加容器”按钮添加容器

最多可以添加 10 个源容器。

使用“选择容器”按钮添加容器

  1. 选择选择容器

    “源”选项卡中“选择容器”按钮的屏幕截图。

  2. 选择您的容器使用的订阅和存储帐户。

    “选择容器”窗口的屏幕截图。

  3. 选择 并添加。 验证完成后,容器链接右侧会显示绿色对勾标志。

    已验证容器链接的屏幕截图。

使用“添加 URL”或“添加容器”按钮添加容器

  1. 选择“添加 URL”或“添加容器”按钮 。

    “添加 URL”按钮的屏幕截图。

  2. 输入具有读取和列表权限的源容器的存储连接字符串。 验证完成后,容器链接右侧会显示绿色对勾标志。

    添加 SAS URL 的屏幕截图。

文件筛选器

使用“文件筛选器”筛选表应包含的文件。 可以按文件夹路径、文件开头或文件扩展名筛选文件。

选择架构定义文件的屏幕截图。

模式定义文件

第一个源容器显示 文件筛选器下方的文件

Azure Data Explorer 中创建外部表源选项卡的屏幕截图。

  1. 通过选中文件左侧的圆圈来选择架构定义文件。 此文件用于生成表架构。
  2. 选择下一步: schema。 此时会打开“架构”选项卡。

架构选项卡

在选项卡右侧,可以预览数据。 在左侧,可以向表定义添加 partitions,以便更快地access源数据并实现更好的性能。

注意事项

映射不是外部表定义的一部分,向导不支持它们。 如有必要,可以稍后配置映射。 某些功能(例如,删除 CSV 文件中的最后一列或更改 JSON 文件中的列名)需要映射才能正常工作。

  1. 选择“添加分区”。

     Azure Data Explorer 中外部表视图文件的屏幕截图。

  2. 分区窗口打开。 分区在文件的子路径上定义,可以使用 “路径前缀” 字段进行更改。 对于要应用的每个分区,请填写字段,如下所示:

    字段 说明 必需/可选
    分区名称 用于标识分区。 名称可以是任意值。 必需
    类型 数据分区列的数据类型。 必需
    数据列 用于分区的列。 虚拟列依据 URL 路径进行分区。 必需
    函数 应用到用于分区的数据列的函数。 可选
    函数参数 要在分区函数中使用的参数。 如果使用函数,则是必需的。
    路径前缀 用于定义分区的文件子路径。 此前缀将更改外部表的 URL(如“URI 预览”框中所示),并且应与架构定义文件 URI 匹配。 可选
    日期/时间模式 用于构造表 URI 路径的日期格式。 可选

    屏幕截图将分区添加到 Azure Data Explorer 中的外部表.

    例如,分区名称 CustomerName 建议用作分区依据的值位于 URL 的客户名称部分中。 前面的示例声明了两个分区:一个是以客户姓名为基础的分区,另一个是以嵌入在 URL 中的日期为基础的分区。

    注意事项

    虚拟列作为架构的一部分显示为从文件路径中提取的列数据,稍后可以在查询中使用此数据。

  3. 选择“添加分区”以添加另一分区。

  4. 选择“保存”。 添加的分区现在会显示在左侧窗格中的“分区”列表内。 不能在预览版中更改分区列。

    Azure Data Explorer 的架构外部表的截图.

  5. 选择“下一步: 创建表”。 创建表时,将打开“外部表已成功创建”窗口。

  6. 若要查看用于创建表的命令,请选择“查看命令”。

    在 Azure Data Explorer 中成功创建外部表的截图。

  7. 若要撤消外部表创建操作,请选择工具>撤消

查询外部表

生成的表包含符合所定义条件的所有文件中的数据。 可以使用函数 external_table() 查询此表。 有关如何查询外部表的详细信息,请参阅查询外部表

在 Azure Data Explorer 中查询外部表时生成的表格输出屏幕快照。