本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 查询和转换数据
<a name="v9-panels-query-xform"></a>

****  
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。  
有关支持 Grafana 版本 12.x 的 Grafana 工作空间，请参阅。[在 Grafana 版本 12 中工作](using-grafana-v12.md)  
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

Grafana 支持多种类型的[数据来源](AMG-data-sources.md)。数据来源*查询*返回数据，供 Grafana *转换*和可视化。每个数据来源都使用自己的查询语言，而每个数据来源插件都实现了一个名为查询编辑器的查询构建用户界面。

## 关于查询
<a name="v9-panels-query-xform-about"></a>

Grafana 面板通过查询与数据来源通信，查询会检索数据进行可视化。查询是用数据来源使用的查询语言编写的问题。

您可以在面板的数据来源选项中配置查询频率和数据收集限制。Grafana 每个面板最多支持 26 个查询。

有关每个数据来源查询语言的更多信息，请参阅[数据来源](AMG-data-sources.md)部分。

**查询编辑器**

每个数据来源的*查询编辑器*都提供了一个自定义的用户界面，可帮助您编写利用其独特功能的查询。

由于查询语言之间的差异，每个数据来源查询编辑器的外观和功能都不同。根据您的数据来源，查询编辑器可能会提供自动完成功能、指标名称、变量建议或可视化查询构建界面。

有关特定数据来源的独特查询编辑器功能的详细信息，请参阅其文档：
+ [有关 Grafana 中包含的数据源，Built-in 请参阅数据源。](AMG-data-sources-builtin.md)
+ 有关 Grafana Enterprise 中包含的数据来源，请参阅 [连接到企业数据来源](AMG-data-sources-enterprise.md)。

**查询语法**

数据来源使用不同的查询语言来请求数据。有关特定数据来源的独特查询语言的详细信息，请参阅其文档。

**PostgreSQL 示例：**

```
SELECT hostname FROM host WHERE region IN($region)
```

**PromQL 示例：**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**特殊数据来源**

Grafana 还包含三种特殊数据来源：**Grafana**、**混合**和**控制面板**。有关详细信息，请参阅数据来源

## 导航查询选项卡
<a name="v9-panels-query-xform-navigate"></a>

面板的**查询**选项卡由以下元素组成：
+ **数据来源选择器**：选择要查询的数据来源。
+ **查询选项**：设置最大数据检索参数和查询运行时间间隔。
+ **查询检查器按钮**：打开查询检查器面板，您可以在其中查看和优化查询。
+ **查询编辑器列表**：列出您编写的查询。
+ **表达式**：使用表达式生成器创建警报表达式。有关表达式的更多信息，请参阅[编写表达式查询](v9-panels-query-xform-expressions.md)。

## 添加查询
<a name="v9-panels-query-xform-add"></a>

查询返回数据，供 Grafana 在控制面板面板中可视化。创建面板时，Grafana 会自动选择默认数据来源。

**添加查询**

1. 编辑要向其中添加查询的面板。

1. 选择 **Query**（查询）选项卡。

1. 选择**数据来源**下拉菜单并选择一个数据来源。

1. 选择**查询选项**以配置所需的最大数据点数。有关查询选项的更多信息，请参阅 [查询选项](#v9-panels-query-xform-options)。

1. 使用查询编辑器编写查询。

1. 选择**应用**。

Grafana 查询数据来源并将数据可视化。

## 管理查询
<a name="v9-panels-query-xform-manage"></a>

Grafana 在可折叠的查询行中整理查询。每个查询行都包含一个查询编辑器，并以字母（A、B、C 等）进行标识。

要管理查询，您可以复制查询、隐藏查询、产出查询、重新排序查询以及切换查询编辑器的帮助。

## 查询选项
<a name="v9-panels-query-xform-options"></a>

选择数据来源选择器旁边的**查询选项**，查看所选数据来源的设置。您在此处所做的更改仅影响在此面板中进行的查询。

Grafana 设置了以深灰色文本显示的默认值。更改以白色文本显示。要将字段恢复为默认设置，请从该字段中删除白色文本。

面板数据来源查询选项包括：
+ **最大数据点数**：如果数据来源支持该选项，则为返回的每个序列设置最大数据点数。如果查询返回的数据点数超过最大数据点设置，则数据来源将按 average、max 其他函数将其聚合在一起，来减少返回的数据点数。

  您可以限制点数以提高查询性能或平滑可视化线条。默认值是图形的宽度（或像素数），因为只有图形面板有足够的空间显示尽可能多的数据点，才能实现可视化。
+ **最小间隔**：为自动计算的间隔设置最小限制，通常是最小抓取间隔。如果每 15 秒保存一次数据点，低于此间隔不会对您有什么好处。您也可以将其设置为比抓取间隔更高的最小值，以检索更粗粒度且运行良好的查询。
+ **间隔**：按时间对数据点进行聚合或分组时可以使用的时间范围。

  Grafana 会自动计算适当的间隔，该间隔可用作模板化查询中的变量。变量以秒（`$__interval`）或毫秒（`$__interval_ms`）为单位。

  间隔通常用于 sum 或 average 等聚合函数。例如，这是一个使用间隔变量的 Prometheus 查询：`rate(http_requests_total[$__interval])`。

  此自动间隔是根据图形的宽度计算的。当用户缩小可视化时，间隔会增大，从而产生更粗粒度的聚合。同样，如果用户放大，间隔会减小，从而产生更细粒度的聚合。

  有关更多信息，请参阅 [全局变量](v9-dash-variable-add.md#v9-dash-variable-add-global)。
+ **相对时间**：覆盖各个面板的相对时间范围，使其与控制面板右上角控制面板时间选择器中所选择的时间不同。您可以使用此函数在同一控制面板上显示不同时间段或日期的指标。
**注意**  
当控制面板的时间范围为绝对值时，面板时间覆盖不起作用。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v9-panels-query-xform.html)
+ **时移**：通过相对于时间选取器移动面板的开始和结束时间，来覆盖各个面板的时间范围。例如，您可以将面板的时间范围移至比控制面板时间选择器早 2 小时。
**注意**  
当控制面板的时间范围为绝对值时，面板时间覆盖不起作用。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v9-panels-query-xform.html)
+ **缓存超时**：*（仅在数据来源中可用时才可见）*如果您的时间序列存储具有查询缓存，则覆盖默认缓存超时。将此值指定为数值（秒）。