--- schema_version: "1" id: 7e1c1c2f9dbcf5c25d3061917446b38d747b07ecccc12d6bb10634d848f9f0f7 title: DataLakeObjectInstance collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_datalakeobjectinstance.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_datalakeobjectinstance.htm source_site: developer.salesforce.com content_type: documentation content_hash: 89225b59e1e6356f0c8b55e9cb5add87389fa12972f433c233175e36fa0a0fb3 description: Represents a data lake object (DLO). This object is available in API version 63.0 and later. --- # DataLakeObjectInstance Represents a data lake object (DLO). This object is available in API version 63.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields | Field | Details | | --- | --- | | AccelerationEnabled | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Indicates whether acceleration is turned on for external DLOs (**YES**) or not (**NO**). Acceleration increases how frequently DLO data is refreshed. Possible values are: - NO - YES | | AccelerationSchedule | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Incremental refresh frequency for an external DLO. How often the system runs acceleration when AccelerationEnabled is **YES**. Possible values are: - EVERY\_12\_HOURS - EVERY\_24\_HOURS - EVERY\_4\_HOURS - EVERY\_7\_DAYS | | Billable | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Indicates if this DLO is usage-metered (billable). Possible values are: - YES | | Category | Type string Properties Filter, Group, Nillable, Sort Description Type of DLO (for example: Engagement). | | DataLakeObjectNamespacePrefix | Type string Properties Filter, Group, Nillable, Sort Description Namespace prefix of the related MktDataLakeObject developer name in a Developer Edition org. Used with the MktDataLakeObjectDeveloperName field to look up the single DLO that matches a namespaced DLO. | | DataLakeObjectRef | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort Description Reference to the MktDataLakeObject that corresponds to this DLO when standard DLOs are enabled. Stores the standard DLO API reference (EnumOrId-style), for example Account\_std\_\_dll, in place of or in addition to the legacy MktDataLakeObject Id. Custom DLOs still use the ID in the other reference field. Possible values are: - Account\_std\_\_dll - ApiGrounding\_std\_\_dll - BenefitType\_std\_\_dll - Benefit\_std\_\_dll - Case\_std\_\_dll - CatalogEnrichment\_std\_\_dll - CatalogMetadataRelationship\_std\_\_dll - CatalogMetadata\_std\_\_dll - ConsumptionResourceTags\_std\_\_dll - Contact\_std\_\_dll - ForecastingFact\_std\_\_dll - ForecastingItem\_std\_\_dll - FtestMain\_std\_\_dll - FtestMetadataDlo\_std\_\_dll - GameDefinition\_std\_\_dll - GameParticipant\_std\_\_dll - GameReward\_std\_\_dll - JournalSubType\_std\_\_dll - JournalType\_std\_\_dll - KnowledgeLayoutAssignment\_std\_\_dll - KnowledgeLayout\_std\_\_dll - ListEmail\_std\_\_dll - LoyaltyAggrPointExprLedger\_std\_\_dll - LoyaltyMemberCurrency\_std\_\_dll - LoyaltyMemberTier\_std\_\_dll - LoyaltyPartnerProduct\_std\_\_dll - LoyaltyPgmEngmtAttrLimit\_std\_\_dll - LoyaltyPgmEngmtAttrProm\_std\_\_dll - LoyaltyPgmEngmtAttribute\_std\_\_dll - LoyaltyPgmGroupMbrRlnsp\_std\_\_dll - LoyaltyPgmMbrAttributeVal\_std\_\_dll - LoyaltyPgmPartnerCurrency\_std\_\_dll - LoyaltyPgmPartnerPromotion\_std\_\_dll - LoyaltyProgramBadge\_std\_\_dll - LoyaltyProgramCurrency\_std\_\_dll - LoyaltyProgramMbrPromotion\_std\_\_dll - LoyaltyProgramMemberCase\_std\_\_dll - LoyaltyProgramMemberMerge\_std\_\_dll - LoyaltyProgramPartner\_std\_\_dll - LoyaltyProgram\_std\_\_dll - LoyaltyTierBenefit\_std\_\_dll - LoyaltyTierGroup\_std\_\_dll - LoyaltyTier\_std\_\_dll - ManagedContentVariant\_std\_\_dll - ManagedContent\_std\_\_dll - MemberBenefit\_std\_\_dll - OpportunityContactRole\_std\_\_dll - ProductCatalog\_std\_\_dll - ProductCategoryProduct\_std\_\_dll - ProductCategory\_std\_\_dll - PromotionLoyaltyPtnrProdt\_std\_\_dll - PromotionMarketSegment\_std\_\_dll - PromotionPartyUsage\_std\_\_dll - Promotion\_std\_\_dll - VoucherDefinition\_std\_\_dll - Voucher\_std\_\_dll | | DataLakeObjectStatus | Type picklist Properties Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort Description Status of this DLO. You can’t change a DLO when it’s in the PROCESSING state. If you make any changes to a DLO, this field will be in the PROCESSING state, and later ACTIVE when the update is complete. Possible values are: - ACTIVE - DELETING - ERROR - INACTIVE - NONE - PROCESSING The default value is PROCESSING. | | DeletionRecordsDataLakeObject | Type string Properties Filter, Group, Nillable, Sort Description API name of the DLO that stores deletion records associated with this DLO. | | Description | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Description of the DLO. | | ExternalName | Type string Properties Filter, Group, Nillable, Sort Description Name of the DLO in the external data source. | | ExternalObjectErrorCode | Type string Properties Filter, Group, Nillable, Sort Description Provider-specific or internal error code when the external DLO reports an error (pairs with ExternalObjectErrorStatus). | | ExternalObjectErrorStatus | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Activity status of an external DLO. Possible values are: - ACTIVE - ERROR | | HydrationStatus | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description How fully this DLO has been hydrated in storage (all data available vs. partial vs. not yet loaded). Possible values are: - Hydrated - PartiallyHydrated - Unhydrated | | LastDataChangeStatusDateTime | Type dateTime Properties Filter, Nillable, Sort Description Date and time of the most recent data change or ingestion status transition relevant to this DLO. | | LastDataChangeStatusErrorCode | Type string Properties Filter, Group, Nillable, Sort Description Error code explaining the last data change failure. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description Last date when a user referenced this record. | | LastRefreshDate | Type dateTime Properties Filter, Nillable, Sort Description Last date when ingested or synced data for this DLO was refreshed. | | LastSyncedFingerprint | Type textarea Properties Nillable Description Content or schema fingerprint from the last successful sync, used to detect when upstream data or layout changes. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description Last date when a user viewed this record in the UI. | | MktDataLakeObjectDeveloperName | Type string Properties Filter, Group, Nillable, Sort Description Developer name of the related MktDataLakeObject. For a namespaced DLO, this is paired with DataLakeObjectNamespacePrefix. For a standard DLO, this may be the standard DLO’s API name**.** | | MktDataLakeObjectLabel | Type string Properties Filter, Group, Nillable, Sort Description User-defined label of the DLO. | | Name | Type string Properties Create, Filter, Group, idLookup, Sort, Update Description Name of the DLO. | | ProblemRecordsDataLakeObject | Type string Properties Filter, Group, Nillable, Sort Description API name of the DLO that stores failed records for this DLO. | | Storage | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Where the DLO’s physical data resides. For standard DLOs, the query path can default this to LOCAL when not set. Possible values are: - EXTERNAL—External - LOCAL—Local | | SyncStatus | Type picklist Properties Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort Description Synchronization status of the DLO. For external DLOs, this field exposes connection issues. With standard DLOs, this field is read and written at the same time as DataLakeObjectStatus to reflect ingestion state. Possible values are: - ACTIVE - DELETING - ERROR - INACTIVE - NONE - PROCESSING The default value is PROCESSING. | | TotalNumberOfFields | Type int Properties Filter, Group, Nillable, Sort Description Total number of fields in the DLO. | | TotalRecords | Type long Properties Filter, Group, Nillable, Sort Description Total number of records stored in the DLO. |