連線至 MySQL 資料來源

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

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

新增 MySQL 資料來源，以查詢和視覺化 MySQL 相容資料庫的資料。

新增資料來源

資料來源選項

最小時間間隔

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

資料庫使用者許可

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

 CREATE USER 'grafanaReader' IDENTIFIED BY 'password';
 GRANT SELECT ON mydatabase.mytable TO 'grafanaReader';

若要授予對更多資料庫和資料表的存取權，您可以視需要使用萬用字元 (*) 取代資料庫或資料表。

查詢編輯器

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

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

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

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

在 FROM 欄位中，Grafana 會建議已設定資料庫中的資料表。若要選取資料庫使用者可存取的另一個資料庫中的資料表或檢視，您可以手動輸入完整名稱 (database.table)，例如 otherDb.metrics。

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

指標欄建議只會包含文字資料類型 （文字、小文字、中文字、長文字、varchar、char) 的資料欄。如果您想要使用具有不同資料類型的資料欄做為指標資料欄，則可以輸入具有轉換的資料欄名稱：CAST(numericColumn as CHAR)。您也可以在指標資料欄欄位中輸入任意 SQL 表達式，評估為文字資料類型，例如 CONCAT(column1, " ", CAST(numericColumn as CHAR))。

資料欄和彙總函數 (SELECT)

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

如果您使用彙總函數，則必須將結果集分組。GROUP BY time如果您新增彙總函數，編輯器會自動新增 。

您可以透過選擇加號按鈕並從Column選單中選擇，來新增更多值欄。在圖形面板中，多個值資料欄將繪製為單獨的序列。

篩選資料 (WHERE)

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

分組依據

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

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

間隙填充

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

文字編輯器模式 （原始）

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

巨集

為了簡化語法並允許動態部分，例如日期範圍篩選條件，查詢可以包含巨集。

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

資料表查詢

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

下列程式碼顯示查詢範例。

SELECT
  title as 'Title',
  user.login as 'Created By' ,
  dashboard.created as 'Created On'
 FROM dashboard
INNER JOIN user on user.id = dashboard.created_by
WHERE $__timeFilter(dashboard.created)

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

時間序列查詢

如果您將 Format 設定為 Time series，例如在圖形面板中使用，查詢必須傳回名為 的資料欄time，該資料欄會傳回 SQL datetime 或任何代表 Unix epoch 的數值資料類型。除了 time和 以外的任何資料欄metric都會視為值資料欄。您可以傳回名為 的資料欄metric，做為值資料欄的指標名稱。如果您傳回多個值資料欄和名為 的資料欄metric，則此資料欄會用作序列名稱的字首 （僅適用於 Grafana 5.3+)。

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

下列程式碼範例顯示 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_double) 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，您可以撰寫 MySQL 查詢，以傳回如測量名稱、索引鍵名稱或顯示為下拉式清單選取方塊的索引鍵值等物件。

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

SELECT hostname FROM my_host

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

SELECT my_host.hostname, my_other_host.hostname2 FROM my_host JOIN my_other_host ON my_host.city = my_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 my_host

您也可以建立巢狀變數。例如，如果您有另一個名為 的變數region。然後，您可以讓主機變數只顯示目前所選區域中具有此類查詢的主機 （如果 region 是多值變數，則使用IN比較運算子，而不是=比對多個值）。

SELECT hostname FROM my_host  WHERE region IN($region)

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

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

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

SELECT hostname FROM my_host  WHERE hostname LIKE '$__searchFilter'

在查詢中使用變數

從 Grafana 4.3.0 到 4.6.0，範本變數一律會自動進行引號，因此如果是字串值，則不會在 子句的引號中包裝它們。

從 Grafana 4.7.0 版中，只有在範本變數是 時，才會引用範本變數值。 multi-value

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

有兩種語法：

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

SELECT
  UNIX_TIMESTAMP(atimestamp) as time,
  aint as value,
  avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC

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

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

關閉多值變數的引號

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

${servers:csv}

如需變數格式化選項的詳細資訊，請參閱 進階變數格式選項。

註釋

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

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

SELECT
  epoch_time as time,
  metric1 as text,
  CONCAT(tag1, ',', tag2) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

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

SELECT
  epoch_time as time,
  epoch_timeend as timeend,
  metric1 as text,
  CONCAT(tag1, ',', tag2) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

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

SELECT
  native_date_time as time,
  metric1 as text,
  CONCAT(tag1, ',', tag2) as tags
FROM
  public.test_data
WHERE
  $__timeFilter(native_date_time)

提醒

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