浏览示例应用程序并发现缓存诊断

学习目标

完成本单元后,您将能够:

  • 解释用于存储和刷新缓存数据的模式。
  • 确定用于缓存值的数据结构。
  • 诊断您的缓存使用情况。

示例应用程序演练

让我们看一个示例应用程序,该应用程序演示如何使用组织缓存来存储和检索货币汇率。汇率在一天内波动,因此该示例应用程序不会返回实时汇率。该应用程序只提供汇率的每日快照。因为我们对准确的实时价值不感兴趣,而只对日常价值感兴趣,因此缓存货币汇率是一个不错的选择。当重复检索汇率时,从缓存中获取汇率会节省大量时间并提高应用程序的性能。

示例应用程序概述

我们将我们的汇率样本申请基于Visualforce页面和Apex控制器,该控制器包含获取汇率的逻辑。第一次访问此页面时,速率是通过对外部Web服务的API调用获得的。只要费率低于一天,此页面的后续执行将从缓存中返回费率。对于每种汇率,此页面显示基础货币,转换的目标货币和转换率。出于说明目的,返回一小组货币。

Visualforce页面显示货币汇率

此示例是Visualforce页面的标记。此页面与ExchangeRates Apex控制器。

<apex:page controller="ExchangeRates" action="{!init}">
    
   <apex:pageBlock title="Rates">
      <apex:pageBlockTable value="{!Rates}" var="rate">
         <apex:column value="{!rate.Base_Currency__c}"/>
         <apex:column value="{!rate.To_Currency__c}"/>
         <apex:column value="{!rate.Rate__c }"/>
      </apex:pageBlockTable>
   </apex:pageBlock>
   
</apex:page>

样品Apex控制器

我们的样品Apex控制器可以完成繁重的工作。它获取汇率,将它们存储在Salesforce和缓存中,并从缓存中检索汇率。以下是样本控制器执行的操作细分,后跟源代码。

第一次运行样本时,会发生以下操作。

  • 汇率是从对外部端点的API调用获得的。
  • 从API调用返回的结果(以JSON格式)将被解析并保存在Salesforce中的Exchange_Rate__c sObjects中。
  • 该 getCachedRates() method将Exchange_Rate__c sObjects数组存储在org缓存中。

在随后的样本执行中:

  • 该示例检查存储数据的新鲜程度。为此,它执行SOQL查询以获取第一个返回的Exchange_Rate__c记录的createdDate值。
  • 如果日期早于一天,则从API调用获得汇率,与第一次执行时一样。
  • 如果日期早于一天,则费率将从组织缓存中获取。如果存在高速缓存未命中,则从Exchange_Rate__c sObject查询速率并将其存储在组织高速缓存中。
注意

注意

Apex控制器使用一个名为的辅助Apex类 RateLib,这里没有显示。此帮助程序类包含用于对传输速率服务进行传出API调用,从API调用解析JSON结果以及存储Exchange_Rate__c记录的方法。

public class ExchangeRates {
    private String currencies = 'EUR,GBP,CAD,PLN,INR,AUD,SGD,CHF,MYR,JPY,CNY';
    public String getCurrencies() { return currencies;}
    public Exchange_Rate__c[] rates {get; set;}
    //                                                                          
    // Checks if the data is old and gets new data from an external web service 
    // through a callout. Calls getCachedRates() to manage the cache.           
    // 
    public void init() {
        // Let's query the latest data from Salesforce
        Exchange_Rate__c[] latestRecords = ([SELECT CreatedDate FROM Exchange_Rate__c 
                        WHERE Base_Currency__c =:RateLib.baseCurrencies 
                              AND forList__c = true 
                        ORDER BY CreatedDate DESC
                        LIMIT 1]);
        
        // If what we have in Salesforce is old, get fresh data from the API
        if ( latestRecords == null  
            || latestRecords.size() == 0 
            || latestRecords[0].CreatedDate.date() < Datetime.now().date()) {
            // Do API request and parse value out
            String tempString = RateLib.getLoadRate(currencies);
            Map<String, String> apiStrings = RateLib.getParseValues(
                tempString, currencies);
            
            // Let's store the data in Salesforce
            RateLib.saveRates(apiStrings);
            // Remove the cache key so it gets refreshed in getCachedRates()
            Cache.Org.remove('Rates');
        }
        // Call method to manage the cache
        rates = getCachedRates();
    }
    //                                                                          
    // Main method for managing the org cache.                                  
    // - Returns exchange rates (Rates key) from the org cache.                 
    // - Checks for a cache miss.                                               
    // - If there is a cache miss, returns exchange rates from Salesforce       
    //    through a SOQL query, and updates the cached value.                   
    //
    public Exchange_Rate__c[] getCachedRates() {
        // Get the cached value for key named Rates
        Exchange_Rate__c[] rates = (Exchange_Rate__c[])Cache.Org.get(
            RateLib.cacheName+'Rates');
        
        // Is it a cache miss? 
        if(rates == null) {
            // There was a cache miss so get the data via SOQL
            rates = [SELECT Id, Base_Currency__c, To_Currency__c, Rate__c 
                        FROM Exchange_Rate__c 
                        WHERE Base_Currency__c =:RateLib.baseCurrencies 
                              AND forList__c = true
                              AND CreatedDate = TODAY];
            // Reload the cache
            Cache.Org.put(RateLib.cacheName+'Rates', rates);
        }
        return rates;
    }
}

要下载Exchange Rate示例的来源并在Developer org中使用它,请参阅参考资料部分。

缓存管理的最佳实践

缓存存储的模式

该 ExchangeRatesApex类包含封装初始化和刷新缓存的逻辑的方法。如果数据陈旧或未找到,则在里面()method通过API调用检索新的汇率,然后将它们存储在Salesforce中。该getCachedRates()方法在内部管理缓存。如果未找到缓存值,则此方法从Salesforce检索一组速率并将其存储在缓存中。

由于我们的应用程序使用外部数据,因此它通过API调用从Web服务获取数据。它还将数据存储为Salesforce记录,作为刷新缓存的备份。不使用外部数据的应用程序使用SOQL检索Salesforce记录并对其进行缓存。在这种情况下,缓存管理过程更简单,缓存方法实现更短。例如,如果您的应用只使用SOQL中的本地数据,则不需要在里面() 方法,但只有 getCachedRates() 方法。

我们建议您在一种方法中包含用于管理缓存的所有逻辑。这样,缓存仅在应用程序的一个位置进行操作。高速缓存的集中管理减少了访问无效高速缓存(高速缓存未命中)或意外覆盖高速缓存值的错误的可能性。

