快速入门:在 Azure 数据资源管理器 Web UI 中查询数据

Azure 数据资源管理器是一项快速、完全托管的数据分析服务,用于对大量数据进行实时分析。 Azure 数据资源管理器提供了一种 Web 体验,使你能够连接到 Azure 数据资源管理器群集并编写、运行和共享 Kusto 查询语言命令和查询。 该 Web 体验可在 Azure 门户中使用,也可作为独立的 Web 应用程序(即 Azure 数据资源管理器 Web UI)使用。 Azure 数据资源管理器 Web UI 还可以由 HTML iframe 中的其他 Web 门户托管。 有关如何托管 Web UI 和所用 Monaco 编辑器的详细信息,请参阅 Monaco IDE 集成。 本快速入门将在独立的 Azure 数据资源管理器 Web UI 中进行操作。

Walkthrough of the Kusto Web Explorer experience in Azure Data Explorer web UI.

先决条件

登录应用程序

登录到应用程序

添加群集

首次打开应用程序时,不存在任何群集连接。

Add cluster.

开始运行查询前,必须先将连接添加到群集中。 本部分会将连接添加到 Azure 数据资源管理器 help 群集以及在先决条件中创建的测试群集中(可选)。

添加 help 群集

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

  2. 在应用程序的左上角,选择“添加群集”。

  3. 在“添加群集”对话框中,输入 URI https://help.chinaeast2.kusto.chinacloudapi.cn ,然后选择“添加” 。

  4. 在左侧窗格中,现在应看到 help 群集。 展开“示例”数据库并打开“Tables”文件夹,查看有权访问的示例表 。

    Find table in the help cluster in Azure Data Explorer web UI.

我们在本快速入门后面部分以及其他 Azure 数据资源管理器文章中使用 StormEvents 表。

添加群集

