轉換資料

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

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

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

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

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

轉換類型

Grafana 提供多種轉換資料的方式。以下是轉換函數的完整清單。

轉換順序

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

Grafana 套用轉換的順序會直接影響結果。例如，如果您使用減少轉換將一欄的所有結果精簡為單一值，則您只能將轉換套用至該單一值。

將轉換函數新增至資料

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

偵錯轉換

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

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

刪除轉換

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

事前準備：

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

轉換函數

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

從計算新增欄位

使用此轉換來新增從其他兩個欄位計算的新欄位。每次轉換都可讓您新增一個欄位。

串連欄位

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

查詢 A：

查詢 B：

串連欄位之後，資料框架會是：

查詢結果中的組態

此轉換可讓您選擇一個查詢，並從中擷取標準選項，例如 Min、Max、Unit 和 Thresholds，並將其套用至其他查詢結果。這會啟用動態查詢驅動的視覺化組態。

如果您想要擷取組態查詢結果中每一列的唯一組態，請嘗試資料列到欄位轉換。

選項

轉換欄位類型

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

例如，以下查詢可以透過選取時間欄位、時間格式和日期格式為 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：

透過 regex 重新命名

使用此轉換來使用規則表達式和替換模式重新命名查詢結果的部分。

您可以指定規則表達式，該表達式僅套用到相符項目，以及支援回溯參考的替代模式。例如，假設您正在視覺化每個主機的 CPU 用量，並想要移除網域名稱。您可以設定 regex 為 ，([^\.]+)\..+而替代模式為 $1， web-01.example.com 會變成 web-01。

欄位的資料列

資料列轉換為欄位轉換會將資料列轉換為不同的欄位。這很有用，因為欄位可以個別進行樣式和設定。它也可以使用其他欄位做為動態欄位組態的來源，或將其對應至欄位標籤。然後，可以使用其他標籤來定義結果欄位更好的顯示名稱。

此轉換包含欄位資料表，其中列出組態查詢傳回的資料中的所有欄位。此資料表可讓您控制哪些欄位應映射到每個組態屬性 (*使用 做為** 選項）。如果傳回的資料中有多個資料列，您也可以選擇要選取的值。

此轉換需要：

在 中視覺化資料時很有用：

將額外的欄位映射至標籤

如果欄位未映射到組態屬性，Grafana 會自動將其用作輸出欄位上標籤的來源 -

範例：

輸出：

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

如果您想要從一個查詢擷取組態並將其套用至另一個查詢，則應使用查詢結果轉換中的組態。

範例

輸入:

輸出：

您可以看到來源資料中的每一列都會變成個別欄位。每個欄位現在也具有最大組態選項集。Min、Max、Unit 和 Thresholds 等選項都是欄位組態的一部分，如果像這樣設定，視覺效果將會使用它，而不是面板編輯器選項窗格中手動設定的任何選項。

準備時間序列

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

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

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

選取廣角時間序列選項，將時間序列資料影格從長格式轉換為廣角格式。

序列到資料列

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

此轉換的結果將包含三個資料欄：時間、指標和值。新增指標欄，以便您輕鬆查看指標源自哪個查詢。透過定義來源查詢上的標籤來自訂此值。

在下面的範例中，有兩個查詢會傳回時間序列資料。在套用轉換之前，它會將其視覺化為兩個不同的資料表。

查詢 A：

查詢 B：

以下是將序列套用至資料列轉換後的結果。

排序依據

此轉換會依設定的欄位排序每個影格，當核取reverse時，值會以相反的順序傳回。

限制

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

在下面的範例中，我們從資料來源收到下列回應：

以下是新增值為「3」的限制轉換之後的結果：