决定缓存什么

此示例将一个sObjects数组存储在缓存中。这种方法是存储数据结构的最佳选择吗?你做出的每一个选择都有权衡。存储较小的数据片段(如字段值而不是整个sObject)可以减少缓存使用量。但是,如果在每个键中存储的数据较少,则可能需要复杂的逻辑来重建数据和sObject,这需要更多的处理时间。并且存储在一个键中的sObject数组使用的缓存空间少于存储在各个键中的各个sObject的总大小。由于序列化和缓存提交时间的开销,缓存较小的项而不是项列表会降低缓存性能。例如,

Cache.Org.put('Rates', rates);

您可以将各个费率存储为具有自己的缓存键的字段,如下所示。

Cache.Org.put('DollarToEuroRate', rateEUR);
Cache.Org.put('DollarToChineseYuan', rateCNY);
Cache.Org.put('DollarToJapaneseYen', rateJPY);
// etc.

决定缓存哪种数据结构取决于您的应用程序对数据的处理方式。例如,如果应用程序转换相同基础货币的货币,则至少存储每种目标货币的汇率。您可以将每种货币汇率存储为单个键。但是为了更容易在Visualforce页面上显示费率,请将数据缓存为sObject列表。sObjects可以增加存储空间,因为它们包含系统字段,例如创建的日期,但它们减少了逻辑处理时间并提高了应用程序和缓存性能。请记住,在使用缓存时,主要目标是减少应用程序的执行时间。

诊断缓存使用情况

所以,你已经完成了所有这些工作来实现Platform Cache。你怎么知道你是否正在充分利用缓存?有几种方法可以检查性能数据。一种方法是在Setup中查看诊断信息(仅在Salesforce Classic中可用)。

在访问诊断页面之前,请为您的用户启用缓存诊断权限。

  1. 从“设置”中,输入users“ 快速查找”框,然后选择“ 用户”
  2. 单击您的用户名,然后单击“ 编辑”
  3. 选择“ 缓存诊断”,然后单击“ 保存”

接下来,访问分区中特定缓存类型的诊断页面。

  1. 从“设置”中,输入cache“ 快速查找”框,然后选择“ 平台缓存”
  2. 单击要检查其诊断信息的分区。
  3. 在会话缓存或组织缓存下,单击“ 诊断”

如果单击“组织缓存”的“ 诊断”,则会在新选项卡中打开“组织缓存诊断”页面。此页面显示两个图表。第一个图表(组织缓存容量和使用情况)显示您的缓存使用限制。在我们的例子中,我们低于极限0.02%。第二个图表(按内容贡献)是一个圆环图,按键显示缓存分布。

注意

注意

因为我们的示例使用org缓存,所以我们只检查诊断页面中的org缓存。还为使用会话高速缓存的应用程序的会话高速缓存提供了类似的诊断页面。

下图显示了包含四个缓存键的内容分发图表。其中一个缓存键Rate用于我们的汇率样本。该 价格键更采用了比空间的一半。

组织缓存的诊断页面

在图表之后,列出了缓存键的详细信息。此列表提供与密钥对应的每个缓存值的大小以及访问缓存的次数。您可以从此列表中手动删除缓存,作为调用该缓存的替代方法去掉()Apex中的方法。“ 删除”按钮允许管理员在不修改任何代码的情况下管理缓存。

该DollarToEuroRate键使用比少得多的空间 价格的关键。这是可以预料的,因为 DollarToEuroRate只存储一个值,而 Rates存储一组sObjects。

使用诊断页面上的信息确定是否调整缓存使用情况。例如,如果缓存值具有较低的访问计数,表明它很少使用,请考虑它是否真的需要,特别是如果它很大。或者,如果您接近缓存使用限制,请重新考虑缓存内容。您可能希望删除不必要的缓存值或购买更多缓存容量。

恭喜!您已经学习了如何使用Platform Cache来缓存应用程序的数据以便快速检索。您还了解了缓存最佳实践以及如何诊断缓存使用情况。您现在已准备好加入花栗鼠的冒险并缓存宝贵的资源!

使用组织和会话缓存

学习目标

完成本单元后,您将能够:

  • 创建一个分区。
  • 在组织和会话缓存中存储和检索值。
  • 描述缓存中的值的持续时间。
  • 处理缓存未命中。
  • 从Visualforce页面读取会话缓存。

创建分区

注意

注意

还没有缓存试用版吗?此单元需要有效的Platform Cache试用版。使用上一个单元中的说明申请试用。如果您没有缓存试用版,则仍可以执行本机中的步骤,但不会在缓存中找到您的数据。

要使用Platform Cache,首先要设置至少一个分区。设置分区后,您可以使用Platform Cache Apex API添加,访问和删除数据。

每个分区都有一个会话缓存和一个组织缓存段。您可以为每个段分配单独的容量。通常,您为分区分配至少5 MB。对于此示例,我们不分配任何空间以确保您的代码正确处理缓存未命中。当没有分配空间时,缓存未命中率为100%,这意味着在缓存中找不到缓存值,并且得到() 方法返回 空值。考虑使用此技术来测试缓存未命中。我们将在后面的部分介绍如何处理缓存未命中。

首先,让我们从Platform Cache页面创建一个分区(仅在Salesforce Classic中可用)。

  1. 在“设置”中,输入Platform Cache“ 快速查找”框,然后选择“ 平台缓存”
  2. 单击“ 新建平台缓存分区”
  3. 为分区指定名称(例如应用程序的名称)。
  4. 检查默认分区
  5. 输入0会话缓存和0组织缓存,然后单击“ 保存”

缓存密钥名称格式

每个缓存键具有以下格式:

Namespace.Partition.Key

名称空间是运行应用程序的组织的名称空间名称,也可以设置为特殊名称“local”。“本地”名称是指组织的名称空间是否在组织中定义了名称空间。

分区是您创建的分区的名称。在此示例中,它是CurrencyCache。

Key是用于存储值的键的名称。键名唯一地表示您的缓存值。

假设我们想将货币汇率从美元存储到欧元。我们可以创建一个名为DollarToEuroRate的密钥。对于我们刚刚创建的分区,密钥的全名是:

local.CurrencyCache.DollarToEuroRate

例如,此代码段存储了DollarToEuroRate键的组织缓存中的值。

Cache.Org.put('local.CurrencyCache.DollarToEuroRate', '0.91');

我们创建的分区是默认分区,因此您可以省略命名空间和分区名称,只需指定密钥名称即可。

DollarToEuroRate

使用默认分区时,可以将put()调用缩短为以下内容。