现在添加创建的测试群集。

  1. 选择“添加群集”。

  2. 在“添加群集”对话框中,以 https://<ClusterName>.<Region>.kusto.chinacloudapi.cn/ 格式输入测试群集 URL,然后选择“添加” 。 例如,https://mydataexplorercluster.chinaeast2.kusto.chinacloudapi.cn,如下图所示:

    Enter test cluster URL in Azure Data Explorer web UI.

  3. 在以下示例中,会看到 help 群集和一个新群集 docscluster.chinaeast2(完整 URL 为 https://docscluster.chinaeast2.kusto.chinacloudapi.cn/) 。

    Test cluster.

运行查询

你现在可以在两个群集上运行查询(假定测试群集中包含数据)。 在本文中,我们重点介绍 help 群集。

  1. 在左窗格中的 help 群集下,选择示例数据库 。

  2. 将以下查询复制并粘贴到查询窗口中。 在窗口顶部,选择“运行”。

    StormEvents
    | sort by StartTime desc
    | take 10
    

    此查询返回 StormEvents 表中的 10 条最新记录。 结果应如下表所示。

    Screenshot of a table that lists data for 10 storm events in Azure Data Explorer web UI.

    下图显示了应用程序的状态,其中添加了群集以及带有结果的查询。

    full screen in Azure Data Explorer web UI.

  3. 将以下查询复制并粘贴到第一个查询下方的查询窗口中。 请注意,它没有像第一个查询那样在单独行上进行格式化。

    StormEvents | sort by StartTime desc 
    | project StartTime, EndTime, State, EventType, DamageProperty, EpisodeNarrative | take 10
    
  4. 选择新查询。 按 Shift+Alt+F 设置查询格式,如以下查询所示。

    Formatted query.

  5. 选择“运行”或按 Shift + Enter 以运行查询。 此查询返回与第一条记录相同的记录,但仅包括 project 语句中指定的列。 结果应如下表所示。

    Screenshot of a table that lists the start time, end time, state, event type, damage property, and episode narrative for 10 storm events in Azure Data Explorer web UI.

    提示

    选择查询窗口顶部的“撤回”以显示第一个查询的结果集,而无需重新运行该查询。 通常在分析期间,会运行多个查询,通过“撤回”,你可以检索先前查询的结果。

  6. 让我们再运行一个查询来查看不同类型的输出。

    StormEvents
    | summarize event_count=count(), mid = avg(BeginLat) by State
    | sort by mid
    | where event_count > 1800
    | project State, event_count
    | render columnchart
    

    结果应如下图所示。

    Column chart.

    注意

    查询表达式中的空白行可能影响执行查询的那一部分。

    • 如果未选定文本,则假定以空行分隔查询或命令。
    • 如果选定了文本,则运行选定的文本。

使用结果网格

现在你已了解基本查询的工作原理,以后可以使用结果网格来自定义结果并进行进一步分析。

展开单元

展开单元有助于查看长字符串或 JSON 等动态字段。

  1. 双击某个单元格以打开展开的视图。 通过此视图可读取长字符串,并为动态数据提供 JSON 格式设置。

    Azure Data Explorer WebUI expand cell to show long strings.

  2. 单击结果网格右上方的图标以切换阅读窗格模式。 可为展开的视图选择以下阅读窗格模式:内联、下窗格和右窗格。

    Icon to change reading pane for expanded view mode - Azure Data Explorer WebUI query results.

展开行

当处理包含多个列的表时,展开整行可以轻松概览不同列及其内容。

  1. 单击要展开的行左侧的箭头 >

    Expand a row in the Azure Data Explorer WebUI.

  2. 在展开的行中,某些列处于展开状态(向下箭头),某些列处于折叠状态(向右箭头)。 单击这些箭头可以在这两种模式之间切换。

按结果归组为列

在结果中,可以按任何列对结果进行分组。

  1. 运行以下查询:

    StormEvents
    | sort by StartTime desc
    | take 10
    
  2. 将鼠标悬停在“州”列上,选择菜单,然后选择“按州分组” 。

    Group by state.

  3. 在网格中,双击“加利福尼亚州”,展开并查看该州的记录。 进行探索性分析时,此类型的分组可能会有所帮助。

    Screenshot of a query results grid with California group expanded in Azure Data Explorer web UI.

  4. 将鼠标悬停在“组”列上,然后选择“重置列” 。 此设置将网格返回到其原始状态。

    Reset columns.

使用值聚合

按列分组后,可以使用值聚合函数计算每个组的简单统计信息。

  1. 选择要计算的列的菜单。

  2. 选择“值聚合”,然后选择要对此列执行的函数类型。

    Aggregate results when grouping column by results in Azure Data Explorer web UI .

隐藏空列

通过在结果网格菜单上切换眼睛图标可以隐藏/取消隐藏空列。

Screenshot of eye icon to hide results grid in Azure Data Explorer web UI.

筛选列

可以使用一个或多个运算符来筛选某个列的结果。

  1. 若要筛选特定列,请选择该列的菜单。

  2. 选择“筛选”图标。

  3. 在筛选器生成器中,选择所需的运算符。

  4. 键入要用于筛选列的表达式。 键入时就会对结果进行筛选。

    注意

    筛选器不区分大小写。

  5. 若要创建多条件筛选器,请选择一个布尔运算符来添加另一个条件

  6. 若要删除筛选器,请删除第一个筛选条件中的文本。

    GIF showing how to filter on a column in the Azure Data Explorer WebUI.

运行单元格统计信息

  1. 运行以下查询。

    StormEvents
    | sort by StartTime desc
    | where DamageProperty > 5000
    | project StartTime, State, EventType, DamageProperty, Source
    | take 10
    
  2. 在结果网格中,选择一些数值单元格。 使用表网格,你可以选择多个行、列和单元格,并计算它们的聚合。 Web UI 当前支持以下数值函数:Average、Count、Min、Max 和 Sum 。

    select functions.

从网格向查询添加筛选器

筛选网格的另一种简单方法是直接从网格向查询添加筛选器运算符。

  1. 选择其中包含要为其创建查询筛选器的内容的单元格。

  2. 右键单击以打开“单元格操作”菜单。 选择“将选定内容添加为筛选器”。

    Add selection as filter to query from the grid results in Azure Data Explorer WebUI.

  3. 将在查询编辑器中向查询添加一个查询子句:

    Add query clause from filtering on the grid in Azure Data Explorer WebUI.

透视

透视模式功能类似于 Excel 的数据透视表,可用于在网格中执行高级分析。

通过透视可以获取列值并将其转换为列。 例如,可以对“州”进行透视,为“佛罗里达州”、“密苏里州”、“阿拉巴马州”等创建列。

  1. 在网格的右侧,选择“列”以查看表工具面板。

    Table tool panel.

  2. 选择“透视模式”,然后按以下方式拖动列:将“EventType”拖动到“行组”;将“DamageProperty”拖动到“值”,并将“State”拖动到“列标签” 。

    Pivot mode.

    结果应如以下数据透视表所示:

    Pivot table.

在结果网格中搜索

你可以在结果表中查找特定表达式。

  1. 运行以下查询:

    StormEvents
    | where DamageProperty > 5000
    | take 1000
    
  2. 单击右侧的“搜索”按钮,然后键入“Wabash”

    Search in the table.

  3. 所有提到的搜索表达式现在都在表中突出显示。 可以通过单击 Enter 向前移动或按 Shift + Enter 向后移动来在它们之间导航,也可以使用搜索框旁边的向上和向下按钮进行导航 。

    Navigate the Search results.

共享查询

很多时候,你希望共享创建的查询。

  1. 在查询窗口中,选择复制的第一个查询。

  2. 在查询窗口顶部,选择“共享”。

    Share menu.

下拉列表中提供了以下选项:

可提供深层链接,以便有权访问群集的其他用户可运行查询。

  1. 在“共享”中,选择“将查询链接到剪贴板” 。

  2. 将链接和查询复制到文本文件。

  3. 将链接粘贴到新的浏览器窗口中。 结果应如下所示

    Shared query deep link.

固定到仪表板

在 Web UI 中通过查询完成数据探索并找到所需的数据后,可将其固定到仪表板中以便持续监视。

若要固定查询:

  1. 在“共享”中,选择“固定到仪表板” 。

  2. 在“固定到仪表板”窗格中:

    1. 提供查询名称。
    2. 选择“使用现有查询”或“创建新查询” 。
    3. 提供仪表板名称
    4. 选择“创建后查看仪表板”复选框(如果是新仪表板)。
    5. 选择“固定”

    Pin to dashboard pane.

注意

“固定到仪表单”选项仅固定所选的查询。 要创建仪表板数据源并将显示命令转换为仪表板中的视觉对象,必须在数据库列表中选择相关数据库。

导出查询结果

要将查询结果导出到 CSV 文件,请选择“文件”>“导出到 CSV” 。

Export results to CSV file.

设置

在“设置”选项卡中,你可以:

选择右上方的设置图标 ,打开“设置”窗口。

Settings window.

导出和导入环境设置

导出和导入操作有助于保护工作环境,并将其重新定位到其他浏览器和设备。 导出操作可将所有设置、群集连接和查询选项卡导出到 JSON 文件,该文件可导入到其他浏览器或设备。

导出环境设置

  1. 在“设置”>“常规”窗口中,选择“导出” 。
  2. 此操作会将 adx-export.json 文件下载到本地存储中。
  3. 选择“清除本地状态”,将环境还原到其原始状态。 此设置将删除所有群集连接并关闭打开的选项卡。

注意

“导出”选项仅导出查询相关数据。 不会在 adx-export.json 文件中导出任何仪表板数据。

导入环境设置

  1. 在“设置”>“常规”窗口中,选择“导入” 。 然后在“警告”弹出窗口中,选择“导入” 。

    import warning.

  2. 从本地存储中找到 adx-export.json 文件,然后将其打开。

  3. 以前的群集连接和打开的选项卡现在可用。

注意

“导入”选项将替代任何现有的环境设置和数据。

突出显示错误级别

Kusto 会尝试解释结果面板中每行的严重性或详细级别,并对其进行相应的着色。 它通过将每列的非重复值与一组已知模式(“警告”、“错误”等)进行匹配来实现此目的。

启用错误级别突出显示选项

若要启用错误级别突出显示,请执行以下操作:

  1. 选择用户名旁边的“设置”图标。

  2. 选择“外观”选项卡,然后将“启用错误级别突出显示”选项切换到右侧。

    Animated GIF showing how to enable error-level highlighting in the settings.

浅色模式下的错误级别配色方案 深色模式下的错误级别配色方案
Screen shot of color legend in light mode. Screen shot of color legend in dark mode.

突出显示的列要求

对于突出显示的错误级别,列必须是 int、long 或 string 类型。

  • 如果列的类型为 longint
    • 列名必须为“Level”
    • 值只能包含 1 到 5 之间的数字。
  • 如果列的类型为 string
    • 可以将列名设置为 Level 以提升性能。
    • 此列只能包含下列值之一:
      • critical、crit、fatal、assert、high
      • error、e
      • warning、w、monitor
      • 信息
      • verbose、verb、d

将日期/时间更改为特定时区

可以更改显示的日期/时间值以反映特定的时区。 此更改仅影响显示内容,不会更改 Azure 数据资源管理器中的基础数据。

  1. 选择用户名旁边的“设置”图标。

  2. 选择“常规”选项卡,然后从下拉菜单中选择时区。

    Screen shot of general tab on settings blade to change time zone in Azure Data Explorer WebUI.

结果网格菜单栏中随后将显示所选时区。

Query time changed to UTC in results grid menu.

提供反馈

  1. 在应用程序的右上角,选择反馈图标

  2. 输入反馈,然后选择“提交”。

清理资源

未在此快速入门中创建任何资源,但如果要从应用程序中删除一个或两个群集,请右键单击群集并选择“删除连接”。 另一种选择是从“设置”>“常规”选项卡中选择“清除本地状态” 。此操作将删除所有群集连接并关闭所有打开的查询选项卡。

后续步骤

Azure 数据资源管理器的编写查询