Salesforce 开发人员 SOQL 进阶指南：关系查询、聚合函数与性能优化

十一月 28, 2025

背景与应用场景

作为一名 Salesforce 开发人员，我们的日常工作几乎离不开与数据打交道。无论是构建复杂的 Lightning Web Components、编写 Apex 触发器来自动化业务流程，还是开发用于数据处理的批处理任务，精确、高效地从 Salesforce 数据库中检索数据都是成功的基石。而实现这一切的核心工具，就是 SOQL (Salesforce Object Query Language)，即 Salesforce 对象查询语言。

对于初学者来说，一个简单的 SELECT Id, Name FROM Account WHERE Name = 'My Account' 可能已经足够。但随着业务需求的复杂化，我们很快就会发现基础查询的局限性。例如，我们需要在一个页面上同时显示客户及其所有关联的联系人信息；或者，我们需要在触发器中判断一个机会（Opportunity）的父级客户（Account）是否满足特定条件；再或者，我们需要编写一个定时任务，统计每个销售团队上个月关闭的业务总金额。这些场景都要求我们掌握更高级的 SOQL 查询技巧。

本文旨在超越基础，深入探讨 SOQL 的核心高级特性，包括关系查询、聚合函数以及性能优化策略。掌握这些技巧，将使你能够编写出更高效、更健壮、更具扩展性的 Apex 代码，从而在 Salesforce 开发的道路上更进一步。

原理说明

SOQL 的语法与标准 SQL 非常相似，但它是专门为 Salesforce 多租户环境设计的，并针对其数据模型进行了优化。理解其核心原理是写出高质量查询的关键。

1. 关系查询 (Relationship Queries)

Salesforce 的数据模型核心在于对象之间的关系（Lookup 和 Master-Detail）。SOQL 提供了强大的功能，让你能够在一个查询中遍历这些关系，从而避免了多次查询数据库，有效减少了代码复杂性并遵守了 Governor Limits。

关系查询主要分为两类：

Child-to-Parent (子到父查询): 当你从子对象（如 Contact）查询数据，并希望同时获取其父对象（如 Account）的字段时使用。这通过“点表示法” (dot notation) 实现。例如，从 Contact 查询其关联 Account 的名称，语法为 SELECT Account.Name FROM Contact。这里的 Account 是 Contact 对象上指向 Account 的关系字段名（API Name）。
Parent-to-Child (父到子查询): 当你从父对象（如 Account）查询数据，并希望在一个嵌套的子查询中获取其所有关联的子对象记录（如 Contacts）时使用。这种查询也被称为“左外连接” (left outer join)。语法是 SELECT Name, (SELECT LastName FROM Contacts) FROM Account。这里的 Contacts 是父对象与子对象之间的关系名称（通常是子对象名称的复数形式）。

2. 聚合函数 (Aggregate Functions) 与分组

当需要对数据进行汇总计算，而不是简单地罗列记录时，聚合函数就派上用场了。SOQL 支持多种标准的聚合函数，它们通常与 GROUP BY 子句结合使用。

常用函数: 包括 COUNT(), COUNT(fieldName), SUM(fieldName), AVG(fieldName), MIN(fieldName), 和 MAX(fieldName)。
GROUP BY: 用于将具有相同字段值的记录分组，以便聚合函数可以对每个组进行计算。例如，按潜在客户来源（LeadSource）对潜在客户（Lead）进行分组，并计算每个来源的数量。
HAVING: 在使用 GROUP BY 后，如果你想对聚合结果进行过滤（例如，只显示数量大于 10 的分组），就需要使用 HAVING 子句，而不是 WHERE。WHERE 用于过滤单条记录，而 HAVING 用于过滤分组后的结果。

3. 半连接 (Semi-Joins) 与反连接 (Anti-Joins)

在某些场景下，我们需要根据一个对象是否存在于另一个相关对象的查询结果中来过滤记录。这可以通过 IN 和 NOT IN 子句中的子查询来实现。

Semi-Join (IN): 获取在一个子查询结果集中的记录。例如，查找所有至少有一个已赢得（Closed Won）机会的客户。
Anti-Join (NOT IN): 获取不在一个子查询结果集中的记录。例如，查找所有没有任何关联联系人的客户。

示例代码

以下所有代码示例均来自 Salesforce 官方文档，确保其准确性和最佳实践。

1. Child-to-Parent 查询示例

此查询从联系人 (Contact) 对象中检索记录，并使用点表示法获取其关联客户 (Account) 的名称和行业信息。这避免了先查询 Contact，再根据 AccountId 单独查询 Account 的两次数据库操作。

// 在 Apex 中执行一个子到父的 SOQL 查询
List<Contact> contacts = [
    SELECT Id, LastName, Account.Name, Account.Industry
    FROM Contact
    WHERE Account.Industry = 'Media'
];

// 遍历查询结果并访问父对象的字段
for (Contact c : contacts) {
    // 直接通过 "Account.Name" 访问父对象的 Name 字段
    System.debug('Contact Name: ' + c.LastName + ', Account Name: ' + c.Account.Name);
}

2. Parent-to-Child 查询示例

此查询从客户 (Account) 对象中检索记录，并通过一个嵌套的子查询获取每个客户关联的所有联系人 (Contacts) 的姓氏。返回的结果中，每个 Account SObject 都会包含一个 Contact 类型的列表。

// 在 Apex 中执行一个父到子的 SOQL 查询
List<Account> accountsWithContacts = [
    SELECT Name, (SELECT LastName FROM Contacts)
    FROM Account
    WHERE Name = 'SFDC Account'
];