Cache.Org.put('DollarToEuroRate', '0.91');

在组织缓存中存储和检索数据

您已完成设置分区,这是您在用户界面中执行的唯一步骤。现在我们将切换到Apex来管理缓存。使用组织缓存来存储组织中任何人都可以使用的数据。要么使用Cache.Org 类方法,或使用 Cache.OrgPartition用于引用特定分区的类。然后调用该分区上的缓存方法。

以下Apex代码段显示了如何使用。访问分区 Cache.OrgPartition用于存储和检索货币兑换应用程序的缓存值的类。它在本地名称空间中获取名为CurrencyCache的分区。使用关键的DollarToEuroRate和今天的货币汇率添加新值 。接下来,从缓存中检索关键DollarToEuroRate的值。

// Get partition
Cache.OrgPartition orgPart = Cache.Org.getPartition('local.CurrencyCache');
// Add cache value to the partition. Usually, the value is obtained from a 
// callout, but hardcoding it in this example for simplicity.
orgPart.put('DollarToEuroRate', '0.91');
// Retrieve cache value from the partition
String cachedRate = (String)orgPart.get('DollarToEuroRate');

如果您只在一个分区中管理缓存值,请使用 Cache.OrgPartition方法。该Cache.OrgPartition 方法比使用起来更容易 Cache.Org 方法,因为在创建分区对象时只指定了一次命名空间和分区前缀。

缓存价值最后一次?

前面的例子假设一切正常,即:

  • 平台缓存已启用,并具有可用空间的分区
  • 缓存中的缓存值
  • 该值已成功存储在缓存中

但在现实生活中,缓存数据并不总能得到保证。平台缓存旨在作为临时空间。例如,缓存可能已过期。即使缓存仍处于活动状态,您的缓存数据也可能会从缓存中逐出。就像花栗鼠清理他们的脸颊以腾出更多橡子的空间一样,Platform Cache也可以清除一些空间以获得更多数据!超出分区限制时,Salesforce会根据最近最少使用(LRU)算法驱逐缓存数据。高速缓存逐出直到使用减少到小于或等于100%容量。此外,如果超出本地缓存限制,则可以在提交请求之前从本地缓存中逐出项目。

缓存数据持续时间和到期时间

数据保存在缓存中的时间称为生存时间值(ttlsecs)。使用Apex方法在缓存中存储键值对时,可以指定生存时间值。对于会话缓存,您的数据最多可在缓存中保存8小时。对于组织缓存,您的数据最多可在缓存中运行48小时。默认情况下,组织缓存的生存时间值为24小时。

会话缓存在达到其指定的生存时间值或用户会话到期时(以先到者为准)到期。组织缓存在达到其指定的生存时间值时到期。

处理缓存未命中的最佳实践

作为最佳实践,您的代码应该预见并容纳故障点。换句话说,始终假设可能发生缓存未命中。缓存未命中是指从缓存中请求密钥值但未找到值的情况。你的价值 得到()call returns为null。检查结果得到()调用null并相应地处理它。例如,如果结果是空值,从数据库或API调用中获取值。

以下Apex代码段显示了如何通过检查缓存中返回的值是否来处理缓存未命中 空值 (if(cachedRate!= null))。如果值不是空值,您可以使用该值,例如,在页面上显示它。否则,从其他源(例如API调用或Salesforce)获取此值。

Cache.OrgPartition orgPart = Cache.Org.getPartition('local.CurrencyCache');
String cachedRate = (String)orgPart.get('DollarToEuroRate');
// Check the cache value that the get() call returned.
if (cachedRate != null) {
    // Display this exchange rate   
} else {
    // We have a cache miss, so fetch the value from the source.
    // Call an API to get the exchange rate.
}

在会话缓存中存储和检索数据

还记得什么会话缓存吗?没错,它存储与各个用户会话相关的数据。例如,您可以在应用程序中使用会话缓存来存储用户喜欢的货币或用户的自定义导航选项卡顺序。使用会话缓存,您可以使用Visualforce全局变量管理Apex中的缓存值并读取缓存值。

使用Apex时,管理会话缓存与管理组织缓存的方式类似,但类名不同。使用Cache.Session 和 Cache.SessionPartition用于访问存储在会话高速缓存中的值的类。要管理任何分区中的值,请使用中的方法Cache.Session 类。如果您只在一个分区中管理缓存值,请使用Cache.SessionPartition方法而不是。该Cache.SessionPartition 方法比使用起来更容易 Cache.Session 方法,因为在创建分区对象时只指定了一次命名空间和分区前缀。

以下的Apex代码片段显示了如何访问分区以存储和检索缓存值。它在本地名称空间中获取名为CurrencyCache的分区。使用关键的FavoriteCurrency添加新值。检索FavoriteCurrency密钥的值 。该 FavoriteCurrency密钥存储用户的喜爱货币,所以这个值是为每个用户,因此一个很好的候选人会话缓存不同。

// Get partition
Cache.SessionPartition sessionPart = Cache.Session.getPartition('local.CurrencyCache');
// Add cache value to the partition
sessionPart.put('FavoriteCurrency', 'JPY');
// Retrieve cache value from the partition
String cachedRate = (String)sessionPart.get('FavoriteCurrency');

使用Visualforce全局变量访问平台缓存

通过使用,从Visualforce页面访问存储在平台缓存中的缓存值 $ Cache.Session 要么 $ Cache.Org全局变量。通过使用这些全局变量,您可以直接从Visualforce页面读取与Apex一起存储的缓存值。

注意

注意

以下示例显示如何使用。访问会话高速缓存 $ Cache.Session全局变量。除了使用之外,等效的org缓存示例是相同的$ Cache.Org 而是全局变量。

使用时 $ Cache.Session全局变量,使用命名空间和分区名称完全限定密钥名称。此示例是一个输出文本组件,用于从命名空间中检索缓存的值艾博, 划分 CurrencyCache和关键 FavoriteCurrencyRate。

<apex:outputText value="{!$Cache.Session.ExPro.CurrencyCache.FavoriteCurrencyRate}"/>

与Apex方法不同,您不能省略 namespace.partition前缀以引用组织中的默认分区。如果没有为组织定义名称空间,请使用本地 引用运行代码的当前组织的命名空间。

<apex:outputText value="{!$Cache.Session.local.MyPartition.Key}"/>

如果缓存的值是具有属性或方法的数据结构,如Apex List或自定义类,则访问这些属性 $ Cache.Session表达式使用点表示法。例如,此标记调用则为list.size() 如果是Apex方法的值 numbersList 被声明为List。

