本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定資料連結
<a name="v10-panels-configure-data-links"></a>

****  
本文件主題專為支援 Grafana **10.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 12.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 12 版](using-grafana-v12.md)。  
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

資料連結可讓您為連結提供更精細的內容。您可以在游標下建立包含序列名稱或甚至值的連結。例如，如果您的視覺化顯示四個伺服器，您可以將資料連結新增至其中一或兩個伺服器。您也可以使用資料連結來連結面板。

連結本身可透過不同方式存取，視視覺化效果而定。例如，針對時間序列視覺化，您可以選擇資料點或行。對於大型區域視覺效果，例如統計資料、量測計或長條圖，您可以選擇視覺效果上的任何位置來開啟內容選單。

如果視覺效果中只有一個資料連結，請選擇視覺效果上的任何位置會開啟連結，而非內容選單。

**支援的視覺化效果**
+ 長條圖
+ 長條規
+ 蠟燭圖
+ Canvas
+ 量測計
+ 地理貼圖
+ 熱度圖
+ 直方圖
+ 圓餅圖
+ Stat
+ 狀態時間軸
+ 狀態歷史記錄
+ 資料表
+ 時間序列
+ 趨勢

## 資料連結變數
<a name="v10-panels-data-link-variables"></a>

資料連結中的變數可讓您將人員傳送至具有保留資料篩選條件的詳細儀表板。例如，您可以使用變數來指定標籤、時間範圍、序列或變數選擇。

若要查看可用變數的清單，`$`請輸入資料連結 **URL** 欄位。

您也可以在資料連結 URLs中使用範本變數，請參閱 [Variables](v10-dash-variables.md)。

### 時間範圍面板變數
<a name="v10-panels-time-range-panel-variables"></a>

這些變數可讓您在資料連結 URL 中包含目前的時間範圍。
+ `__url_time_range` – 目前儀表板的時間範圍 （即 `?from=now-6h&to=now`)
+ `$__from` – 如需詳細資訊，請參閱 [全域變數](v10-dash-variable-add.md#v10-dash-variable-add-global)。
+ `$__to` – 如需詳細資訊，請參閱 [全域變數](v10-dash-variable-add.md#v10-dash-variable-add-global)。

### 系列變數
<a name="v10-panels-series-variables"></a>

系列特定變數可在`__series`命名空間下使用：
+ `__series.name` – URL 的序列名稱

### 欄位變數
<a name="v10-panels-field-variables"></a>

欄位特定變數可在`__field`命名空間下取得：
+ `__field.name` – 欄位的名稱
+ `__field.labels.<LABEL>` – 標籤的 URL 值。如果您的標籤包含點，請使用`__field.labels["<LABEL>"]`語法。

### 值變數
<a name="v10-panels-value-variables"></a>

值特定的變數可在`__value`命名空間下取得：
+ `__value.time` – 值的時間戳記 (Unix ms epoch) 到 URL （即 `?time=1560268814105`)
+ `__value.raw` – 原始值
+ `__value.numeric` – 數值的數值表示法
+ `__value.text` – 值的文字表示
+ `__value.calc` – 如果值是計算的結果，則計算名稱

根據工具提示模式的設定選項，在資料連結中使用值特定的變數可以顯示不同的結果。

### 資料變數
<a name="v10-panels-data-variables"></a>

若要從其他欄位存取值，請使用：
+ `__data.fields[i]` – 欄位的值 `i`（在同一列）。
+ `__data.fields["NameOfField"]` – 使用名稱而非索引的欄位值。
+ `__data.fields[i].labels.cluster` – 存取另一個欄位的標籤。

### 範本變數
<a name="v10-panels-template-variables"></a>

連結至使用範本變數的另一個儀表板時，請為按一下連結的人員選取變數值。

`${var-myvar:queryparam}` – 其中 `var-myvar`是範本變數的名稱，其符合您要使用的目前儀表板中的變數。


| 變數狀態 | 產生建立的 URL | 
| --- | --- | 
| 已選取一個值 | var-myvar=value1 | 
| 已選取多個值 | var-myvar=value1&var-myvar=value2 | 
| 已選取 All | var-myvar=All | 

如果您想要將所有目前儀表板的變數新增至 URL，請使用 `${__all_variables}`。

## 新增資料連結
<a name="v10-panels-add-a-datalink"></a>

您可以將資料連結新增至您的面板。

1. 導覽至您要新增資料連結的面板。

1. 將滑鼠游標暫留在面板上，在右上角顯示選單圖示。

1. 從功能表中，選擇**編輯**以開啟面板編輯器。

1. 在**面板編輯**窗格中，向下捲動至**資料連結**區段並將其展開。

1. 選擇**新增連結**。

1. 在開啟的對話方塊中，輸入**標題**。這是連結的人類可讀取標籤，會顯示在 UI 中。

1. 輸入您要連結的 **URL** 或變數。

   若要新增資料連結變數，請選取 **URL** 欄位，然後輸入`$`或按 Ctrl\+Space 或 Cmd\+Space 以查看可用變數的清單。

1. 如果您想要在新索引標籤中開啟連結，請選取**在新索引標籤中開啟**。

1. 選擇**儲存**以儲存變更並關閉對話方塊。

1. 將變更儲存至儀表板。