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

# 配置数据链接
<a name="v9-panels-configure-data-links"></a>

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

 您可以使用数据链接变量或数据链接来创建面板之间的链接。

## 数据链接变量
<a name="v9-panels-data-link-variables"></a>

 您可以使用数据链接中的变量来查看序列字段、标签和值。有关数据链接的更多信息，请参阅 [数据链接](#v9-panels-data-links)。

 要查看可用变量列表，请在数据链接 **URL** 字段中键入 **\$1**，以查看可使用的变量列表。

**注意**  
 这些变量在 6.4 中发生了变化，因此，如果您使用的是旧版 Grafana，请使用版本选择器为旧版本的 Grafana 选择文档。

 您也可以在数据链接中使用模板变量 URLs，请参阅[添加和管理控制面板变量](v9-dash-variables.md)。

## 时间范围面板变量
<a name="v9-panels-time-range-panel-variables"></a>

 您可以使用这些变量在数据链接 URL 中包含当前时间范围。
+  **\$1\$1url\$1time\$1range**：当前控制面板的时间范围（即 **?from=now-6h&to=now**） 
+  **\$1\$1\$1from 和 \$1\$1\$1to**：有关更多信息，请参阅 [全局变量](v9-dash-variable-add.md#v9-dash-variable-add-global)。

## 序列变量
<a name="v9-panels-series-variables"></a>

 特定于序列的变量在 **\$1\$1series** 命名空间下可用：
+  **\$1\$1series.name**：URL 的序列名称 

## 字段变量
<a name="v9-panels-field-variables"></a>

 特定于字段的变量在 **\$1\$1field** 命名空间下可用：
+  **\$1\$1field.name**：字段的名称 
+  **\$1\$1field.labels.<LABEL>**：URL 的标签值。如果标签包含点，则使用 **\$1\$1field.labels["<LABEL>"]** 语法。

## 值变量
<a name="v9-panels-value-variables"></a>

 特定于值的变量在 **\$1\$1value** 命名空间下可用：
+  **\$1\$1value.time**：URL 值的时间戳（Unix 毫秒纪元）（即 **?time=1560268814105**） 
+  **\$1\$1value.raw**：原始值 
+  **\$1\$1value.numeric**：值的数字表示 
+  **\$1\$1value.text**：值的文本表示 
+  **\$1\$1value.calc**：如果值是计算结果，则为计算名称 

## 模板变量
<a name="v9-panels-template-variables"></a>

 在链接到其他使用模板变量的控制面板时，请为单击链接的用户选择变量值。

 **\$1\$1var-myvar:queryparam\$1**：其中 **var-myvar** 是模板变量的名称，该变量与当前控制面板中要使用的变量匹配。


|  变量状态  |  创建 URL 的结果  | 
| --- | --- | 
|  选择一个值  |  var-myvar=value1  | 
|  选择多个值  |  var-myvar=value1&var-myvar=value2  | 
|  选择全部  |  var-myvar=all  | 

 如果要将当前控制面板的所有变量添加到 URL，请使用 **\$1\$1\$1\$1all\$1variables\$1**。

## 数据链接
<a name="v9-panels-data-links"></a>

 通过数据链接，可为链接提供更精细的上下文。您可以创建包含序列名称甚至光标下值的链接。例如，如果您的可视化显示四台服务器，则可以向其中一两台服务器添加数据链接。

 根据可视化效果，可通过不同的方式访问链接本身。对于图形，您需要单击数据点或线；对于像统计、控制面板或条形仪表等板，您可以单击可视化上的任意位置以打开上下文菜单。

 您可以在数据链接中使用变量，将用户引导至具有保留数据筛选条件的详细控制面板。例如，您可以使用变量来指定时间范围、序列和变量选择。有关更多信息，请参阅 [数据链接变量](#v9-panels-data-link-variables)。

### 提前输入建议
<a name="v9-panels-typeahead-suggestions"></a>

 创建或更新数据链接时，按键盘上的 Cmd\$1Space 或 Ctrl\$1Space 打开预输入建议，以便更轻松地向 URL 添加变量。

### 添加数据链接
<a name="v9-panels-add-a-datalink"></a>

1.  将光标悬停在要添加链接的面板上，然后按 **e** 键。或者单击面板标题旁边的下拉箭头，然后单击**编辑**。

1.  在字段选项卡上，向下滚动到数据链接部分。

1.  展开数据链接，然后单击**添加链接**。

1.  输入**标题**。**标题**是链接的可读标签，显示在 UI 中。

1.  输入要链接的 **URL**。

    您甚至可以添加在控制面板中定义的一个模板变量。选择 **URL** 字段，然后键入 **\$1**，或者按 Ctrl\$1Space 或 Cmd\$1Space 查看可用变量列表。通过向面板链接添加模板变量，该链接会将用户引导到正确的上下文，且相关变量已设置。有关更多信息，请参阅 [数据链接变量](#v9-panels-data-link-variables)。

1.  如果要在新选项卡中打开链接，请选择**在新选项卡中打开**。

1.  单击**保存**以保存更改并关闭窗口。

1.  单击右上角的**保存**将更改保存到控制面板。

### 更新数据链接
<a name="v9-panels-update-a-datalink"></a>

1.  在字段选项卡上，找到要更改的链接。

1.  单击编辑（铅笔）图标打开编辑链接窗口。

1.  进行任何必需的更改。

1.  单击**保存**以保存更改并关闭窗口。

1.  单击右上角的**保存**将更改保存到控制面板。

### 删除数据链接
<a name="v9-panels-delete-a-datalink"></a>

1.  在字段选项卡上，找到要删除的链接。

1.  单击要删除的链接旁边的 **X** 图标。

1.  单击右上角的**保存**将更改保存到控制面板。