<apex:outputText value="{!$Cache.Session.local.MyPartition.numbersList.size}"/>

此示例访问on上的value属性 MYDATA的 声明为自定义类的缓存值。

<apex:outputText value="{!$Cache.Session.local.MyPartition.myData.value}"/>

ISV应用程序的受保护缓存分配

通过使用平台缓存,ISV应用程序运行速度更快,性能更佳。如果您是ISV开发人员,则可以通过为自己的命名空间购买缓存空间来保证应用程序的缓存空间。这样,当您的应用安装在订阅者组织中时,应用缓存的空间不会受到订阅者组织中缓存使用的影响。只有从应用程序命名空间运行的Apex代码才能访问和使用命名空间的缓存。订阅者组织中没有其他代码可以使用此缓存。您可以根据命名空间的缓存测试您的应用程序,并确保缓存分配将在每个订阅者组织中受到保护。

缓存分区作为应用程序包的一部分分发给订阅者。将命名空间的一个或多个缓存分区作为组件添加到包中,方法与添加其他组件相同。缓存分区不会自动添加为依赖组件。

包含缓存分区的包组件列表
注意

注意

请参阅以下有关打包分区的信息

  • 您添加到程序包的分区必须是非默认分区。
  • 当订户安装您的软件包时,缓存分区将安装在其组织中,使您的应用程序可以访问您的命名空间的已安装缓存分区。
  • 订阅者必须拥有Enterprise Edition或Unlimited Edition组织,或者必须购买Platform Cache。

下图显示了使用打包缓存安装软件包的Enterprise Edition订户组织的示例缓存容量。订户的总缓存容量为30 MB,分为三个分区,包括会话和组织缓存的组合。打包的缓存容量来自订户组织中已安装的包,并包含两个分区。打包的缓存由ISV购买的20 MB缓存组成。(请记住,只有包中的Apex代码才能访问打包的缓存,订阅者组织中的代码无法使用此缓存。)

打包分区和组织分区的缓存容量是分开的

从Channel Order App购买命名空间缓存。您可以购买10 MB块的缓存。要确定应用程序需要多少缓存空间,请使用缓存分区测试应用程序。使用试用缓存来增加组织中缓存的容量。正如我们在第一个单元中提到的,默认情况下,某些版本的订户组织会获得缓存分配。对于开发应用程序的Developer Edition组织,您可以请求10 MB的试用缓存。您可以通过联系Salesforce请求增加为您的组织提供的试用缓存数量。通过尝试不同的缓存大小,您可以更好地了解为自己的命名空间购买多少缓存。

现在您已经了解了如何在Platform Cache中获取和存储值,请自行尝试!完成以下挑战以测试您的知识。

开始使用Platform Cache

学习目标

完成本单元后,您将能够:

  • 描述什么是平台缓存以及它的用途。
  • 列出两种类型的平台缓存并给出每种缓存的示例。
  • 描述分区以及如何使用它们。

什么是缓存?

缓存是临时存储。在计算机世界中,缓存是来自数据库的频繁访问数据的临时存储。这是一个类比。假设你是一只寻找坚果和橡子的花栗鼠。现在是5点,你准备好吃了。你打算使用存放在你脸颊上的坚果和橡子(缓存),还是你要回到森林里从树上收集更多(数据库)?如果您在脸颊上访问食物的临时缓存,您的晚餐会更接近,您可以更快地吃到它!此外,您可以更有效地实现目标。数据缓存具有类似的优点,但对于人而言,不是花栗鼠。

一种花栗鼠,脸颊上有坚果

什么是平台缓存?

Platform Cache是​​一个存储层,用于存储Salesforce会话和组织数据以供以后访问。使用Platform Cache时,您的应用程序可以更快地运行,因为它们将可重用数据存储在内存中。应用程序可以快速访问此数据; 他们不需要在后续事务中复制计算和对数据库的请求。简而言之,将Platform Cache视为云应用程序的RAM。

使用Platform Cache,您还可以分配缓存空间,以便某些应用程序或操作不会窃取其他人的容量。您使用分区来分配空间。我们稍后会进入分区。

在我们继续前进之前

让我们暂停一下,请求试用平台缓存。默认情况下,您的Developer org具有0 MB缓存容量。您可以请求10 MB的试用缓存。

要申请试用,请转到开发人员组织中的“设置”。在“ 快速查找”框中,输入cache,然后单击“ 平台缓存”。单击“ 请求试用容量”并等待电子邮件通知您平台缓存试用版处于活动状态。Salesforce立即批准试用请求,但您可能需要几分钟才能收到电子邮件。

请求“平台缓存”页面上的“试用容量”按钮

如果您没有缓存试用版,则仍可以执行缓存操作以了解如何使用缓存。但是,会绕过缓存存储,并且检索的值为空(缓存未命中)。

好的,既然您已经请求了Platform Cache试用版,那么让我们学习更多概念。

我什么时候可以使用平台缓存?

您可以在代码中使用平台缓存,几乎可以在任何地方反复访问相同的数据。使用缓存数据可以提高应用程序的性能,并且比重复执行SOQL查询,进行多个API调用或计算复杂计算更快。

要缓存的最佳数据是:

  • 在整个会话中重用,或在所有用户和请求中重用
  • 静态(不会快速变化)
  • 计算或检索费用昂贵

存储不经常更改的数据

使用缓存来存储不经常更改的静态数据或数据。该数据最初通过来自第三方的API调用或通过SOQL查询在本地检索。如果数据发生更改,请在不必始终高度准确的情况下缓存此数据。

此类静态数据的示例如下:

  • 公共交通时刻表
  • 公司班车时刻表
  • 所有用户都看到的标题页眉
  • 显示在应用的每个页面上的静态导航栏
  • 您希望在会话期间保留的用户购物车
  • 每日汇率快照(汇率在一天内波动)

存储从复杂计算中获得的数据

由复杂计算或长查询产生的值是缓存存储的良好候选者。此类数据的示例如下:

  • 过去一周的总销售额
  • 公司员工整体志愿服务时间总计
  • 最畅销的排名

有关使用Platform Cache的位置的线索,请检查您的代码。例如,您当前是否通过重载Visualforce视图状态来存储应用程序数据?这些存储的值都是Platform Cache的候选者。

并非每个用例都是Platform Cache用例。例如,经常更改且实时更改的数据(例如股票报价)不适合缓存。此外,请确保您熟悉Platform Cache限制。例如,如果您的数据由异步Apex访问,则无法将其存储在基于用户会话的缓存中。

按版本缓存分配

