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

連線至 PostgreSQL 資料來源

您可以使用 PostgreSQL 資料來源來查詢和視覺化來自 Amazon Aurora PostgreSQL 資料庫的資料。

新增資料來源

資料來源選項

最短時間間隔

$_interval $_interval_ms 變數的下限。建議設定為寫入頻率，例如1m，如果資料每分鐘寫入一次。也可以在資料來源選項下的儀表板面板中覆寫/設定此選項。此值的格式必須是數字，後面接著有效的時間識別符；例如 1m(1 分鐘） 或 30s(30 秒）。支援下列時間識別符。

資料庫使用者許可

下列範例程式碼顯示建立具有受限許可的 specifice PostgreSQL 使用者。

 CREATE USER grafanareader WITH PASSWORD 'password';
 GRANT USAGE ON SCHEMA schema TO grafanareader;
 GRANT SELECT ON schema.table TO grafanareader;

確定使用者未從公有角色取得任何不需要的許可。

查詢編輯器

您可以在圖形或 Singlestat 面板編輯模式中的指標索引標籤中找到 PostgreSQL 查詢編輯器。您可以選擇面板標題，然後編輯，以進入編輯模式。

查詢編輯器具有產生的 SQL 連結，會在查詢執行後，在面板編輯模式中顯示。選擇它，它會展開並顯示已執行的原始插補 SQL 字串。

選取資料表、時間欄和指標欄 (FROM)

當您第一次進入編輯模式或新增查詢時，Grafana 會嘗試使用具有時間戳記欄和數值欄的第一個資料表預先填入查詢建置器。

在 FROM 欄位中，Grafana 會建議資料庫使用者 search_path 中的資料表。若要選取不在 中的資料表或檢視，search_path您可以手動輸入完整名稱 (schema.table)，例如 public.metrics。

時間欄欄位是指保留時間值的資料欄名稱。選取指標資料欄欄位的值是選用的。如果選取值，則會使用指標欄欄位做為序列名稱。

指標欄建議只會包含具有文字資料類型 (char、varchar、text) 的資料欄。若要使用具有不同資料類型的資料欄做為指標資料欄，您可以輸入具有轉換的資料欄名稱：ip::text。您也可以在評估為文字資料類型的指標資料欄欄位中輸入任意 SQL 表達式，例如 hostname || ' ' || container_name。

資料欄、視窗和彙總函數 (SELECT)

在 SELECT列中，您可以指定要使用的資料欄和函數。在資料欄欄位中，您可以撰寫任意表達式，而不是資料欄名稱，例如 column1 * column2 / column3。

查詢編輯器中可用的函數取決於您在設定資料來源時選取的 PostgreSQL 版本。如果您使用彙總函數，則必須將結果集分組。如果您新增彙總函數，編輯器會自動新增 GROUP BY time。

編輯器會嘗試簡化和統一查詢的這個部分。

您可以選擇加號按鈕，然後從功能表中選取資料欄，以新增其他值資料欄。圖形面板中的多個值資料欄將繪製為個別序列。

篩選資料 (WHERE)

若要新增篩選條件，請選擇WHERE條件右側的加號圖示。您可以選擇篩選條件並選取移除，以移除篩選條件。目前所選時間範圍的篩選條件會自動新增至新查詢。

分組依據

若要依時間或任何其他資料欄分組，請選擇 GROUP BY 資料列結尾的加號圖示。建議下拉式清單只會顯示目前所選資料表的文字資料欄，但您可以手動輸入任何資料欄。您可以選擇項目，然後選取移除，以移除群組。

如果您新增任何分組，則所有選取的資料欄都必須套用彙總函數。當您新增分組時，查詢建置器會自動將彙總函數新增至所有資料欄，而不需要彙總函數。

間隙填充

當您依時間分組時，Amazon Managed Grafana 可以填入缺少的值。時間函數接受兩個引數。第一個引數是您要分組的時間範圍，第二個引數是您希望 Grafana 填入缺少項目的值。

文字編輯器模式 (RAW)

您可以選擇漢堡圖示並選取切換編輯器模式，或選擇查詢下方的編輯 SQL，即可切換到原始查詢編輯器模式。

巨集

巨集可在查詢中使用，以簡化語法並允許動態組件。

資料表查詢

如果查詢選項設定為格式化為資料表，基本上您可以執行任何類型的 SQL 查詢。資料表面板會自動顯示查詢傳回的任何資料欄和資料列的結果。

您可以使用一般 as SQL 資料欄選取語法來控制資料表面板資料欄的名稱。

時間序列查詢

如果您將格式設定為 Time series，例如用於圖形面板，查詢必須傳回名為 的資料欄time，該資料欄會傳回 SQL 日期時間或任何代表 Unix epoch 的數值資料類型。除了 time和 以外的任何資料欄metric都會視為值資料欄。您可以傳回名為 的資料欄metric，做為值資料欄的指標名稱。如果您傳回多個值資料欄和名為 的資料欄metric，則會使用此資料欄做為序列名稱的字首。

時間序列查詢的結果集必須依時間排序。

下列範例程式碼顯示 metric欄。

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double"),
  'min' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

以下程式碼範例顯示使用 $__timeGroup 巨集中的填充參數，將 null 值改為零。

SELECT
  $__timeGroup("createdAt",'5m',0),
  sum(value) as value,
  measurement
FROM test_data
WHERE
  $__timeFilter("createdAt")
GROUP BY time, measurement
ORDER BY time

下列範例程式碼顯示多個資料欄。

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double") as "min_value",
  max("value_double") as "max_value"
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

範本化

您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單選取方塊。您可以使用這些下拉式方塊來變更儀表板中顯示的資料。

如需範本和範本變數的詳細資訊，請參閱 範本。

查詢變數

如果您新增類型 的範本變數Query，您可以撰寫 PostgreSQL 查詢，以傳回顯示為下拉式清單選取方塊的測量名稱、索引鍵名稱或索引鍵值等物件。

例如，如果您在範本變數查詢設定中指定這類查詢，您可以有一個變數，其中包含資料表中資料hostname欄的所有值。

SELECT hostname FROM host

查詢可以傳回多個資料欄，Grafana 會自動從中建立清單。例如，下列查詢將傳回來自 hostname和 的值清單hostname2。

SELECT host.hostname, other_host.hostname2 FROM host JOIN other_host ON host.city = other_host.city

若要在查詢$__timeFilter(column)中使用時間範圍相依巨集，例如 ，範本變數的重新整理模式必須設定為時間範圍變更。

SELECT event_name FROM event_log WHERE $__timeFilter(time_column)

另一個選項是可建立索引鍵/值變數的查詢。查詢應傳回兩個名為 __text和 的資料欄__value。__text 資料欄值應該是唯一的 （如果不是唯一的，則會使用第一個值）。下拉式清單中的選項會有文字和值，可讓您將易記的名稱做為文字，並將 ID 做為值。使用 hostname做為文字和 id做為值的範例查詢：

SELECT hostname AS __text, id AS __value FROM host

您也可以建立巢狀變數。使用名為 的變數region，您可以讓主機變數僅顯示目前所選區域的主機。下列程式碼範例顯示這樣的查詢 （如果 region 是多值變數，請使用IN比較運算子=，而不是比對多個值）。

SELECT hostname FROM host  WHERE region IN($region)

使用 __searchFilter 在查詢變數中篩選結果

__searchFilter 在查詢欄位中使用 會根據下拉式清單選取方塊中的使用者類型來篩選查詢結果。當使用者未輸入任何內容時， 的預設值__searchFilter為 %。

下列範例示範如何使用 __searchFilter做為查詢欄位的一部分，以在下拉式清單選取方塊中的使用者類型hostname時啟用搜尋。

SELECT hostname FROM my_host  WHERE hostname LIKE '$__searchFilter'

在查詢中使用變數

只有在範本變數是 時，才會引用範本變數值multi-value。

如果變數是多值變數，請使用IN比較運算子=，而不是比對多個值。

有兩種語法：

$<varname> 範本變數名為 的範例hostname：

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC

[[varname]] 範本變數名為 的範例hostname：

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC

關閉多值變數的引號

Amazon Managed Grafana 會自動為多值變數建立以逗號分隔的引號字串。例如：如果選取 server02 server01和 ，則會格式化為：'server01', 'server02'。若要關閉引號，請使用變數的 csv 格式選項。

${servers:csv}

如需變數格式化選項的詳細資訊，請參閱 範本和變數。

註釋

使用註釋在圖形上方覆蓋豐富的事件資訊。您可以透過儀表板功能表/註釋檢視新增註釋查詢。如需詳細資訊，請參閱註釋。

下列範例程式碼使用具有 epoch 值的時間欄來顯示查詢。

SELECT
  epoch_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

下列範例程式碼顯示使用具有 epoch 值的時間和結束時間資料欄的區域查詢。

SELECT
  epoch_time as time,
  epoch_time_end as timeend,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

下列範例程式碼顯示使用原生 SQL 日期/時間資料類型的時間欄的查詢。

SELECT
  native_date_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__timeFilter(native_date_time)

提醒

時間序列查詢應在提醒條件下運作。警示規則條件中尚不支援資料表格式的查詢。