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

轉換資料

轉換是在系統套用視覺效果之前，操作查詢傳回之資料的強大方法。使用轉換，您可以：

對於依賴相同資料集的多個檢視的使用者而言，轉換可提供建立和維護大量儀表板的有效方法。

您也可以使用一個轉換的輸出作為另一個轉換的輸入，這會導致效能提升。

轉換類型

Grafana 提供了許多方式，您可以轉換資料。下面有一個完整的轉換功能列表。

轉換順序

當有多個轉換時，Grafana 會依照列出的順序來套用它們。每個轉換都會建立一個結果集，然後傳遞至處理管線中的下一個轉換。

Grafana 套用轉換的順序會直接影響結果。例如，如果您使用「減少」轉換，將一個資料欄的所有結果壓縮為單一值，則只能將變形套用至該單一值。

將轉換函數添加到數據

下列步驟會引導您將轉換新增至資料。

偵錯轉換

若要查看轉換的輸入和輸出結果集，請選擇轉換資料列右側的錯誤圖示。

輸入和輸出結果集可協助您偵錯轉換。

刪除轉換

我們建議您移除不需要的轉換。刪除轉換時，您會從視覺效果中移除資料。

事前準備：

識別依賴轉換的所有儀表板，並通知受影響的儀表板使用者。

轉換函數

您可以對資料執行下列轉換。

從計算新增欄位

使用此轉換可新增從其他兩個欄位計算的新欄位。每次轉換都允許您添加一個新字段。

串連欄位

此轉換會將所有影格中的所有欄位合併為一個結果。考慮這兩個查詢。

查詢 A：

查詢 B：

連接字段後，數據框將是：

從查詢結果 Config

此轉換可讓您選取一個查詢，並從中擷取標準選項，例如「最小值」、「最大值」、「單位」和「臨界值」，並將其套用至其他查詢結果。這會啟用動態查詢驅動的視覺化設定。

如果要為配置查詢結果中的每一行提取唯一配置，請嘗試將行轉換為字段。

選項

轉換欄位類型

此轉換會變更指定欄位的欄位類型。

例如，下面的查詢可以通過選擇時間字段進行修改，作為時間和日期格式為 YYYY。

結果是：

按名稱過濾數據

使用此轉換可移除部分查詢結果。

Grafana 會顯示識別碼欄位，後面接著查詢傳回的欄位。

您可以使用下列兩種方式之一來套用篩選條件：

按查詢過濾數據

如果您要隱藏一或多個查詢，請在具有多個查詢的面板中使用此轉換。

Grafana 會以深灰色文字顯示查詢識別字母。按一下查詢識別碼以切換篩選。如果查詢字母為白色，則會顯示結果。如果查詢字母很暗，則會隱藏結果。

按值過濾數據

此轉換可讓您直接在 Grafana 中篩選資料，並從查詢結果中移除一些資料點。您可以選擇包含或排除符合您定義之一或多個條件的資料。條件會套用至選取的欄位。

如果您的資料來源並未依值進行原生篩選，則此轉換非常有用。如果您使用共用查詢，也可以使用此選項來縮小顯示的值。

所有欄位的可用條件為：

數字欄位的可用條件如下：

請考慮下列資料集：

如果您包含溫度低於 30°C 的資料點，配置將如下所示：

您將得到以下結果，其中僅包含 30°C 以下的溫度：

您可以將多個條件新增至篩選器。例如，您可能只希望在高度大於 100 時包括資料。若要這樣做，請將該條件新增至下列組態：

當您有多個條件時，您可以選擇是否要在符合所有條件或符合您新增的任何條件的列上套用動作 (包含/排除)。

在上面的範例中，我們選擇了「全部符合」，因為我們想要包括溫度低於 30 且高度高於 100 的列。如果我們想要包含溫度低於 30 的行，或者高於 100 的高度，那麼我們將選擇匹配任何。這將包括原始數據中的第一行，該數據的溫度為 32°C（與第一個條件不匹配），但高度為 101（與第二個條件匹配），因此將其包括在內。