具有Enterprise Edition orgs及更高版本的客户可以使用Platform Cache。以下版本带有一些默认缓存空间,但通常情况下,添加更多缓存可提供更高的性能增强。

  • 企业版(默认为10 MB)
  • 无限版(默认为30 MB)
  • 性能版(默认为30 MB)

试用试用缓存

您可以为您的组织购买额外的缓存。要确定多少额外缓存对您的应用程序有益,您可以请求试用缓存并进行试用。此外,在购买缓存之前请求专业版的试用缓存。在Developer Edition组织中使用试用缓存来使用Platform Cache开发和测试您的应用程序。当您的请求获得批准后,您将获得30 MB的试用缓存空间(Developer Edition为10 MB)。如果您需要更多试用缓存空间,请联系Salesforce。

平台缓存的类型是什么?

平台缓存有两种类型:组织缓存和会话缓存。

组织缓存

组织缓存存储组织中任何人都可以使用的组织范围数据。可以跨会话,请求和组织用户和配置文件访问组织缓存。

例如,可以根据联系人的位置为联系人缓存和显示天气数据。或者可以缓存货币汇率的每日快照以便在应用中使用。

会话缓存

会话缓存存储单个用户的数据,并与该用户的会话相关联。会话的最长寿命为8小时。

例如,假设您的应用计算用户位置与用户希望在同一天访问的所有客户之间的距离。位置和计算的距离可以存储在会话高速缓存中。这样,如果用户想要再次获得该信息,则不需要重新计算距离。或者,您可能拥有一个应用程序,使用户可以自定义导航标签顺序,并在访问应用程序中的其他页面时重复使用该顺序。

使用缓存时性能提升了多少?

您可能想知道使用Platform Cache可以提高应用程序的性能。从缓存中检索数据比通过API调用快得多。将SOQL与缓存检索时间进行比较时,缓存也比SOQL查询快得多。

下图显示了通过API调用和缓存的数据检索时间(以毫秒为单位)。在通过缓存本地获取数据时,很容易注意到巨大的性能提升,尤其是在多个事务中检索数据时。在用于图表的示例中,缓存比API调用快数百倍。在此图中,缓存检索时间仅为几毫秒,但由于用于时间值的比例,因此几乎为零。请注意,此图表是一个示例测试,其他应用的实际数字可能会有所不同。对外部服务进行API调用比从缓存中获取数据(2)更慢(1)。

Graph将API调用的处理时间与缓存进行比较

下一个图表将SOQL与组织和会话缓存检索时间进行比较。如您所见,SOQL比缓存慢。在此示例中,缓存比SOQL快两倍或更多倍,以便在单个事务中进行数据检索。在多个事务中执行检索时,差异甚至更大。(请注意,此图表是一个示例,其他应用的实际数字可能会有所不同。)通过SOQL查询获取数据(1)比从组织和会话缓存中获取数据要慢(2)。

Graph将SOQL查询的处理时间与缓存进行比较

什么是缓存分区?

还记得我们之前提到过使用Platform Cache你可以使用分区分配空间吗?我们现在谈谈分区。分区允许您分配缓存空间以平衡跨应用程序的使用情况和性能。将数据缓存到指定的分区可确保缓存空间不会被其他应用程序或不太重要的数据覆盖。

在组织中使用缓存空间之前,必须创建分区以定义应用程序的容量。每个分区容量在组织缓存和会话缓存之间分解。会话和组织缓存分配可以是零,5 MB或更大,并且必须是整数。分区的最小大小(包括其组织和会话高速缓存分配)为5 MB。例如,假设您的组织总共有10 MB的缓存空间,并且您创建了一个总共5 MB的分区,其中5 MB用于会话缓存,0 MB用于org缓存。或者,您可以创建10 MB空间的分区,其中5 MB用于组织高速缓存,5 MB用于会话高速缓存。所有分区的总和(包括默认分区)等于Platform Cache总分配。

下图显示了缓存容量和分区分配的图表。在这个例子中,我们还没有使用缓存,正如0%缓存使用情况(1)所证明的那样,并且已经使用相等的分配创建了两个分区(2)。

缓存容量图表

默认分区

您可以将任何分区定义为默认分区,但只能有一个默认分区。默认分区使您可以使用简写语法在该分区上执行缓存操作。这意味着在添加键值对时,您不必使用命名空间和分区名称完全限定键名。例如,而不是呼叫Cache.Org.put(’namespace.partition.key’,0); 你可以打电话 Cache.Org.put(’key’,0);

在下一个单元中,您将在安装程序中创建一个分区,以便开始使用Platform Cache!

Big Objects-查询

学习目标

完成本单元后,您将能够:

  • 使用标准SOQL查询大对象。
  • 使用Async SOQL查询大对象。
  • 列出使用Async SOQL而非标准SOQL的优缺点。

SOQL和异步SOQL

可以使用SOQL或Async SOQL查询大对象。异步SOQL使用SOQL命令的子集。它是从头开始设计的,用于处理可以保存在大对象中的大量数据。由于异步SOQL查询是异步运行的,因此您不必担心查询超时。异步SOQL查询在后台运行,可以在Salesforce实体数据,标准对象,自定义对象和大对象上运行。异步SOQL通过Chatter REST API实现。

通常,当您处理大量数据时,您希望使用Async SOQL而不是标准SOQL。如果您只需要来自大对象的小数据集,或者如果您需要立即获得结果,请使用标准SOQL。异步SOQL也适用于标准和非大型自定义对象,但对这些对象的支持处于试用阶段。

请记住,虽然每个许可证都包含自定义大对象,但Async SOQL仅包含额外大对象容量的许可。在以下时间使用标准SOQL:

  • 您希望在UI中显示结果,而无需用户等待结果。
  • 您希望立即返回结果以便在Apex代码块中进行操作。
  • 您知道查询将返回少量数据。

在以下情况下使用Async SOQL:

  • 您正在查询数百万条记录。
  • 您希望确保查询完成。
  • 您不需要在索引之外进行聚合查询或过滤。
异步SOQL用例。

简而言之,Async SOQL允许您在大对象中获取数百万条记录,并将相关数据提取到可管理的工作数据集中。

如何使用SOQL查询大对象

如果您已经熟悉使用SOQL,那么您会感到宾至如归。使用标准SOQL时需要注意的事项与使用SOQL和非大对象的大对象不同。对于具有大对象的SOQL查询,您必须从索引中定义的第一个字段开始构建查询,而不跳过查询中第一个和最后一个字段之间的任何字段。因此,例如,如果索引定义了三个字段,则无法仅使用第一个和第三个字段创建查询。