// 遍历查询结果
for (Account a : accountsWithContacts) {
    System.debug('Account Name: ' + a.Name);
    // a.Contacts 是一个包含该客户下所有联系人记录的 List<Contact>
    // 即使没有关联的联系人，这个列表也存在，只是 size 为 0，不是 null
    List<Contact> cons = a.Contacts;
    for (Contact c : cons) {
        System.debug('  Related Contact Last Name: ' + c.LastName);
    }
}

3. 聚合函数与 GROUP BY 示例

此查询使用 COUNT() 和 GROUP BY 来统计每个潜在客户来源 (LeadSource) 的数量，并将结果存储在一个 AggregateResult 对象列表中。

// 执行聚合查询
List<AggregateResult> results = [
    SELECT LeadSource, COUNT(Name)
    FROM Lead
    GROUP BY LeadSource
];

// 遍历聚合结果
for (AggregateResult ar : results) {
    // 使用 get() 方法和别名（或 'expr0' 等默认名称）来访问结果
    // COUNT(Name) 的默认别名是 'expr0'
    System.debug('Lead Source: ' + ar.get('LeadSource') + ', Count: ' + ar.get('expr0'));
}

4. Semi-Join (IN) 查询示例

此查询使用半连接查找所有在加利福尼亚州（CA）的客户所拥有的机会 (Opportunity)。它首先在子查询中找到所有 BillingState 为 'CA' 的客户 ID，然后在外层查询中匹配这些 ID。

// 使用 IN 子句和子查询来过滤记录
List<Opportunity> opportunities = [
    SELECT Id, Name, Amount
    FROM Opportunity
    WHERE AccountId IN (SELECT Id FROM Account WHERE BillingState = 'CA')
];

for (Opportunity opp : opportunities) {
    System.debug('Opportunity Name in CA: ' + opp.Name + ', Amount: ' + opp.Amount);
}

注意事项

1. Governor Limits

Salesforce 是一个多租户平台，为保证资源公平使用，设置了严格的执行限制，即 Governor Limits。作为开发人员，必须时刻牢记：

SOQL 查询次数: 在一个同步的 Apex 事务中，最多只能执行 100 次 SOQL 查询。在异步事务中（如 Batch Apex）为 200 次。绝对不要在循环中执行 SOQL 查询。
SOQL 查询返回的记录总数: 在一个 Apex 事务中，所有 SOQL 查询返回的记录总数不能超过 50,000 条。
SOQL 查询长度: 查询字符串不能超过 100,000 个字符。

2. SOQL 注入 (SOQL Injection)

当你在 Apex 中构建动态 SOQL 查询字符串时，如果直接拼接用户输入的参数，可能会导致 SOQL 注入安全漏洞。恶意用户可能利用此漏洞绕过权限检查或访问未授权的数据。为了防止这种情况，应始终使用静态查询或带有绑定变量的 `Database.query` 方法。

不安全的示例（不要使用）:

String query = 'SELECT Id FROM Contact WHERE Name = \'' + userInput + '\'';

安全的示例 (使用绑定变量):

String userInput = 'Test User';
// 将用户输入作为变量绑定到查询中，而不是直接拼接字符串
String soqlQuery = 'SELECT Id FROM Contact WHERE Name = :userInput';
List<Contact> contacts = Database.query(soqlQuery);

3. 查询性能与选择性 (Query Selectivity)

为了保证系统性能，Salesforce 会对 SOQL 查询的性能进行评估。如果一个查询的过滤条件不够明确，导致数据库需要扫描大量记录，这个查询就被认为是“非选择性”的 (non-selective)。对于大型对象，非选择性查询可能会失败并抛出 System.QueryException: Non-selective query against large object 错误。

为了让查询具有选择性，WHERE 子句中的条件字段应该是索引字段。标准索引字段包括 Id, Name, OwnerId, CreatedDate, LastModifiedDate, RecordType, 以及所有外部 ID (External ID) 或唯一 (Unique) 字段。你也可以联系 Salesforce 支持为自定义字段创建自定义索引。

总结与最佳实践

SOQL 是 Salesforce 开发中不可或缺的技能。要写出高效、可维护的代码，请遵循以下最佳实践：

批量化你的代码 (Bulkify Your Code): 永远不要在 `for` 或 `while` 循环中放置 SOQL 查询。应该先收集所有需要的 ID 或条件，然后执行一次查询来获取所有数据。
精确查询所需字段: 避免使用 SELECT * 这样的查询（SOQL 实际上也不支持）。只查询你代码逻辑中确实需要的字段，这可以减少查询时间和内存消耗。
善用关系查询: 当需要处理相关对象的数据时，优先考虑使用父到子或子到父的关系查询，这比执行多个独立的查询要高效得多，并且有助于遵守 Governor Limits。
利用 Map 减少嵌套循环: 查询数据后，通常最好将其放入一个 Map 中，以记录 ID 为键。这样在处理相关记录时，可以通过 `Map.get(Id)` 快速查找，避免低效的嵌套循环。
使用查询计划工具 (Query Plan Tool): 在开发者控制台中，可以使用“Query Plan”按钮来分析 SOQL 查询的性能，查看它是否使用了索引，以及其执行成本，这对于优化复杂查询非常有帮助。

作为 Salesforce 开发人员，对 SOQL 的掌握程度直接决定了我们应用程序的性能和扩展性。通过不断实践这些高级技巧和最佳实践，你将能够构建出更加强大和可靠的 Salesforce 解决方案。

Salesforce中文网