系統會忽略無效或設定不完整的條件。

分組依據

此轉換會依指定的欄位 (欄) 值將資料分組，並處理每個群組的計算。按一下以查看計算選項清單。

以下是原始資料的範例。

這種轉型進行了兩個步驟。首先，您可以指定一個或多個欄位來分組資料。這會將這些欄位的所有相同值分組在一起，就好像您對它們進行排序一樣。例如，如果我們按服務器 ID 字段進行分組，那麼它將以這種方式對數據進行分組：

具有相同伺服器 ID 值的所有資料列都會群組在一起。

選擇要將資料分組依據的欄位後，您可以在其他欄位上新增各種計算，並將計算套用至每組列。例如，我們可以計算每個服務器的平均 CPU 溫度。因此，我們可以添加應用於 CPU 溫度字段的平均計算以獲得以下內容：

我們可以添加多個計算。例如：

然後我們會得到：

此轉換可讓您從時間序列擷取關鍵資訊，並以方便的方式顯示。

按字段加入

使用此轉換可將多個結果聯結至單一資料表。這對於將多個時間序列結果轉換為具有共用時間欄位的單一寬表格特別有用。

內部連接

內部聯接合併來自多個表中的數據，其中所有表共享來自所選字段的相同值。這種類型的聯結會排除每個結果中值不相符的資料。

使用此轉換可將多個查詢 (合併在傳遞的聯結欄位或第一次資料行上) 的結果合併為一個結果，並刪除無法成功聯結的資料列。

在下列範例中，兩個查詢會傳回資料表資料。在應用內部連接轉換之前，它被視覺化為兩個單獨的表。

查詢 A：

查詢 B：

套用內部聯結轉換後的結果如下所示：

外部連接

外部連接包括來自內部聯接的所有數據和行，其中值不匹配在每個輸入。當內部聯結加入時間欄位上的查詢 A 和查詢 B 時，外部聯結會包含時間欄位上不相符的所有資料列。

在下列範例中，兩個查詢會傳回資料表資料。在應用外部連接轉換之前，它被視覺化為兩個表。

查詢 A：

查詢 B：

應用外部連接轉換後的結果如下所示：

欄位的標籤

此轉換會變更將標籤或標籤包含在表格中的時間序列結果，其中每個標籤索引鍵和值都包含在表格結果中。標籤可以顯示為欄或列值。

給定兩個時間序列的查詢結果：

在「欄」模式中，結果如下所示：

在「行」模式下，結果為每個系列都有一個表格，並顯示每個標籤值，如下所示：

值欄位名稱

如果您選取 [伺服器] 作為 [值] 欄位名稱，則您會為 [伺服器] 標籤的每個值取得一個欄位。

合併行為

標籤到字段轉換器內部是兩個獨立的轉換。第一個作用於單個系列，並將標籤提取到字段中。第二個是將所有結果聯結到單一資料表的合併轉換。合併轉換會嘗試在所有相符欄位上加入。此合併步驟為必要步驟，無法關閉。

為了說明這一點，下面是一個例子，其中有兩個查詢返回沒有重疊標籤的時間序列。

這將首先導致這兩個表格：

合併後：

合併

使用此轉換可將來自多個查詢的結果合併為一個單一結果。這在使用表格面板視覺效果時很有幫助。可以合併的值會合併到同一列中。如果共用欄位包含相同的資料，則值是可合併的。

在下面的例子中，我們有兩個查詢返回表數據。在應用轉換之前，它被視覺化為兩個單獨的表。

查詢 A：

查詢 B：

以下是應用合併轉換後的結果：

組織欄位

使用此轉換可重新命名、重新排序或隱藏查詢傳回的欄位。

Grafana 顯示查詢返回的字段列表。您可以：

按值進行分區

繪製多個序列時，此轉換有助於消除對具有不同WHERE子句的相同資料來源進行多次查詢。請考慮包含下列資料的測量結果 SQL 表格：

