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

# 連線至 Snowflake 資料來源
<a name="snowflake-datasource-for-AMG"></a>

 使用 Snowflake Enterprise 資料來源，您可以將 Snowflake 資料與 Grafana 中的所有其他資料來源以及內容中的日誌和指標資料視覺化。此資料來源包含功能強大的預先類型查詢編輯器、支援複雜的註釋、設定提醒閾值、控制存取和許可等。

**注意**  
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。  
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。

## 概觀
<a name="snowflake-overview"></a>

### 什麼是 Snowflake？
<a name="what-is-snowflake"></a>

 Snowflake 提供雲端資料儲存和分析服務，通常稱為「資料warehouse-as-a-service」，提供資料倉儲、資料湖、資料工程、資料科學、資料應用程式開發和資料共用的解決方案。在過去幾年中，由於 Snowflake 能夠以經濟實惠的方式使用雲端型硬體和軟體存放和分析資料，因此廣受好評；最近成為史上最大的軟體 IPO。如今，許多公司使用 Snowflake 作為其主要資料庫來存放應用程式和商業資料，例如交易計數、作用中的使用者工作階段，甚至是時間序列和指標資料。

### 充分利用 Snowflake 和 Amazon Managed Grafana
<a name="making-the-most-of-snowflake-and-AMG"></a>

 **視覺化 Snowflake 資料而不移動：**Grafana 的唯一架構會直接查詢資料，而不是移動資料並支付備援儲存和擷取的費用。

 **從各種來源編寫面板：**使用預先建置的自訂儀表板，將來自許多不同資料來源的資料整合到單一玻璃窗格中。

 **在使用者層級轉換和運算**：使用者可以轉換資料，並根據他們看到的資料執行各種運算，從而減少資料準備。

 **在面板中結合、運算和視覺化**：建立混合資料來源面板，顯示來自 Snowflake 和其他來源的相關資料。

### 功能
<a name="snowflake-features"></a>

 **查詢編輯器：**查詢編輯器是一種智慧型 SQL 自動完成編輯器，可讓您視覺化時間序列或資料表資料、處理 SQL 語法錯誤，以及自動完成基本 SQL 關鍵字。

 **資料來源許可**：控制誰可以在 Grafana 中檢視或查詢 Snowflake 資料 

 **註釋：**在任何 Grafana 圖形上疊加 Snowflake 事件，以關聯事件與其他圖形資料 

 **警示：**在 Snowflake 中設定警示型指標存放區 

 **查詢的變數：**根據 Snowflake 資料在 Grafana 中建立範本變數，並在 Snowflake 查詢中包含變數以建立互動式儀表板。

 **多指標查詢：**撰寫單一查詢，傳回多個指標，每個指標都在自己的資料欄中 

## 開始使用 Snowflake 外掛程式
<a name="get-started-with-the-snowflake-plugin"></a>

 以下是在 Grafana 中開始使用 Snowflake 外掛程式的五個快速步驟：

### 步驟 1：設定 Snowflake 資料來源
<a name="set-up-the-snowflake-data-source"></a>

 若要設定資料來源，請選擇**組態**、**資料來源**、**新增資料來源**、Snowflake。

 新增身分驗證詳細資訊，且資料來源已準備好進行查詢！

 下列組態欄位可供使用。


|  名稱  |  描述  | 
| --- | --- | 
|  帳戶  |  Snowflake 的帳戶。 | 
|  使用者名稱  |  服務帳戶的使用者名稱。 | 
|  密碼  |  服務帳戶的密碼。 | 
|  結構描述 （選用）  |  設定查詢的預設結構描述。 | 
|  倉儲 （選用）  |  設定查詢的預設倉儲。 | 
|  資料庫 （選用）  |  設定查詢的預設資料庫。 | 
|  角色 （選用）  |  擔任查詢的角色。 | 

### 步驟 2：寫入 Snowflake 資料的查詢
<a name="write-queries-for-your-snowflake-data"></a>

 在儀表板中建立面板，然後選取 Snowflake 資料來源以開始使用查詢編輯器。
+  只要包含日期/時間，它就會出現在查詢中的任何位置。
+  必須包含數值欄。這可以是彙總或 int/float 資料欄。
+  或者，如果您的時間序列資料已針對不同的指標進行格式化，您可以包含字串資料欄來建立個別的資料序列。

#### Snowflake 查詢的配置
<a name="layout-of-a-snowflake-query"></a>

