本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Explore 中的关联编辑器
****
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
关联允许用户在任意两个数据来源之间建立链接。有关更多信息，包括关联概述，请参阅 [Grafana 10 版本中的关联](v10-correlations.md)。
## 创建关联
您可以从 Explore 页面创建关联。
**创建关联**
1. 在您的 Amazon Managed Grafana 工作区中，导航至 Explore 页面。
1. 选择要作为新关联来源的数据来源。
1. 运行查询，在支持的可视化中生成数据。
**注意**
支持的可视化为[日志](v10-panels-logs.md)和[表](v10-panels-table.md)。
1. 在顶部工具栏中选择 **\$1 添加**，然后选择**添加关联**（您也可以从[命令调色板](v10-search.md#v10-search-palette)中选择**关联编辑器**）。
Explore 现在处于关联编辑器模式，由蓝色边框和顶部栏指示。您可以在顶部栏中选择**退出**以退出关联编辑器。
1. 现在，您可以为可视化创建以下新的关联，其中包含附加到可用于构建新查询的数据的链接：
+ *日志*：链接显示在每个日志行的日志详细信息中的字段值旁。
+ *表*：每个表单元格都是一个链接。
1. 选择链接以添加新的关联。链接与用作关联结果字段的字段相关联。有关更多详细信息，请参阅[关联配置](v10-correlations-config.md)。
1. 在打开的拆分视图中，使用右侧窗格设置关联的目标查询来源。有关更多详细信息，请参阅[目标查询](v10-correlations-config.md#v10-correlations-config-target-query)。
1. 使用[变量语法](v10-dash-variable-syntax.md)生成目标查询，可从窗格顶部提供的列表中选择变量。该列表包含选定数据行中的样本值。
1. 提供标签和描述（可选）。标签将用作可视化中链接的名称，可包含变量。
1. 提供转换（可选；详情见下文）。
1. 在顶部工具栏中选择**保存**，以保存关联并退出关联编辑器模式。用于创建关联的链接将被每行中的数据链接所取代。选择链接后，您定义的查询将在另一个窗格中运行，变量将动态替换为所选行中的值。
## 转换
通过转换，可以提取字段中存在的值和其他数据。例如，通过转换，您可以提取日志行的一部分以用于关联。有关关联转换的更多信息，请参阅 [关联转换](v10-correlations-config.md#v10-correlations-config-transformations)。
在编辑器模式下选择一个生成的链接后，您可以在**转换**下拉菜单中选择**添加转换**来添加转换。
**在关联中使用转换**
1. 选择要应用转换的字段。选择要用于转换的字段。例如，日志行。一旦选中，此字段中的值可帮助您构建转换。
1. 选择转换的类型。有关选项和相关设置，请参阅 [关联转换](v10-correlations-config.md#v10-correlations-config-transformations)。
1. 根据您的选择，您可能会看到一个或多个变量填充，或者您可能需要在显示的选项中提供更多规范。
1. 选择**向关联添加转换**，将指定的变量添加到可用变量列表中。
**注意**
对于此对话框中的正则表达式，其他文档中引用的 `mapValue` 在此处称为 `Variable Name`。Grafana 会突出显示与字段值中的表达式匹配的任何文本。使用正则表达式捕获组来选择应提取的匹配部分。如果提供了有效的正则表达式，则变量和该变量的值将显示在 `Variable Name` 字段下方。
## 关联示例
以下示例说明了如何使用 Explore 中的关联编辑器创建关联。如果要遵循这些示例，请确保设置[测试数据来源](testdata-data-source.md)。
### 创建文本到图形的关联
此示例说明了如何使用 Explore 中的关联编辑器创建关联。
关联允许使用查询的结果在任何数据来源中运行新查询。在本例中，您将运行一个渲染表数据的查询。该数据将用于运行不同的查询，以生成图形结果。
要遵循此示例，请确保已设置[测试数据来源](testdata-data-source.md)。
**创建文本到图形的关联**
1. 在 Grafana 中，导航到 **Explore**。
1. 从页面左上角的下拉菜单中，选择**测试数据来源**。
1. 在右侧的下拉菜单中选择 **\$1 添加**，然后选择**添加关联**。
1. Explore 现在处于关联编辑器模式，由蓝色边框指示。
1. 从场景下拉菜单中选择以下场景：**CSV 文件**。
1. 选择文件 **population\$1by\$1state.csv**。每个单元格都是一个链接，单击后即可开始创建新的关联。
1. 单击 `State` 列中的任何单元格以创建新的关联，将数据链接附加到该条目。例如，选择 `California`。
1. 在拆分视图中，选择您在左侧窗格中选择的同一数据来源。查询编辑器上方的帮助程序包含可用于目标查询的所有可用变量。变量包含选定行中的所有数据字段（表列）。
1. 在**场景**菜单中，选择 **CSV 指标值**。查询编辑器中的 `String Input` 字段提供了具有每年人口值的变量：`${1980},${2000},${2020}`。这将使用变量值生成图形。
1. 在查询编辑器**别名**字段中，输入 `${State}`。
运行查询，查看其是否使用变量中的示例值生成图形。
1. 选择**保存**以保存关联并退出关联编辑器。
保存关联后，Explore 将在左侧窗格中重新运行查询。通过单击状态名称，将重新运行右侧的查询，并将该行的值插入 CSV，从而更改图形。每次单击状态名称时，都会使用更新的值重新运行查询。
您可以对任何数据来源应用相同的步骤。关联允许您在可视化中创建链接，以根据所选数据运行动态查询。在此示例中，我们使用查询返回的数据来构建新查询，以使用相同的数据来源生成不同的可视化效果。但您可以在任何数据来源之间创建关联，以创建自定义探索流程。
### 创建日志到表的关联
在此示例中，您将创建关联，以演示如何使用转换从日志行和另一个字段中提取值。
要遵循此示例，请确保已设置[测试数据来源](testdata-data-source.md)。
**创建日志到表的关联**
1. 在 Grafana 中，导航到 **Explore**。
1. 从页面左上角的下拉菜单中，选择**测试数据来源**。
1. 在右侧的下拉菜单中选择 **\$1 添加**，然后选择**添加关联**。
1. Explore 现在处于关联编辑器模式，由蓝色边框指示。
1. 在**场景**菜单中，选择**日志**。
1. 展开日志行以查看关联链接。选择 `Correlate with hostname`。
1. Explore 将在拆分视图中打开。选择您在左侧窗格中选择的同一数据来源。查询编辑器上方的帮助程序包含可用于目标查询的所有可用变量。
1. 展开转换部分，然后单击**添加转换**。
1. 在**字段**下拉菜单中，选择**消息**。日志行显示为示例数据。
1. 在**类型**下，选择 **Logfmt**。这将填充变量列表。
1. 选择**向关联添加转换**。
1. 再次选择**添加转换**，然后在**字段**下选择**主机名**。
1. 在**类型**下，选择**正则表达式**。
1. 在**表达式**下，输入以下内容：`-([0-9]\*)`。这将选择破折号右侧的任何数字。
1. 在**变量名称**下，输入以下内容：`hostNumber`。这将填充变量列表。
1. 选择**向关联添加变换**，将其添加到其他变量中。
1. 在数据来源编辑器中，打开**场景**下拉菜单，然后选择 **CSV 内容**。
1. 在下面的文本框中，提供以下内容并保存关联：
```
time,msg,hostNumber,status
${time},${msg},${hostNumber},${status}
```
这将关闭拆分视图并重新运行左侧查询。展开任何日志行以查看关联按钮。选择关联按钮将打开拆分视图，其中包含`time`（a 字段）、`msg`（使用 *logfmt* 从日志行中提取）、`host number`（使用*正则表达式*从 `hostname` 中提取）和 `status`（使用 *logfmt* 从日志行中提取）。