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

# 查詢和轉換資料
<a name="v9-panels-query-xform"></a>

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

Grafana 支援許多類型的[資料來源](AMG-data-sources.md)。資料來源*查詢*會傳回 Grafana 可以*轉換*和視覺化的資料。每個資料來源都使用自己的查詢語言，且每個資料來源外掛程式都會實作稱為查詢編輯器的查詢建置使用者介面。

## 關於查詢
<a name="v9-panels-query-xform-about"></a>

Grafana 面板會透過查詢與資料來源通訊，以擷取視覺化資料。查詢是以資料來源使用的查詢語言撰寫的問題。

您可以在面板的資料來源選項中設定查詢頻率和資料收集限制。Grafana 每個面板最多支援 26 個查詢。

您可以在資料來源區段中找到每個[資料來源](AMG-data-sources.md)查詢語言的詳細資訊。

**查詢編輯器**

每個資料來源的*查詢編輯器*都提供自訂的使用者介面，協助您撰寫利用其唯一功能的查詢。

由於查詢語言之間的差異，每個資料來源查詢編輯器的外觀和功能都不同。根據您的資料來源，查詢編輯器可能會提供自動完成功能、指標名稱、變數建議或視覺化查詢建置界面。

如需特定資料來源唯一查詢編輯器功能的詳細資訊，請參閱其文件：
+ 如需 Grafana 隨附的資料來源，請參閱[內建資料來源](AMG-data-sources-builtin.md)。
+ 如需 Grafana Enterprise 編輯隨附的資料來源，請參閱 [連線至企業資料來源](AMG-data-sources-enterprise.md)。

**查詢語法**

資料來源使用不同的查詢語言來請求資料。如需特定資料來源唯一查詢語言的詳細資訊，請參閱其文件。

**PostgreSQL 範例：**

```
SELECT hostname FROM host WHERE region IN($region)
```

**PromQL 範例：**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**特殊資料來源**

Grafana 也包含三個特殊資料來源：**Grafana**、**Mixed** 和 **Dashboard**。如需詳細資訊，請參閱資料來源

## 導覽查詢索引標籤
<a name="v9-panels-query-xform-navigate"></a>

面板的**查詢**索引標籤包含下列元素：
+ **資料來源選取器** – 選取要查詢的資料來源。
+ **查詢選項：** – 設定最大資料擷取參數和查詢執行時間間隔。
+ **查詢檢查器按鈕：** – 開啟查詢檢查器面板，您可以在其中檢視和最佳化查詢。
+ **查詢編輯器清單：** – 列出您寫入的查詢。
+ **表達式：** – 使用表達式建置器來建立提醒表達式。如需運算式的相關資訊，請參閱[寫入表達式查詢](v9-panels-query-xform-expressions.md)。

## 新增查詢
<a name="v9-panels-query-xform-add"></a>

查詢會傳回 Grafana 在儀表板面板中視覺化的資料。當您建立面板時，Grafana 會自動選取預設資料來源。

**新增查詢**

1. 編輯您要新增查詢的面板。

1. 選擇 **Queries** (查詢) 索引標籤。

1. 選擇**資料來源**下拉式功能表，然後選取資料來源。

1. 選擇**查詢選項**來設定您需要的資料點數量上限。如需查詢選項的詳細資訊，請參閱 [查詢選項](#v9-panels-query-xform-options)。

1. 使用查詢編輯器寫入查詢。

1. 選擇**套用**。

Grafana 會查詢資料來源並視覺化資料。

## 管理查詢
<a name="v9-panels-query-xform-manage"></a>

Grafana 會在可摺疊查詢列中組織查詢。每個查詢列都包含查詢編輯器，並以字母 (A、B、C 等） 識別。

若要管理您的查詢，您可以複製查詢、隱藏查詢、移除查詢、重新排序查詢，以及切換查詢編輯器的說明。

## 查詢選項
<a name="v9-panels-query-xform-options"></a>

選擇資料來源選取器旁的**查詢選項**，以查看所選資料來源的設定。您在此處所做的變更只會影響在此面板中進行的查詢。

Grafana 會設定以深灰色文字顯示的預設值。變更會以白色文字顯示。若要將欄位傳回預設設定，請從 欄位刪除白色文字。

面板資料來源查詢選項包括：
+ **最大資料點** – 如果資料來源支援，這會設定傳回的每個序列的資料點數目上限。如果查詢傳回的資料點超過最大資料點設定，則資料來源會藉由依平均、最大或其他函數彙總它們來減少傳回的點數。

  您可以限制點數，以改善查詢效能或平滑視覺化線條。預設值是圖形的寬度 （或像素數），因為您只能將圖形面板有足夠空間顯示的資料點視覺化。
+ **最小間隔** – 設定自動計算間隔的最小限制，通常是最小抓取間隔。如果資料點每 15 秒儲存一次，則不會因為間隔低於此值而受益。您也可以將此設定為高於湊集間隔的最小值，以擷取更粗略且功能良好的查詢。
+ **間隔** – 設定您在依時間彙總或分組資料點時可以使用的時間範圍。

  Grafana 會自動計算適當的間隔，您可以在範本查詢中用作變數。變數的測量單位為秒 (`$__interval`) 或毫秒 (`$__interval_ms`)。

  間隔通常用於彙總函數，例如總和或平均值。例如，這是使用間隔變數 的 Prometheus 查詢`rate(http_requests_total[$__interval])`。

  此自動間隔是根據圖形的寬度計算。當使用者縮小視覺化效果時，間隔會增加，導致更粗細的彙總。同樣地，如果使用者放大，間隔會減少，導致更精細的彙總。

  如需詳細資訊，請參閱[全域變數](v9-dash-variable-add.md#v9-dash-variable-add-global)。
+ **相對時間** – 覆寫個別面板的相對時間範圍，這會導致它們與儀表板右上角儀表板時間選擇器中選取的時間範圍不同。您可以使用此功能在相同的儀表板上顯示不同時段或天數的指標。
**注意**  
當儀表板的時間範圍為絕對時，面板時間覆寫不會有任何影響。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v9-panels-query-xform.html)
+ **時間轉移** – 透過相對於時間挑選器轉移其開始和結束來覆寫個別面板的時間範圍。例如，您可以將面板的時間範圍變更為早於儀表板時間挑選器兩小時。
**注意**  
當儀表板的時間範圍為絕對值時，面板時間覆寫不會有任何影響。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v9-panels-query-xform.html)
+ **快取逾時** – *（只有在資料來源中可用時才可見）* 如果您的時間序列存放區具有查詢快取，則覆寫預設快取逾時。將此值指定為以秒為單位的數值。