In this article

Overview

Use the Adobe Experience Platform Execute Snap to execute queries, this includes selecting and joining data across datasets. You can query the Data Lake via SQL-like statements using the query service.

Prerequisites

Support for Ultra Pipelines

Works in Ultra Pipelines. 

Limitations

None.

Known Issues

None.

Snap Input and Output

Input/OutputType of ViewNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input 

Document


  • Min: 0
  • Max: 1
  • Mapper Snap
Ensure to provide input, which is the SQL statement to execute query.
Output

Document


  • Min: 0
  • Max: 1
  • Mapper Snap

The output document contains the SQL query execution result.

Snap Settings


Parameter Name
Data Type
Description
Default Value
Example 
LabelString
Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline.
Adobe Experience Platform ExecuteAdobe Experience Platform Execute_23
SQL StatementStringEnter the SQL queries to execute in the Adobe Experience Platform. See SQL overviewformore information on writing the queries for Adobe Experience PlatformN/ASELECT employeedataset._snaplogicinc.employeeid AS EmployeeID,
employeedataset._snaplogicinc.ename AS EmployeeName,
employeedataset._snaplogicinc.esalary AS EmployeeSalary,
employeedataset._snaplogicinc.deptid AS DepartmenttID,
departmentdataset._snaplogicinc.Dname AS DepartmentName,
departmentdataset._snaplogicinc.Dlocation AS DepartmentLocation
FROM employeedataset INNER JOIN departmentdataset ON
employeedataset._snaplogicinc.deptid = departmentdataset._snaplogicinc.deptid
ORDER BY 1
Snap ExecutionDrop-down list

Select one of the three following modes in which the Snap executes:

  • Validate & Execute. Performs limited execution of the Snap and generates a data preview during Pipeline validation, then performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only. Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled. Disables the Snap and all Snaps downstream from it.

Execute onlyValidate and Execute


Troubleshooting


Error
Reason
Resolution
Please check queryThe SQL query entered in the Query field is not valid.Ensure that the query in the SQL Statement field is valid” or something like this.


Examples

Obtain Employee Details

This example demonstrates the process to retrieve employee details from Employee Data Set table using Adobe Experience Execute Snap. Use Mapper Snap to transform incoming data and send the output to JSON Formatter Snap to read the document and write the JSON binary data to output. Finally, use File Write Snap to write JSON file output to an end point.

In this example, we will execute a SQL query to retrieve employee data through Adobe Experience Execute Snap.

First, provide inputs to the Adobe Experience Platform Execute Snap Settings fields. You will retrieve the data on the basis of the given SQL Statement on running the Pipeline.

AEP Query SnapOutput

Now, we connect Mapper Snap to transform incoming data for mapping and transfer the output to JSON Formatter Snap.

MapperOutput

In the next step, we connect JSON Formatter Snap to read JSON document data from Mapper Snap, and formats and writes it as JSON binary data to its output view.

JSON Formatter

Finally, we connect File Writer Snap to the Pipeline to write JSON file output to an end point. Enter a name in the File name field and run the Pipeline. You will find a JSON file with a record of employee details.

File WriterOutput




Download this Pipeline. 

Downloads

  1. Download and import the Pipeline into SnapLogic.
  2. Configure Snap accounts as applicable.
  3. Provide Pipeline parameters as applicable.


See Also