連線至 Salesforce 資料來源 - Amazon Managed Grafana
已知限制必要設定新增資料來源查詢 Salesforce 資料來源範本和變數

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

連線至 Salesforce 資料來源

注意

此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱管理企業外掛程式的存取。

此外，在支援第 9 版或更新版本的工作區中，此資料來源可能需要您安裝適當的外掛程式。如需詳細資訊，請參閱使用外掛程式擴充工作區。

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

若要使用此資料來源，您必須擁有 Salesforce 帳戶和 Salesforce Connected 應用程式。

已知限制

  • 尚未支援專用篩選條件。

  • 目前僅支援 SOQL 查詢，以及可透過 SOQL 存取的資料。尚不支援 SOSL 和 SAQL 查詢格式。

必要設定

需要下列設定。

注意

外掛程式目前使用 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 您可以啟用或停用此功能。

新增資料來源

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

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

  3. 選擇新增資料來源。

    注意

    如果您在側邊選單中看不到資料來源連結，表示您目前的使用者沒有 Admin角色。

  4. 從資料來源清單中選擇 Salesforce。

  5. 輸入下列資訊：

    • 在使用者名稱中，輸入您要用來連接和查詢 Salesforce 的 Salesforce 帳戶的使用者名稱。

    • 針對密碼，輸入該使用者的密碼。

    • 針對安全字符，輸入該使用者的安全字符。

    • 針對取用者金鑰，輸入取用者金鑰以連線至 Salesforce。您可以從 Salesforce Connected 應用程式取得此項目。

    • 針對消費者機密，輸入消費者機密以連線至 Salesforce。您可以從 Salesforce Connected 應用程式取得此項目。

    • 針對使用沙盒，如果您想要使用 Salesforce 沙盒，請選取此選項。

查詢 Salesforce 資料來源

查詢編輯器支援查詢建置器和 SOQL 編輯器模式。SOQL 代表 Salesforce 物件查詢語言。

Query Builder (SOQL Builder)

Query Builder 是用於建置 SOQL 查詢的易用界面。如果您不熟悉撰寫 SOQL 查詢，您可以使用此模式來建置 SOQL 來查詢 Salesforce 物件。查詢建置器中的 FROM 欄位是指 Salesforce 中的實體。您需要先選取 FROM 欄位，才能執行查詢建置器中的任何其他操作。選擇 FROM 欄位後，您需要選擇建置器模式。SOQL Builder 目前支援下列模式。

  • List— 列出項目及其所選資料表/salesforce 中的欄位。使用此模式來取得結果，例如「顯示本會計季度建立的機會清單及其名稱、值和階段」。

  • Aggregate— 彙總實體中的項目。使用此模式來取得結果，例如「計算上個月建立的機會」。或「依階段名稱分組的機會總值是多少？」

  • Trend— 顯示一段時間內的彙總結果。使用此模式取得結果，例如「按 CreatedDate." 或「按機會的結束日期分組的值總和是多少。」

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

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

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

SOQL 編輯器

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

捷徑

使用 CTRL + SPACE 顯示程式碼完成，其中顯示可用的內容選項。

CMD + 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

範本和變數

若要新增 Salesforce 查詢變數，請參閱 新增查詢變數。使用您的 Salesforce 資料來源作為資料來源。您可以在此使用任何 SOQL 查詢。

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

使用變數語法，在 SOQL 查詢中使用 變數。如需詳細資訊，請參閱變數語法。