Salesforce 数据库操作简介

Salesforce 中的数据库操作方式

Salesforce 为用户和开发者提供了四种基本的数据库操作方式：

• Apex 中的 DML 语句
• Apex 中的 Database 类
• SOQL 查询
• SOSL 查询

DML 语句

DML 全称 Data Manipulation Language，是 Apex 中直接进行数据库操作的一组命令。和大多数数据库类似，DML 语句包括：

• insert，插入
• update，更新
• upsert，插入或更新
• delete，删除
• undelete，撤销删除
• merge，合并
  
  每个DML语句都可以对一个或多个 sObject 对象进行操作。Salesforce 鼓励用户使用同一条 DML 语句对多条数据进行操作，而不是对每条数据分别调用一次相同的 DML 语句。这样做可以优化执行效率。

upsert 语句特点

upsert 语句包括了 insert 和 update 的功能。对于将要进行 upsert 操作的数据，Salesforce 会检索数据库中这些数据是否已经存在。对于已经存在的数据，进行 update 处理，对于不存在的数据，进行 insert 处理。

需要注意的是，upsert 语句的执行效率比 update 和 insert 都要低，所以我们在进行开发的时候，要尽可能的避免使用 upsert 语句。

merge 语句特点

merge 语句可以将至多三条相同类型的记录合并，只保留一条数据，删除其他两条，并将之前与三条记录相关的其他数据记录重新关联到保留的记录中。

系统内的 ID 字段

对于每个对象，无论是标准的还是自定义的，Salesforce 都会自动创建一个 ID 字段。该字段的值是由系统自动生成，在整个系统内部唯一存在，并且不会更改。

在用户利用 DML 的 insert 或 upsert 语句插入新的数据记录后，便可以直接使用该记录的 ID 字段。

Account acc = new Account(Name='test account');

insert acc;

ID accountId = acc.Id;

在上面的代码中，变量 accountId 中存储了刚刚建立的 Account 记录的 ID 值。用户可以立即利用该 ID 值进行其他操作。

DML 语句操作示例

// 插入单条数据
Account acc = new Account(Name='test');
insert acc;

// 插入多条数据
List<Account> accList = new List<Account> {
    new Account(Name='test1'),
    new Account(Name='test2'),
    new Account(Name='test3'),
    new Account(Name='test4')
};
insert accList;

// 更新单条数据
acc.Name = 'test name';
update acc;

// 更新多条数据
for(Account a : accList) {
    a.Phone = '12345678';
}
update accList;

// 删除单条数据
delete acc;

// 删除多条数据
delete accList;

upsert 语句示例

upsert 语句运行时，先比较数据中某个字段的值是否在数据库中已经存在，如果存在则更新该数据，否则插入该数据。

upsert 语句有两个参数，第一个参数是需要操作的单条数据或一组数据，第二个参数是可选参数，表明了应该用数据中的哪个字段进行比较，如果没有声明则默认使用ID字段。

要注意的是，第二个参数必须是 ID 字段、自定义的“外部 ID”字段或者索引字段。

假设 Contact 对象中有一个“外部 ID”字段，名为“External_contact_person_number__c”，那么：

// 插入一条Contact数据
Contact con1 = new Contact(FirstName='A', LastName='LA');
insert con1;

// 插入数据之后更新数据
con1.Description = 'inserted contact 1';

// 新建另一条Contact数据
Contact con2 = new Contact(FirstName='B', LastName='LB');

// 将两条Contact数据加入一个列表中
List<Contact> cons = new List<Contact> { con1, con2 };

// 对列表进行upsert操作
upsert cons;

上面代码执行的结果是 con1 数据被更新了，con2 数据被插入了。

如果上面的代码改为：

Contact con1 = new Contact(FirstName='A', LastName='LA', External_contact_person_number__c = 'ex001');
insert con1;

Contact con2 = new Contact(FirstName='B', LastName='LB', External_contact_person_number__c = 'ex001');

upsert con2 Contact.Fields.External_contact_person_number__c;

那么系统在 upsert 时会比较 Contact 数据中的 External_contact_person_number__c 字段，找到 External_contact_person_number__c 字段是 “ex001” 的数据，然后直接进行更新。所以上面代码的执行之后，系统中只有一条 Contact 记录，其 FirstName 和 LastName 字段的值被更新为 “B”。

注意，如果在 upsert 语句执行时，系统查找到系统中已经有两条或更多符合条件的记录，则该操作会报错，不会更新或插入任何数据。比如：

// 插入多条数据
List<Contact> conList = new List<Contact> {
    new Contact(FirstName='A', LastName='LA', External_contact_person_number__c = 'ex001'),
    new Contact(FirstName='B', LastName='LB', External_contact_person_number__c = 'ex001')
};
insert conList;

// 新建数据
Contact con = new Contact(FirstName='C', LastName='LC', External_contact_person_number__c = 'ex001');

// upsert新建的数据，基于LastName字段
upsert con Contact.Fields.External_contact_person_number__c;

这段代码会报错，因为系统中已经有了两条 External_contact_person_number__c 为 “ex001” 的数据，无法进行插入或更新。

如果最后的 upsert 操作改为：

upsert con;

则不会有问题，因为比较的是 ID 字段，而 ID 字段必然是唯一的，不存在于系统中，所以该记录（con）会被插入。

Database 类

Apex中有Database类，其中包含了一组静态函数，它们的作用和 DML 语句类似：

• Database.insert()
• Database.update()
• Database.upsert()
• Database.delete()
• Database.undelete()
• Database.merge()
  
  与 DML 语句不同的是，每个函数都有一个可选布尔型参数，可以决定当操作的一组数据中部分数据出现错误时，是否将没有出错的数据继续执行相应的命令。