您可以使用这些比较运算符 =, <, >, <=, > =, 要么 在在查询的最后一个字段上。查询中的任何先前字段只能使用=运营商。该!=, 喜欢, 不在, 排除,和 INCLUDES 运算符在涉及大对象的任何查询中都无效。

以下查询假定您有一个大对象,其中索引由其定义 Account__c, Game_Platform__c,和 Play_Date__c。此查询指定索引中的所有三个字段。在这种情况下,过滤器Play_Date__c 可以是一个范围。

SELECT Account__c, Game_Platform__c, Play_Date__c
FROM Customer_Interaction__b
WHERE Account__c='001R000000302D3' AND Game_Platform__c='PC' AND Play_Date__c=2017-09-06T00:00:00Z

查询不起作用,因为查询中的间隙在哪里 Game_Platform__c 应该。

SELECT Account__c, Game_Platform__c, Play_Date__c
FROM Customer_Interaction__b
WHERE Account__c='001R000000302D3' AND Play_Date__c=2017-09-06T00:00:00Z

如何使用异步SOQL查询大对象

有两种主要方法可以使用Async SOQL从大对象中获取可管理的数据集。首先是使用过滤。您可以使用过滤将大对象数据的一小部分提取到自定义对象中。然后,您可以在报告,仪表板或其他漂亮的分析工具中使用它。

创建可管理数据集的另一种方法是通过粗略聚合。这些是Async SOQL支持的聚合函数:AVG( field ), COUNT( field ), COUNT_DISTINCT( field ), SUM( field ), MIN( field ), MAX( field )。这些聚合函数可以更好地控制从大对象中提取的数据。

形成您的查询

使用Async SOQL,我们查询自定义大对象 Customer_Interaction__b,并将结果指向我们的目标对象 TargetObject__c。我们将特定日期的客户和游戏内购买信息从我们的自定义大对象提取到目标对象,然后我们可以将其用于报告和分析。必填字段

名称类型描述
询问字符串指定要执行的SOQL查询的参数。
targetObject字符串要插入查询结果的标准对象,自定义对象,外部对象或大对象。
targetFieldMapMap <String,String>定义如何将查询结果中的字段映射到目标对象中的字段。定义时 targetFieldMap 参数,确保字段类型映射是一致的。如果源字段和目标字段不匹配,则适用这些注意事项。任何源字段都可以映射到目标文本字段。如果源和目标字段都是数字,则目标字段必须具有与源字段相同或更多的小数位数。如果不是,则请求失败。此行为是为了确保转换中不会丢失任何数据。如果查询结果中的字段被多次映射,即使映射到目标对象中的不同字段,也只使用最后一个映射。

示例URI

https://yourInstance.salesforce.com/services/data/v41.0/async-queries/

POST请求正文

{ 
   "query": "SELECT Account__c, In_Game_Purchase__c FROM Customer_Interaction__b WHERE Play_Date__c=2017-09-06T00:00:00Z",
   
   "operation": "insert",
   
   "targetObject": "Customer_Interaction_Analysis__c", 
        
   "targetFieldMap": {"Account__c":"Account__c",
                      "In_Game_Purchase__c":"Purchase__c"
                      },
   "targetValueMap": {"$JOB_ID":"BackgroundOperationLookup__c",
                      "Copy fields from source to target":"BackgroundOperationDescription__c"
                     }
}

在此查询中,我们从特定日期2017-09-06获取客户交互大对象的客户和游戏内购买信息,并将该数据发送到我们创建的自定义对象中, Customer_Interaction_Analysis__c。因为我们使用的是Async SOQL而不是标准的SOQL,所以我们可以过滤而不必担心包含其他索引字段。此新自定义对象将填充该日期的所有客户和游戏内购买信息。从那里我们可以开始做一些分析,并试图找出为什么我们的游戏是如此惊人的成功。

POST响应机构响应正文包括查询 的jobId,查询的状态以及任何相关消息。

{ 
   "jobId": "08PD000000003kiT", 
   
   "message": "",
    
   "query": "SELECT Account__c, In_Game_Purchase__c FROM Customer_Interaction__b WHERE Play_Date__c=2017-09-06T00:00:00Z",  
    
   "status": "New",
     
   "targetObject": "Customer_Interaction_Analysis__c", 
     
   "targetFieldMap": {"Account__c":"Account__c", 
                      "In_Game_Purchase__c":"Purchase__c"
                     },
   "targetValueMap": {"$JOB_ID":"BackgroundOperationLookup__c",
                      "Copy fields from source to target":"BackgroundOperationDescription__c"
                     } 
}

跟踪您的查询状态

要跟踪查询的状态,请指定它 JOBID使用HTTP GET请求。查询的状态在。中返回状态领域。如果你没有指定JOBID,我们返回所有查询的状态。该状态 可:

  • 取消- 工作在被运行之前被取消了。
  • 成功- 工作顺利完成。
  • 失败 – 系统提交后作业失败,或者请求超出了Async SOQL限制。消息字段提供有关失败原因的详细信息。
  • 运行- 工作成功运行,组织未超出任何限制。
  • 计划- 新作业已创建并已安排,但尚未运行。

您也可以通过指定HTTP DELETE请求来取消查询 的jobId。取消已完成的查询无效。

请记住,异步SOQL是异步完成的。这意味着您的查询可能需要一段时间才能完成。就像我们之前提到的那样,如果时间紧迫,并且数据集足够小,请使用标准SOQL。或者,我们可以想象一下在这些例子中使用的不那么受欢迎的虚构游戏,但那里的乐趣在哪里呢?示例URI

https://yourInstance.salesforce.com/services/data/v41.0/async-queries/08PD000000003kiT

示例GET响应

{
"jobId": "08PD000000003kiT",
"message": "",
"query": "SELECT Account__c, In_Game_Purchase__c FROM Customer_Interaction__b WHERE Play_Date__c=2017-09-06T00:00:00Z",  
"status": "Success",
"targetObject": "Customer_Interaction_Analysis__c",
"targetFieldMap": {"Account__c":"Account__c",
"In_Game_Purchase__c":"Purchase__c" } 
}

此响应显示我们的查询已成功完成。哇噢!是时候准备报告和仪表板了!

处理错误

在执行Async SOQL查询期间可能会发生两种不同类型的错误。

  • 查询执行中的错误
  • 将结果写入目标大对象的一个​​或多个错误

提交无效查询并超出其中一个异步SOQL限制是执行问题的示例。另一个示例是查询导致底层基础结构出现问题。对于这些错误,响应正文包含状态 失败。message参数提供有关失败原因的更多信息。

