Adobe Experience Platform Execute

Owned by Siddharth Menon (Unlicensed)
Last updated: Mar 24, 2021

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

  • Valid client ID.
  • The SQL Statement you want to execute.

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

Important Steps to Successfully Reuse Pipelines

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


Snap Pack History

 Click to view/expand

4.24 (main8556)

  • No updates made.

4.23 423patches7447

  • Fixes the Adobe Experience Platform Execute Snap issue of not passing data correctly to the downstream Snap by creating Map obj = new LinkedHashMap(); inside loop. LinkedHashMap is a hash table and linked list implementation of the Map interface, with a predictable iteration order. 

4.23 (main7430)

  • Replaces the Adobe Cloud Platform Snap Pack.
  • Introduces the Adobe Experience Platform Read Snap that enables executing SQL queries in the Adobe Experience Platform.
  • Updates the Adobe Experience Platform JWT Account to enable you to create accounts in a Sandbox location during the development phase.
  • Enhances the Adobe Experience Platform Read Snap by adding fields, Batch IDs, Start date, and End Date to allow filtering batches by ID, start date, and end date with millisecond precision.

4.22 (main6403)

4.21 Patches

4.21 (snapsmrc542)

4.20 (snapsmrc535)

  • No updates made.

4.19 (snapsmrc528)

  • No updates made.

4.18 (snapsmrc523)

  • Enhanced the Snap Pack to support the Map datatype in XSD-based datasets.

4.17 Patch ALL7402

  • Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17 (snapsmrc515)

  • Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16 (snapsmrc508)

  • No updates made. Automatic rebuild with a platform release.

4.15 (snapsmrc500)

  • No updates made. Automatic rebuild with a platform release.

4.14 (snapsmrc490) 

  • No updates made. Automatic rebuild with a platform release.

4.13 (snapsmrc486)

  • New! Initial release of the Snap Pack. This includes Adobe Cloud Platform Read and Adobe Cloud Platform Write Snaps.
  • Introduced the basic Adobe Cloud Platform JWT Account.

See Also

Have feedback? Email documentation@snaplogic.com | Ask a question in the SnapLogic Community
© 2017-2024 SnapLogic, Inc.