连接到 Salesforce 数据来源 - Amazon Managed Grafana
已知限制条件必需的设置添加数据来源查询 Salesforce 数据来源模板和变量

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

连接到 Salesforce 数据来源

注意

此数据来源仅适用于 Grafana Enterprise。有关更多信息，请参阅 管理对 Enterprise 插件的访问。

此外，在支持版本 9 或更高版本的工作区中，此数据来源可能需要您安装相应的插件。有关更多信息，请参阅 使用插件扩展您的工作区。

Salesforce 数据来源使您能够在 Amazon Managed Grafana 中可视化来自 Salesforce 的数据。

要使用此数据来源，您必须拥有 Salesforce 账户和 Salesforce 连接的应用程序。

已知限制条件

  • 尚不支持临时筛选条件。

  • 目前仅支持 SOQL 查询和可通过 SOQL 访问的数据。目前尚不支持 SOSL 和 SAQL 查询格式。

必需的设置

以下设置是必需的。

注意

该插件目前使用 OAuth 2.0 用户名密码流程。未使用连接的应用程序中所需的回调 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 连接的应用程序处获取。

    • 对于使用者密钥，输入要连接到 Salesforce 的使用者密钥。您可以从 Salesforce 连接的应用程序处获取。

    • 对于使用沙盒，如果您要使用 Salesforce 沙盒，请选择此选项。

查询 Salesforce 数据来源

查询编辑器支持查询生成器和 SOQL 编辑器模式。SOQL 代表 Salesforce 对象查询语言。

查询生成器（SOQL 生成器）

查询生成器是一个用户友好的界面，用于生成 SOQL 查询。如果您不熟悉如何编写 SOQL 查询，则可以使用此模式生成 SOQL，从而查询 Salesforce 对象。查询生成器中的 FROM 字段指的是 Salesforce 中的一个或多个实体。您需要首先选择 FROM 字段，然后才能在查询生成器中进行任何其他操作。选择 FROM 字段后，需要选择生成器模式。SOQL 生成器当前支持以下模式。

  • List：列出选定表/salesforce 中的项目及其字段。使用此模式可以获得诸如“显示本财季创造的商机列表及其名称、价值和阶段”的结果。

  • Aggregate：汇总实体中的项目。使用此模式可以获得诸如“统计上个月创造的商机”的结果。或“按阶段名称分组的商机的总价值是多少？”

  • Trend：显示一段时间内的汇总结果。使用此模式可以获得诸如 “计算机会数量” 之类的结果 CreatedDate。或“按商机截止日期分组的总价值是多少。”

在查询编辑器中选择 Entity/FROM 和模式后，使用以下选项生成查询。

字段 适用于 描述
SELECT ALL 选择要查看的字段列表。对于汇总视图或趋势视图，还可选择要汇总值的方式。
WHERE ALL （可选）指定筛选条件。系统会根据您选择的条件筛选结果。
ORDER BY LIST, AGGREGATE （可选）选择字段名称和所需的结果排序顺序。
LIMIT LIST, AGGREGATE （可选）限制返回的结果数。默认值为 100。
GROUP BY AGGREGATE （可选）如果要按任何特定字段拆分汇总值，请选择该字段。
TIME FIELD TREND 指定要按其对结果进行分组的日期字段。结果是根据 Grafana 的时间选择器范围进行筛选的。

在查询编辑器中配置上述字段时，还将在查询编辑器下方看到生成的 SOQL 的预览。如果您在查询生成器中因任何限制而导致操作被阻止，则可以安全地切换到 SOQL 编辑器，您可以在其中自定义生成的 SOQL 查询。

SOQL 编辑器

原始 SOQL 编辑器提供了通过原始 SOQL 查询来查询 Salesforce 对象的选项。SOQL 编辑器提供自动完成建议，例如每个表的可用实体和相应的字段。在 SELECT 或 WHERE 之后使用 Ctrl + 空格键查看每个表的可用实体。如果在实体名称后输入一个点，则可以看到可用字段。

快捷键

使用 CTRL + 空格键显示代码完成功能，它会显示可用的上下文选项。

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 查询中使用该变量。有关更多信息，请参阅 变量语法。