---
schema_version: "1"
id: 58c874cfd5a2ac57e81dd73fe3df24ba11d7f9f53da6cd6ded3d0dc61a8e17c1
title: External Data Source Callout Event Type
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_eventlogfile_externaldatasourcecallout.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_eventlogfile_externaldatasourcecallout.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 85c2120b836f70b29c9cd7e86c3c6ce2f144676d3227c840dbad36b1f8bc6a0f
description: External Data Source Callout events represent external data callouts via the Salesforce Connect adapters for Amazon DynamoDB and Amazon Athena. This event type is available in the EventLogFile object in API version 56.0 and later.
---
# External Data Source Callout Event Type

External Data Source Callout events represent external data callouts via the Salesforce Connect adapters for Amazon DynamoDB and Amazon Athena. This event type is available in the EventLogFile object in API version 56.0 and later.

For details about event monitoring, see the [Trailhead Event Monitoring module](https://trailhead.salesforce.com/en/modules/event_monitoring/units/event_monitoring_intro "HTML (New Window)") or [REST API Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_rest.meta/api_rest/using_resources_event_log_files.htm "HTML (New Window)").

## Fields

| Field | Details |
| --- | --- |
| ACTION | 
Type

String

Description

Action performed by the callout.

Possible Values

For Amazon DynamoDB data source:

- query
- insert
- delete
- update
- upsert

For Amazon Athena data source:

- query





 |
| DATA\_SOURCE\_NAME | 

Type

String

Description

Name of the external data source being accessed.



 |
| EVENT\_TYPE | 

Type

String

Description

Type of event. Value is always ExternalDataSourceCallout.



 |
| EXTERNAL\_OBJECT | 

Type

String

Description

Name of the external object being accessed.



 |
| FETCH\_MS | 

Type

Number

Description

How long it took (in milliseconds) to retrieve the query results from the external data source.

Example

127



 |
| FILTER | 

Type

Text

Description

Field expressions to filter which rows to return. Corresponds to WHERE in queries.



 |
| LIMIT | 

Type

Number

Description

Maximum number of rows to return for a query. Corresponds to [Limit parameter in ExecuteStatement operation](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ExecuteStatement.html) for an Amazon DynamoDB data source.



 |
| MESSAGE | 

Type

String

Description

Error or warning message associated with the failed call.



 |
| NEXT\_LINK | 

Type

String

Description

Next link that the callout used to request a subsequent page of rows. A next link is provided in a previous response when the response includes only part of the result set.

For requests to AWS data sources, this field stores the nextToken parameter that contains a unique hash string.





 |
| OFFSET | 

Type

Number

Description

Number of rows to skip when paging through a result set. Corresponds to OFFSET in queries to Amazon Athena. This field is not supported by queries to Amazon DynamoDB.



 |
| OPERATION | 

Type

String

Description

The operation that’s being performed.



 |
| ORDERBY | 

Type

String

Description

Field or column to use for sorting query results, and whether to sort the results in ascending (default) or descending order. Corresponds to ORDER BY in queries.

Example

- Country ASC
- CustomerName DESC





 |
| ORGANIZATION\_ID | 

Type

Id

Description

15-character ID of the organization.

Example

00D000000000123



 |
| PARENT\_CALLOUT | 

Type

String

Description

If the callout requested a subsequent page of rows, this field identifies the initial callout whose request resulted in the multi-page result set.

Example

4EoZtuBzzRIXSk-ysRdf1F-1



 |
| PROVIDER\_TYPE | 

Type

String

Description

Whether the callout was made by Salesforce Connect adapter for Amazon DynamoDB or Amazon Athena.

Possible Values

- amazonDynamodb
- amazonAthena





 |
| REQUEST\_ID | 

Type

String

Description

Unique ID of a transaction. A transaction can contain one or more events. All events in a transaction have the same REQUEST\_ID.

Example

4A13-HSKv3CKs-0FKfceaV



 |
| RESPONSE\_SIZE | 

Type

Number

Description

The size of the callout response, in bytes.



 |
| ROWS\_FETCHED | 

Type

Number

Description

Number of records fetched by the callout. The records fetched by a callout can be a subset of a large result set.

Example

200



 |
| SEARCH | 

Type

String

Description

Search query string.



 |
| SELECT | 

Type

String

Description

Comma-separated list of fields being queried. Corresponds to SELECT in queries.

To query, Salesforce Connect adapter uses PartiQL with Amazon DynamoDB and SQL with Amazon Athena.

Example

CustomerID,OrderDate,OrderID,ShipCity,ShipCountry



 |
| STATUS | 

Type

Boolean

Description

Whether the query was successful.

Possible Values

- 1—Success
- 0—Failed





 |
| STATUS\_CODE | 

Type

Number

Description

The HTTP response status code for the request.



 |
| TABLE\_NAME | 

Type

String

Description

Name of the table being queried in the AWS data source.



 |
| THROUGHPUT | 

Type

Number

Description

Number of records retrieved in one second.

Example

3025.67



 |
| TIMESTAMP | 

Type

DateTime

Description

The access time of Salesforce services in GMT.

For example: 20130715233322.670.



 |
| TIMESTAMP\_DERIVED | 

Type

DateTime

Description

The access time of Salesforce services in ISO8601-compatible format (YYYY-MM-DDTHH:MM:SS.sssZ).

For example: 2015-07-27T11:32:59.555Z. Timezone is GMT.



 |
| TOTAL\_MS | 

Type

Number

Description

How long it took (in milliseconds) to prepare and execute the query and to retrieve the query results.



 |
| USER\_ID | 

Type

Id

Description

15-character ID of the user accessing the external data source.

Example

00530000009M943



 |