• 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”
    • 查询结果包含的对象和字段名可以包含一个或多个想要查询的对象,并声明哪些字段保存在查询结果中
  • 相关阅读:
    LeetCode(Weekly Contest 187)题解
    2021 暑期实习招聘思之未雨绸缪
    LeetCode(Weekly Contest 185)题解
    构建私有的 docker registry
    LeetCode(Weekly Contest 182)题解
    Win10图标变白
    远程连接linux上的mysql
    IDEA复制粘贴html文件打不进war包问题
    Git命令
    数据源收集
  • 原文地址:https://www.cnblogs.com/chengcheng0148/p/salesforce_database_query_introduction.html
Copyright © 2020-2023  润新知