在 v9.3 之前，如果您想在同一個 TimeSeries 面板中為美國繪製紅色趨勢線和歐盟的藍色趨勢線，則可能必須將其分為兩個查詢：

SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'

這也需要您事先知道測量結果表格中實際存在哪些區域。

使用按值分區轉換器，您現在可以發出單個查詢，並在您選擇的一個或多個列（fields）中按唯一值拆分結果。以下範例使用 Region。

SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'

減少

「縮小」轉換會將計算套用至框架中的每個欄位，並傳回單一值。套用此轉換時，會移除時間欄位。

考慮輸入：

查詢 A：

查詢 B：

減少變壓器具有兩種模式：

例如，如果您將「第一個」和「最後一個」計算與「序列」轉換一起使用，則結果為：

使用「最後一次」計算的「縮小」欄位會產生兩個影格，每個框架都有一列：

查詢 A：

查詢 B：

通過正則表達式

使用此轉換可使用規則運算式和取代模式來重新命名部分查詢結果。

您可以指定只適用於相符項目的規則運算式，以及支援反向參照的取代模式。例如，假設您正在視覺化每個主機的 CPU 使用率，並且想要移除網域名稱。您可以將正則表達([^\.]+)\..+式設置為$1，替換模式web-01.example.com將成為web-01。

行到字段

列到字段轉換將行轉換為單獨的字段。這很有用，因為可以單獨設置字段的樣式和配置。它還可以使用其他字段作為動態字段配置的源或將它們映射到字段標籤。然後，可以使用其他標籤為結果欄位定義更好的顯示名稱。

此轉換包含欄位表格，其中列出了組態查詢傳回之資料中的所有欄位。此表格可讓您控制哪些欄位應對應至每個組態屬性 (*Use as ** 選項)。如果傳回的資料中有多個資料列，您也可以選擇要選取的值。

這種轉換需要：

在以下位置視覺化資料時很有用：

將額外欄位對應至標籤

如果一個字段沒有映射到配置屬性，Grafana 將自動使用它作為輸出字段上的標籤源-

範例：

輸出：

額外的標籤現在可以在字段中使用顯示名稱，提供更完整的字段名稱。

如果要從一個查詢中提取配置並將其應用於另一個查詢，則應使用查詢結果轉換中的配置。

範例

輸入:

輸出：

正如你可以看到源數據中的每一行成為一個單獨的字段。每個欄位現在也有最大組態選項設定。例如「最小值」、「最大值」、「單位」和「臨界值」等選項都是欄位組態的一部分，如果這樣設定，視覺效果將使用，而不是在面板編輯器選項窗格中手動設定的任何選項。

準備時間序列

當資料來源以您要使用的面板不支援的格式傳回時間序列資料時，準備時間序列轉換非常有用。

此轉換可協助您解決此問題，方法是將時間序列資料從寬格式轉換為長格式或其他方式。

選取「多影格時間序列」選項，將時間序列資料框架從寬格式轉換為長格式。

選取寬時間序列選項，將時間序列資料框架從長格式轉換為寬格式。

序列到行

使用此轉換可將來自多個時間序列資料查詢的結果合併為單一結果。這在使用表格面板視覺效果時很有幫助。

此轉換的結果將包含三個資料欄：時間、測量結果和值。系統會新增「量度」欄，讓您輕鬆查看測量結果來源於哪個查詢。透過在來源查詢上定義 Label 來自訂此值。

在下面的例子中，我們有兩個查詢返回時間序列數據。在應用轉換之前，它被視覺化為兩個單獨的表。

查詢 A：

查詢 B：

下面是應用系列行轉換後的結果。

排序方式

這種轉換將按配置的字段對每個框架進行排序，當reverse選中時，值將以相反的順序返回。

限制

使用此轉換可限制顯示的列數。

在下面的例子中，我們有來自數據源的以下響應：

以下是添加值為 '3' 的限制轉換後的結果：