菜单
文档breadcrumb arrow 插件breadcrumb arrow Salesforce 数据源breadcrumb arrow Salesforce 查询编辑器

Salesforce 查询编辑器

Salesforce 查询编辑器位于探索页面。Grafana 为 Salesforce 提供了三种查询模式

有关 Grafana 查询编辑器的通用信息，请参阅查询编辑器。

请参阅探索中的查询管理，了解有关在 Grafana 中管理查询选项的更多信息。

SOQL 编辑器模式

SOQL 是 Salesforce 的查询语言。SOQL 编辑器允许您使用 SOQL 查询来查询 Salesforce 对象。SOQL 编辑器还提供自动补全建议，例如每个表的可用实体和相应的字段。在 SELECT 或 WHERE 后使用 Ctrl+Space 可以查看每个表的可用实体。在实体名称后输入点即可查看可用字段。

有关 SOQL 的详细信息，请参阅以下 Salesforce 文档

查询构建器模式

Salesforce 查询构建器是一个用户友好的界面，用于构建 SOQL 查询。如果您不太熟悉编写 SOQL 查询，可以使用此模式构建 SOQL 来查询 Salesforce 对象。

注意

当从 SOQL 编辑器模式切换到查询构建器模式时，将出现警告，提示您任何未保存的更改将会丢失。

查询构建器中的 FROM 字段指代 Salesforce 中的实体或实体集。在查询构建器中进行任何其他操作之前，您需要选择 FROM 字段。选择 FROM 字段后，您需要选择构建器模式。SOQL 构建器当前支持以下模式。

查询构建器模式中提供以下选项

  • 实体 (Entity) - Salesforce 实体或表。对应于 SOQL 语法中的 SELECT。
  • 显示为 (Show as) - 您希望查看数据的方式。
    • 表格 (Table) - 以表格格式显示查询结果。
    • 聚合 (Aggregate) - 以聚合形式显示结果，例如“按区域分组的上月机会总计数”。
    • 时间序列 (Timeseries) - 按时间显示结果，例如“按 CreatedDate 统计的机会数量”或“按机会结束日期分组的 value 总和”。
  • 字段 (Fields) - 要显示的字段列表。使用 Standard/All/Custom 显示所有字段。
  • 筛选器 (Filters) - 单击 + 添加筛选器 添加筛选条件。从下拉菜单中选择可用选项和对应的运算符。您可以选择多个筛选器。
  • 排序依据 (Order by) - 单击 + 添加排序依据 添加用于排序的字段。从下拉菜单中选择可用选项。您可以按 ASC（升序）或 DESC（降序）以及 NULLS LAST（空值最后）或 NULLS FIRST（空值最前）排序。您可以添加多个排序选项。
  • 限制 (Limit) - 返回的行数或记录数。默认值为 100。
  • SOQL 预览 (SOQL preview) - 基于先前字段配置的 SOQL 查询预览。您可以安全地切换到 SOQL 编辑器模式（不会丢失您的工作）来定制生成的查询。

报告模式

报告模式提供了一种快速访问 Salesforce 报告的方式。单击下拉菜单查看可用报告列表。

筛选器限制

使用查询构建器时，如果查询包含复杂的筛选逻辑，则会失败。仅包含 AND 语句或仅包含 OR 语句的跨多个筛选器的查询将正常工作。但是，如果同时使用 AND 和 OR 语句，建议使用 SOQL 模式。此建议也适用于使用嵌套筛选器的情况。

快捷键

您可以在 Salesforce 查询编辑器中使用以下快捷键

  • Ctrl+Space - 显示代码建议，展示相关的上下文选项。
  • Cmd+S - 运行查询。

按时间序列查询

通过将日期字段别名为 time，将指标字段别名为 metric，然后按指标和日期分组，创建时间序列查询。

示例

SOQL 
SELECT sum(Amount) amount, CloseDate time, Type metric 
FROM Opportunity
GROUP BY Type, CloseDate

宏

您可以在 SOQL 查询中使用宏，根据 Dashboard 的时间范围进行筛选。以下是可用宏

  • $__timeFrom - 替换为当前活动时间范围的起始时间，并转换为 time 数据类型。

  • $__timeTo - 替换为当前活动时间范围的结束时间，并转换为 time 数据类型。

  • $__quarterStart- 财政季度开始时间（根据 Salesforce 财政年度设置得出）

  • $__quarterEnd - 财政季度结束时间（根据 Salesforce 财政年度设置得出）

示例

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

模板和变量

要添加新的 Salesforce 查询变量，请参阅添加查询变量。将 Salesforce 用作您的数据源。您可以在此处使用任何 SOQL 查询。

要使用名称/值对，例如用户 ID 和用户名，请在 SOQL 查询中返回两个字段。第一个字段将用作 ID。当您想在 SOQL 查询编辑器中按键（例如 ID）进行筛选时，此方法非常有用。

通过使用变量语法将变量纳入 SOQL 查询中。

有关变量的更多信息，请参阅模板和变量。