```
select
  <time_column>,
  <any_numerical_column>
  <other_column_1>,
  <other_column_2>,
  <...>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign
```

#### 依間隔分類的時間序列群組 SQL 查詢格式
<a name="sql-query-format-for-timeseries-group-by-interval"></a>

```
select
  $__timeGroup(created_ts, '1h'), // group time by interval of 1h
  <time_column>, 
  <any_numerical_column>,
  <metric_column>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign
group by <time_column>
```

#### 資料表的 SQL 查詢格式
<a name="sql-query-format-for-tables"></a>

```
select
  <time_column>, // optional if result format option is table
  <any_column_1>
  <any_column_2>
  <any_column_3>
from
  <any_table>
where
  $__timeFilter(time_column) // macro for time range, optional if format as option is table
  and $<custom_variable> = 1 // custom variables start with dollar sign
```

### 步驟 3：建立和使用範本變數
<a name="snowflake-create-and-use-template-variables"></a>

#### 使用範本變數
<a name="snowflake-using-template-variables-1"></a>

 您可以在查詢中包含範本變數，如下列範例所示。

```
 select
   <column>
 from 
   <table>
 WHERE column >= '$variable'
```

 下列範例顯示在查詢中使用多值變數。

```
select
  <column>
from 
  <table>
WHERE <column> regexp '${variable:regex}'
```

#### 使用 Snowflake 資料來源建立變數
<a name="using-the-snowflake-datasource-to-create-variables"></a>

 在儀表板設定中，選擇**變數**，然後選擇**新增**。

 使用「查詢」變數類型，選取 Snowflake 資料來源做為「資料來源」。

**重要**  
 請務必在變數查詢中只選取一個資料欄。

 範例：

```
SELECT DISTINCT query_type from account_usage.query_history;
```

 會為您提供這些變數：

```
All DESCRIBE USE UNKNOWN GRANT SELECT CREATE DROP SHOW
```

### 步驟 4：設定提醒
<a name="snowflake-set-up-an-alert"></a>

 您可以針對特定 Snowflake 指標或您建立的查詢設定提醒。

 在查詢編輯器中選擇提醒索引標籤按鈕，然後選擇**建立提醒**。

### 步驟 5. 建立註釋
<a name="snowflake-create-an-annotation"></a>

 註釋可讓您在圖形上疊加事件。

 若要建立註釋，請在儀表板設定中選擇**註釋**和**新增**，然後選取 Snowflake 作為資料來源。

 由於註釋是事件，因此它們至少需要一個時間欄和一個資料欄來描述事件。

 下列範例程式碼顯示查詢，以註釋所有 Snowflake 失敗的登入。

```
SELECT
  EVENT_TIMESTAMP as time,
  EVENT_TYPE,
  CLIENT_IP
FROM ACCOUNT_USAGE.LOGIN_HISTORY
WHERE $__timeFilter(time) AND IS_SUCCESS!='YES'
ORDER BY time ASC;
```

 及 
+  時間： `TIME`
+  標題： `EVENT_TYPE`
+  文字： `CLIENT_IP`

 這將在儀表板面板上疊加所有登入 Snowflake 失敗的註釋。

## 其他功能
<a name="additional-functionality"></a>

### 使用顯示名稱欄位
<a name="snowflake-using-display-name"></a>

 此外掛程式使用選項面板欄位索引標籤中的顯示名稱欄位，根據其名稱、標籤或值來縮短或修改圖例金鑰。其他資料來源使用自訂`alias`功能來修改圖例索引鍵，但顯示名稱函數是更一致的方法。

### 資料來源許可
<a name="snowflake-data-source-permissions"></a>

 選擇資料來源組態頁面中的**許可**索引標籤來啟用資料來源許可，以限制對 Snowflake 的存取。在許可頁面上，管理員可以啟用許可，並將查詢許可限制為特定使用者和團隊。

### 了解您的 Snowflake 帳單和用量資料
<a name="understand-your-snowflake-billing-and-usage-data"></a>

 在 Snowflake 資料來源中，您可以匯入帳單和用量儀表板，顯示有用的帳單和用量資訊。

 在 Snowflake 資料來源組態頁面中新增儀表板：

 此儀表板使用 ACCOUNT\$1USAGE 資料庫，並要求佇列具有 ACCOUNTADMIN 角色。若要安全地執行此操作，請建立新的 Grafana 資料來源，其中包含具有 ACCOUNTADMIN 角色的使用者。然後在變數中選取該資料來源。