比如：

Database.insert(accList, false);

如果插入的一组数据 accList 中有不符合条件的数据，那么系统会跳过这些数据，将剩下的数据成功插入数据库，并且不会报错。

该布尔型参数默认为“真”（true）。当有部分数据出错时，所有数据都不会被执行相应的操作，并报错。

Database 类的操作返回值

Database 类的操作函数会返回一组值，对于进行操作的每一条数据，都会有成功或失败的信息。

// insert 的结果
Database.SaveResult[] = Database.insert(recordList, false);

// upsert 的结果
Database.UpsertResult[] = Database.upsert(recordList, false);

// delete 的结果
Database.DeleteResult[] = Database.delete(recordList, false);

SOQL

SOQL 是 Salesforce 提供的数据库操作语言，全称是 Salesforce Object Query Language，类似于 SQL。

在 Developer Console 的 Query Editor 部分，可以键入 SOQL 语句并进行查询。

在 Apex 中，可以直接调用 SOQL 语句操作一个或一组 sObject 对象。

比如：

List<Account> accList = [SELECT Name FROM Account];

SOQL 语法

SOQL 基本语法和 SQL 类似，比如 SELECT 语句的格式是：

SELECT 字段 FROM sObject [WHERE 条件]

其中 WHERE 语句是可选部分。

要注意的是：

1. SELECT 后面声明的字段需要用逗号隔开，并且不能用“*”来选取所有字段，必须声明每个要查询的字段
2. 对于不存在于 SELECT 语句的字段，系统不会去查询其值，所以后面的语句无法使用这些字段的值

比如：

List<Account> accList = [SELECT Id, Name FROM Account];

// 使用 Phone 字段会出错
// accList[0].Phone = '12345678';

查询结果中的每个 Account 对象只包含 Id 和 Name 字段的值，如果用户想使用 Phone 字段的值，系统会报错。

SELECT 语句后面也可以加 ORDER BY 和 LIMIT 语句。比如：

List<Account> accList = [SELECT Id, Name FROM Account ORDER BY Name LIMIT 20];

通配符

在 SOQL 的 WHERE 语句中，如果想查询某字段包含某个值的话，可以用通配符进行模糊查询。比如：

SELECT Id, Name FROM Account WHERE Name LIKE '%test%'

上面的语句查询的是字段 Name 中包含 “test” 的所有 Account 记录。

使用变量

如果要在 SOQL 查询中使用变量，则变量名前需要用“:”来引导。比如：

String queryStr = 'test';

List<Account> accList = [SELECT Id, Name FROM Account WHERE Name LIKE :queryStr];

关联对象的查询

在 SOQL 语句中，可以嵌套查询相关联的对象。在子对象中，定义了和父对象相关联的字段，其中的“子级关系名称”属性需要在查询中使用。

对于标准对象，“子级关系名称”可以直接使用。对于自定义对象，要在“子级关系名称”后面加上“__r”。

比如：

// 嵌套查询和 Account 相关的 Contact 对象，其中 “Contacts” 是 Contact 对象中和父对象 Account 关系字段的子级关系名称
List<Account> accWithConList = [SELECT Name,
                                        (SELECT FirstName, LastName FROM Contacts)
                                FROM Account
                                WHERE Name like '%test'
];

// 查询到的 Contact 对象
List<Contact> firstConList = accWithConList[0].Contacts;

// 使用 Contact 对象中查询到的值
String firstNameFromQuery = firstConList[0].FirstName;
String lastNameFromQuery = firstConList[0].LastName;

又如：

// 查询父对象的字段内容
List<Contact> conList = [SELECT Account.Name FROM Contact WHERE FirstName = 'testFirst'];

// 使用父对象的字段内容
String accName = conList[0].Account.Name;

自定义对象的关联对象

比如：

1. 在系统中建立了 “Address__c” 对象和 “Street__c” 对象
2. 每个 “Address__c” 对象中包含若干个 “Street__c” 对象
3. 在 “Street__c” 对象中定义了字段表明和 “Address__c”的关系，其“子级关系名称”的名字是 “Streets”。那么查询可以这样写：

// 从父对象查询子对象的字段
SELECT Name, (SELECT Name FROM Streets__r) FROM Address__c

// 从子对象查询父对象的字段
SELECT Name, Address__r.Name FROM Street__c

SOSL

SOSL 是 Salesforce 提供的数据库操作语言，全称是 Salesforce Object Search Language。

SOSL 主要用于在数据库的各个对象中查询符合条件的列。

SOSL 和 SOQL 类似，都可以在 Apex 中直接调用。SOSL 返回的类型永远是一个包含了 sObject 对象列表的列表，即 List<List> 类型。

比如，对于所有 Account 和 Contact 对象，查询任一字段中包含 “test” 的记录：

List<List<SObject>> resultList = [FIND 'test'
                                  IN ALL FIELDS
                                  RETURNING Account(Name), Contact(FirstName, LastName)];

返回的结果便是符合条件的两个列表，一个列表包含 Account 对象，其中只有 Name 的值，另一个列表包含 Contact 对象，其中只有 FirstName 和 LastName 的值。

SOSL语法

SOSL 的基本语法是：

FIND 要查询的字符串 IN 要查找的字段 RETURNING 查询结果包含的对象和字段名

其中：

• 要查询的字符串是无关大小写的
• 要查找的字段是可选参数，默认是所有字段，即 “ALL FIELDS”，也可以在此声明只在某几个字段中查询，可以使用的仅限于：“NAME FIELDS”、“EMAIL FIELDS”、“PHONE FIELDS”、“SIDEBAR FIELDS”
• 查询结果包含的对象和字段名可以包含一个或多个想要查询的对象，并声明哪些字段保存在查询结果中