其他时候,查询成功执行但在尝试将结果写入目标对象时遇到错误。由于涉及的数据量很大,捕获每个错误都是低效的。相反,生成的错误的子集被捕获 BackgroundOperationResult对象并保留七天。您可以使用Async SOQL查询来查询此对象的jobId过滤特定Async SOQL查询的错误。异步SOQL作业信息保留一年。

把它包起来

现在您了解在您自己的组织中使用自定义大对象所需的一切。哈哈,现在有数十亿条记录。

我们只是触及了Async SOQL的表面。请务必查看资源部分,以查看Async SOQL支持的所有标准SOQL命令以及更多用例示例。您还可以找到有关可在POST请求中使用的可选字段的信息。另请参阅我们的Analytics数据集成基础知识模块,了解如何为从大对象中提取的数据设置分析。想想您可以使用所有数据制作的所有漂亮的图形和仪表板!

Big Objects-定义自定义

学习目标

完成本单元后,您将能够:

  • 创建自定义Big Objects。
  • 构建自定义索引。
  • 部署自定义Big Objects。
  • 填充一个Big Objects。

定义自定义Big Objects

所以你已经查看了自定义Big Objects的用例,或者想出了自己的用例。现在是时候建立一个。

您可以在安装程序中定义自定义Big Objects。您还可以使用Metadata API定义自定义Big Objects,但在安装程序中更简单。要开始使用,请登录您的Trailhead Playground并转到安装程序。在较高的层次上,这就是你如何定义一个Big Objects。

  1. 单击并选择“ 设置”
  2. Big Objects在“快速查找”框中输入,然后选择“ Big Objects
  3. 创建一个Big Objects并添加一些基本细节。
  4. 添加自定义字段。它们将数据存储在您的Big Objects上。
  5. 添加索引。索引定义Big Objects的复合主键,用于查询和过滤Big Objects数据。
  6. 保存Big Objects并将状态更改为已部署。

现在让我们更详细地介绍这些步骤。

虽然自定义Big Objects与标准对象和自定义对象类似,但某些参数对于Big Objects是唯一的,并且某些参数不适用。对象名称在组织中的所有标准,自定义,外部和大型对象中必须是唯一的。

Big Objects定义细节

定义Big Objects时,首先要填写一些有关它的基本细节。

字段名称描述
标签此名称用于引用用户界面中的对象。
多个标签对象的复数名称。
从元音开始如果它适合您组织的默认语言,请指明标签前面是“an”还是“a”。
对象名称Big Objects的唯一API名称。在托管包中,此名称可防止与包安装发生命名冲突。仅使用字母数字字符和下划线。名称必须以字母开头且没有空格。它不能以下划线结尾,也不能有两个连续的下划线。保存后,Big Objects的API名称将使用后缀“__b”与自定义对象后缀“__c”进行标识。
描述有意义的描述可帮助您记住在列表中查看对象时之间的差异。
上下文相关的帮助设置定义用户从对象记录的主页(概述),编辑和详细信息页面,列表视图和相关列表中单击此页面的“帮助”时显示的URL 。此设置不会影响页面顶部的“帮助”链接。该链接始终打开“帮助”窗口。
部署状态创建Big Objects时,状态将设置为In Development。在包含至少包含一个自定义字段的索引之前,您无法部署Big Objects。索引中只允许使用必需的自定义字段。创建索引后,您会看到Deployed的第二个状态。准备好授予用户访问权限后,将状态更改为“已部署”。

Big Objects自定义字段

定义好Big Objects后,添加自定义字段。自定义字段存储Big Objects的唯一数据。您还可以创建自定义关系字段,以将您的Big Objects与Salesforce中的另一个对象相关联。将自定义字段添加到Big Objects的方式与向Salesforce中的任何对象添加自定义字段的方式相同。Big Objects支持以下字段类型:

  • 查找关系
  • 日期时间
  • 文本
  • 文字区(长)

要为Big Objects创建索引,必须至少将一个自定义字段标记为必需。

定义自定义Big Objects的索引

这个很重要!请记住,Big Objects索引中定义的字段决定了Big Objects的身份和查询能力。索引中定义的字段应该是与查询最相关的字段,因此您必须具有远见并在此处进行一些规划。您定义字段的顺序也是一个重要的考虑因素。如果您使用SOQL查询Big Objects,则只能按照您定义它们的顺序查询构成索引的字段。将查询过滤器中最常用的字段分配到第一个位置。你的索引。您还可以仅使用特定的比较运算符,具体取决于字段在查询中的位置。我们将在下一个单元中详细介绍查询。

定义索引时请记住这些注意事项。

  • 索引必须至少包含一个自定义字段,并且最多可以包含五个自定义字段。
  • 索引中包含的自定义字段必须标记为必需。
  • 长文本区域字段不能包含在索引中。
  • 索引中所有文本字段的字符总数不能超过50。
  • 创建索引后,您无法编辑或删除它。要更改索引,请使用新索引创建另一个Big Objects。

Big Objects索引详细信息

定义组成自定义Big Objects索引的字段,并确定字段和排序顺序。

字段名称描述
标签标签用于指代用户界面中的索引。
名称索引的API名称。
索引字段为索引中包含的每个自定义字段设置“索引位置”和“索引方向”。此处的字段顺序决定了它们在索引中的顺序。对于最常用的过滤器参数,将“索引位置”设置为1。Index Direction的有效值为Ascending和Descending。

示例自定义Big Objects

现在您已经知道制作自定义Big Objects需要什么,请尝试制作一个。让我们假装你开发了这款超棒的新游戏,SFORCE-COM:UFBO防御,玩家可以防御地球对抗身份不明的飞行大物体威胁。您希望能够存储玩家在单个游戏会话中进行的所有互动。在每个游戏会话中,您可以在自定义Big Objects中捕获此信息,Customer_Interaction__b:

  • 玩家购买的东西数量 In_Game_Purchase__c
  • 他们取得的最高水平 Level_Achieved__c
  • 他们有多少人的生命 Lives_This_Game__c
  • 他们的平台在 Game_Platform__c
  • 他们的得分在 Score_This_Game__c
  • 他们的客户名称 Account__c
  • 他们的比赛日期在 Play_Date__c
  • 他们的上场时间 Play_Duration__c

您的游戏非常受欢迎,因此对于每个用户,您每天都会进行多次互动,再加上您庞大的玩家群,这是一个非常惊人的记录数。啊,成功的代价!

