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

# 連線至 Salesforce 資料來源
<a name="salesforce-AMG-datasource"></a>

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

Salesforce 資料來源可讓您將 Amazon Managed Grafana 內來自 Salesforce 的資料視覺化。

若要使用此資料來源，您必須擁有 [Salesforce](https://www.salesforce.com/) 帳戶和 [Salesforce Connected 應用程式](https://help.salesforce.com/articleView?id=sf.connected_app_overview.htm&type=5)。

## 已知限制
<a name="salesforce-known-limitations"></a>
+  尚未支援臨機操作篩選條件。
+  目前僅支援 SOQL 查詢，以及可透過 SOQL 存取的資料。尚不支援 SOSL 和 SAQL 查詢格式。

## 必要設定
<a name="salesforce-settings"></a>

需要下列設定。

**注意**  
外掛程式目前使用 OAuth 2.0 Username-Password Flow。未使用連線應用程式中所需的回呼 URL。因此，您可以將其設定為任何有效的 URL。


|  名稱  |  描述  | 
| --- | --- | 
|  Enable OAuth settings  |  您必須勾選此項才能啟用 OAuth。 | 
|  Callback URL  |  未用於此外掛程式，因此您可以指定任何有效的 URL。 | 
|  Selected OAuth Scopes (minimum requirements)  | 存取和管理您的資料 (api)。 | 
|  Require Secret for Refresh Token Flow  |  您可以啟用或停用此功能。 | 

## 新增資料來源
<a name="salesforce-adding-the-data-source"></a>

1.  在 Amazon Managed Grafana 工作區中開啟 Grafana 主控台，並確保您已登入。

1.  在**組態** （齒輪圖示） 下的側邊選單中，選擇**資料來源**。

1.  選擇**新增資料來源**。
**注意**  
 如果您在側邊選單中看不到**資料來源**連結，表示您目前的使用者沒有 `Admin`角色。

1.  從資料來源清單中選取 **Salesforce**。

1. 輸入下列資訊：
   + 在**使用者名稱**中，輸入您要用來連接和查詢 Salesforce 的 Salesforce 帳戶的使用者名稱。
   + 針對**密碼**，輸入該使用者的密碼。
   + 針對**安全字符**，輸入該使用者的安全字符。
   + 針對**取用者金鑰**，輸入取用者金鑰以連線至 Salesforce。您可以從 Salesforce Connected 應用程式取得此資訊。
   + 在**消費者秘密**中，輸入要連線至 Salesforce 的消費者秘密。您可以從 Salesforce Connected 應用程式取得此資訊。
   + 針對**使用沙盒**，如果您想要使用 Salesforce 沙盒，請選取此選項。

## 查詢 Salesforce 資料來源
<a name="salesforce-query"></a>

查詢編輯器支援查詢建置器和 SOQL 編輯器模式。SOQL 代表 [ Salesforce 物件查詢語言](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm)。

### 查詢建置器 (SOQL Builder)
<a name="salesforce-query-builder"></a>

Query Builder 是用於建置 SOQL 查詢的易用界面。如果您不熟悉撰寫 SOQL 查詢，您可以使用此模式來建置 SOQL 來查詢 Salesforce 物件。查詢建置器中的 **FROM** 欄位是指 Salesforce 中的實體。您需要在查詢建置器中的任何其他操作之前選取 **FROM** 欄位。選擇 **FROM** 欄位後，您需要選擇建置器模式。SOQL Builder 目前支援下列模式。
+ `List`— 從選取的資料表/salesforce 列出項目及其欄位。使用此模式來取得結果，例如「顯示本會計季度建立的機會清單及其名稱、值和階段」。
+ `Aggregate`— 彙總實體中的項目。使用此模式來取得結果，例如「計算上個月建立的機會」。或「依階段名稱分組的機會總值是多少？」
+ `Trend`— 顯示一段時間內的彙總結果。使用此模式取得結果，例如「Count the opportunities by CreatedDate." 或「按機會的結束日期分組的值總和是多少。」

在查詢編輯器中選擇 `Entity/FROM`和 **模式**之後，請使用下列選項建置查詢。


|  **欄位**  |  **適用於**  |  **描述**  | 
| --- | --- | --- | 
|  SELECT |  ALL  |  選取您要查看的欄位清單。針對彙總或趨勢檢視，也請選取您要彙總值的方式。 | 
|  WHERE |  ALL  |  （選用） 指定篩選條件。系統會根據您選取的條件篩選結果。 | 
|  ORDER BY |  LIST，彙總  |  （選用） 選取您要用於結果的欄位名稱和排序順序。 | 
|  LIMIT |  LIST，彙總  |  （選用） 限制傳回的結果數量。預設為 100。 | 
|  GROUP BY |  AGGREGATE  |  （選用） 如果您想要依任何特定欄位分割彙總值，請選取欄位。 | 
|  時間欄位 |  趨勢  |  指定您要將結果分組的日期欄位。結果會根據 Grafana 的時間挑選器範圍進行篩選。 | 

您在查詢編輯器中設定上述欄位，您也會在查詢編輯器下方看到產生的 SOQL 預覽。如果您因為查詢建置器中的任何限制而遭到封鎖，您可以安全地切換到 SOQL 編輯器，您可以在其中自訂產生的 SOQL 查詢。

### SOQL 編輯器
<a name="salesforce-SOQL-editor"></a>

原始 SOQL 編輯器提供透過原始 SOQL 查詢來查詢 Salesforce 物件的選項。SOQL 編輯器提供自動完成建議，例如每個資料表的可用實體和對應的欄位。在 SELECT 或 WHERE 之後使用 Ctrl\$1Space 來查看每個資料表的可用實體。如果您在實體名稱後面輸入點，您可以看到可用的欄位。

**捷徑**

使用 CTRL \$1 SPACE 顯示程式碼完成，顯示可用的內容選項。

CMD \$1 S 會執行查詢。

**以時間序列的形式查詢**

將日期欄位與指標別名化，然後依指標和日期分組，以建立時間序列查詢。以下是範例：

```
SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity
group by Type, CloseDate
```

**巨集**

若要依儀表板時間範圍進行篩選，您可以在 SOQL 查詢中使用巨集：
+ `$__timeFrom`— 將由轉換為`time`資料類型之目前作用中時間選擇的開始取代。
+ `$__timeTo`— 將取代為目前作用中時間選擇的結尾，轉換為 `time`資料類型。
+ `$__quarterStart`— 會計季度的開始 （衍生自 SalesForce 會計年度設定）。
+ `$__quarterEnd`— 會計季度結束 （衍生自 SalesForce 會計年度設定）。

```
SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom
```

## 範本和變數
<a name="salesforce-templates"></a>

若要新增 Salesforce 查詢變數，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。使用您的 Salesforce 資料來源做為資料來源。您可以在此使用任何 SOQL 查詢。

如果您想要使用名稱/值對，例如使用者 ID 和使用者名稱，請從 SOQL 查詢傳回兩個欄位。第一個欄位將用作 ID。當您想要在查詢編輯器 SOQL 中依索引鍵 (ID 等） 篩選時，請執行此操作。

使用變數語法，在 SOQL 查詢中使用 變數。如需詳細資訊，請參閱[變數語法](templates-and-variables.md#variable-syntax)。