Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

Table of Contents
maxLevel2
excludeOlder Versions|Additional Resources|Related Links|Related Information

...

You can use this Snap to execute a SQL delete as per the configured properties.

...

Oracle JDBC Driver Upgrade

Multiexcerpt include macro
nameOracle JDBC Driver Upgrade
templateDataeJyLjgUAARUAuQ==
pageOracle Snap Pack
addpanelfalse

...

Works in Ultra Pipelines

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document


  • Min: 0

  • Max: 1

  • Mapper

  • Copy

The records to be deleted.

Output

Document


  • Min: 0

  • Max: 1

NA

This Snap has at most one document output view. If an output view is available, then the original document

that was

used to create the statement will be output with the status of the delete executed.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:

  • Stop Pipeline Execution: Stops the current pipeline execution when the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.


Field Name

Field Type

Description

Label

Default Value: Oracle Delete
Example: Delete contract emps

String

Specify 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.

Schema name


Default value:  [None]Value: N/A
Example: SYS SYS

String/Expression/Suggestion

The Specify the database schema name. In case If it is not defined, then the suggestion for the Table Name will retrieve  retrieves all tables table names of all schemas. The property is suggestible and will retrieve available database schemas during suggest values.

note

The values can be passed using the pipeline parameters but not the upstream parameter.

Table name*


Default valueValue:  [None]N/A
Example: people people

String/Expression/Suggestion

Required. The Specify the table name to execute the delete onstatement.

Note

The values can be passed using the pipeline parameters but not the upstream parameter.

 

Delete condition (deletes all records from table if left blank)


Default value:  N/A

Examples:

Without using expressions

Using expressions

  • "EMPNO=$EMPNO and ENAME=$EMPNAME"

  • email = $email 

  • emp=$emp

  • "emp='" + $emp + "'"

  • "EMPNO=" + $EMPNO + " and ENAME='" + $EMPNAME+ "'"

String/Expression

This is an expression property to specify the SQL WHERE clause of the delete statement. The delete condition may also be passed via an upstream Snap or through the pipeline parameters.

Note

Specify a valid WHERE clause for the delete condition. If you leave this field blank, the Snap deletes all the records from the table.

Warning

Caution

Using expressions that join strings together to create SQL queries or conditions has a potential SQL injection risk and is hence unsafe. Ensure that you understand all implications and risks involved before using concatenation of strings with '=' Expression enabled.


Number of retriesExample: 3

Default value: 0
Example: 3

Integer/Expression

Specifies Specify the maximum number of attempts to be made make to receive a response. The request is terminated if the attempts do not result in a response.


Retry interval (seconds)

Default Value: 1
Example:  10

Default value: 1

Integer/Expression

Specifies Specify the time interval between two successive retry requests. A retry happens only when the previous attempt resulted in an exception. 


Multiexcerpt include macro
nameSnap Execution
pageSOAP Execute

Default Value: Execute only
Example: Validate & Execute


Multiexcerpt include macro
nameExecution_Detail_Write
pageSOAP Execute

Examples

Following are the two examples, the first one using a conditional update of one of the values that then gets merged into the data using the Oracle - Merge Snap. 

Delete student records

The following example pipeline demonstrates how to delete all the student records that have the same scores as Adam's. In this example, we have a table named STUDENT that stores students' scores. It has 3 columns:

  • ID

...

  • NAME

...

  • SCORE

...

Configure the Oracle - Select Snap finds to find the row whose NAME is 'Adam', and pass the row's data to Oracle - Delete Snap.

...

Then Configure the Oracle - Delete Oracle—Delete Snap will to delete all the rows that has with the same score as Adam's. We use $SCORE to retrieve the data of from the SCORE Column passed from Oracle - Select Oracle—Select Snap.

...

Error Handling

...

This example will show pipeline demonstrates the error handling of the Snap. We use the same pipeline as the one in Example #1 and let error messages route to the error view:

...

Configure the Oracle - Delete Snap to set the Delete condition property to "Score = $NAME", which is supposed to cause a type mismatch error since column SCORE is of type NUMBER while column NAME is of type VARCHAR2:

...

Here is the error message that is routed to error view:

...

Downloads

Multiexcerpt include macro
namedownload_instructions
pageOpenAPI

Attachments
patterns*.slp, *.zip


Snap Pack History

Insert excerpt
Oracle Snap Pack
Oracle Snap Pack
nopaneltrue