您可以在自定义Big Objects上定义所有这些字段。定义字段后,还可以定义构成索引的字段。每个玩家的客户名称都是唯一的,因此您已经选择了Account__c作为我们指数中的第一个字段。索引中的下一个字段是玩家的游戏平台,Game_Platform__c那么会议的日期, Play_Date__c。此特定订单允许您仅查询客户,客户和游戏平台,客户,游戏平台和播放日期。

使用这些示例中的确切值来创建具有八个自定义字段和索引的自定义Big Objects。如果表中未列出字段和值,请忽略它或将其保留为默认值。

Big Objects定义细节

字段名称
标签客户互动
多个标签客户互动
对象名称Customer_Interaction
描述留着空白
部署状态开发中

Big Objects自定义字段

  • 游戏内购买
    • 数据类型:文本
    • 现场标签:游戏内购买
    • 长度:16
    • 字段名称:In_Game_Purchase
    • 要求:不
  • 达到水平
    • 数据类型:文本
    • 字段标签:达到等级
    • 长度:16
    • 字段名称:Level_Achieved
    • 要求:不
  • 生活使用这个游戏
    • 数据类型:数字
    • Field Label:生活使用此游戏
    • 长度:18
    • 小数位:0
    • 字段名称:Lives_This_Game
    • 要求:不
  • 平台
    • 数据类型:文本
    • 字段标签:平台
    • 长度:16
    • 字段名称:Game_Platform
    • 要求:是的
  • 得分这个游戏
    • 数据类型:文本
    • Field Label:为这场比赛打分
    • 长度:16
    • 字段名称:Score_This_Game
    • 要求:不
  • 客户
    • 数据类型:查找
    • 相关:客户
    • 字段标签:客户
    • 字段名称:Game_User_Account
    • 要求:是的
  • 比赛日期
    • 数据类型:日期/时间
    • 字段标签:播放日期
    • 字段名称:Play_Date
    • 要求:是的
  • 播放持续时间
    • 数据类型:数字
    • 字段标签:播放持续时间
    • 长度:18
    • 小数位:2
    • 字段名称:Play_Duration
    • 要求:不

现在,您有八个字段可以跟踪所有玩家的互动情况。做得好!

大对象自定义字段

Big Objects索引详细信息

字段名称
标签客户互动指数
名称CustomerInteractionsIndex
索引字段指数位置1:账户_c,降序索引位置2:Game_Platform__c,升序索引位置3:Play_Date__c,降序

部署Big Objects

现在您已经定义了自定义Big Objects,您已准备好部署它。单击 Big Objects上的“ 编辑 ”,然后将部署状态更改为“已部署”。

它们出现在设置中的大对象。

现在,您已准备好开始使用新的自定义Big Objects。

设置中的自定义大对象。

从这里,您可以编辑自定义Big Objects及其字段的标签和名称,但不能编辑或删除索引。要更改索引,请从新的Big Objects开始。您还可以从安装程序中删除自定义Big Objects。删除的Big Objects存储15天。在此期间,您可以恢复或永久删除它,但在这15天后,Big Objects将被永久删除。

填充Big Objects

填充Big Objects有两种主要方式。您可以将.csv文件与Data Loader或API一起使用,或者通过Apex完全执行。使用.csv文件时,文件中的第一行必须包含用于将.csv数据映射到自定义Big Objects的字段标签。将数据上传到Data Loader中的Big Objects或通过Bulk API或SOAP API上传。这是我们用来上传到我们的.csv文件Customer_Interaction__bBig Objects。作为一个例子,一个Big Objects可以支持比我们在这里提供的数据多很多倍的数据。

Play Start,In-Game Purchase,Level Achieved,Lives Used,Platform,Play Stop,Score,Account
2015-01-01T23:01:01Z,A12569,57,7,PC,2015-01-02T02:27:01Z,55736,001R000000302D3
2015-01-03T13:22:01Z,B78945,58,7,PC,2015-01-03T15:47:01Z,61209,001R000000302D3
2015-01-04T15:16:01Z,D12156,43,5,iOS,2015-01-04T16:55:01Z,36148,001R000000302D3

如果你想使用Apex填充 Customer_Interaction__b, 使用 insertImmediate 方法。

// Define the record
Customer_Interaction__b bo = new Customer_Interaction__b();
bo.Account__c = '001R000000302D3';
bo.Game_Platform__c = 'PC';
bo.Play_Date__c = DateTime.newInstance(2018, 2, 5);
bo.In_Game_Purchase__c = 'A12569';
bo.Level_Achieved__c = '45';
bo.Lives_This_Game__c = '3';
bo.Score_This_Game__c = '5500';
bo.Play_Duration__c = 25;
 
// Insert the record, which creates a new record
database.insertImmediate(bo);
// Define the record
Customer_Interaction__b bo = new Customer_Interaction__b();
bo.Account__c = '001R000000302D3';
bo.Game_Platform__c = 'PC';
bo.Play_Date__c = DateTime.newInstance(2018, 2, 5);
bo.In_Game_Purchase__c = 'A12569';
bo.Level_Achieved__c = '45';
bo.Lives_This_Game__c = '3';
bo.Score_This_Game__c = '5500';
bo.Play_Duration__c = 25;
 
// Modify a field in the index
bo.Game_Platform__c = 'Mac';
 
// Insert the record, creating a new record because the primary key has changed 
database.insertImmediate(bo);
// Define the record
Customer_Interaction__b bo = new Customer_Interaction__b();
bo.Account__c = '001R000000302D3';
bo.Game_Platform__c = 'PC';
bo.Play_Date__c = DateTime.newInstance(2018, 2, 5);
bo.In_Game_Purchase__c = 'A12569';
bo.Level_Achieved__c = '45';
bo.Lives_This_Game__c = '3';
bo.Score_This_Game__c = '5500';
bo.Play_Duration__c = 25;
 
// Modify a field not included in the index
bo.Level_Achieved__c = '1';
 
// Insert the record, which updates the second record because the index is the same 
database.insertImmediate(bo);
警告

警告

不允许使用混合DML调用的Apex测试失败。如果只写入Big Objects,则测试会将错误数据插入到您必须手动删除的目标Big Objects中。要包含对目标Big Objects的测试DML调用,请使用带有Apex存根API的模拟框架。

重新插入具有相同索引但具有不同数据的记录会导致类似于upsert操作的行为。如果存在具有索引的记录,则插入将使用新数据覆盖索引值。插入是幂等的,因此插入现有数据不会导致重复。上传数百万条记录时,重新插入很有帮助。如果发生错误,则重新插入会重新上载失败的上载而不会出现重复数据。在重新插入期间,如果提供的索引不存在记录,则插入新记录。