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

# 設定資料連結
<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\$1 系列**命名空間下取得：
+  **\$1\$1series.name** - URL 的序列名稱 

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

 欄位特定變數可在 **\$1\$1 欄位**命名空間下取得：
+  **\$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 ms epoch) （即 **？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>

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

 連結本身可透過不同方式存取，視視覺化效果而定。對於圖形，您需要按一下資料點或線，對於 Stat、Gauge 或 Bar Gauge 等面板，您可以按一下視覺化上的任意位置來開啟內容功能表。

 您可以在資料連結中使用變數，將人員傳送至具有保留資料篩選條件的詳細儀表板。例如，您可以使用變數來指定時間範圍、序列和變數選擇。如需詳細資訊，請參閱[資料連結變數](#v9-panels-data-link-variables)。

### Typeahead 建議
<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.  按一下右上角的**儲存**，將變更儲存至儀表板。