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<SObject>> 类型。

比如,对于所有 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”
  • 查询结果包含的对象和字段名可以包含一个或多个想要查询的对象,并声明哪些字段保存在查询结果中
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,271评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,275评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,151评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,550评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,553评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,559评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,924评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,580评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,826评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,363评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,940评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2 342

推荐阅读更多精彩内容