On this page

Overview

This Snap executes a SQL INSERT statement to insert records into the selected table of a Vertica database. The Snap uses the document's keys as columns and the document's values as values to insert records.

Snap Type

Vertica - Insert Snap is a WRITE-type Snap that inserts new records into a SQL database table.

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines.

Limitations and Known Issues

None.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input

Document

  • Min: 1

  • Max: 1

  • Mapper

  • Copy

The records to be inserted.

Output

Document 

  • Min: 0

  • Max: 1

NA

The original document with the inserted records.

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.

Database Write Snaps output all records of a batch (as configured in your account settings) to the error view if the write fails during batch processing.

Snap Settings

  • Asterisk ( * ): Indicates a mandatory field.

  • Suggestion icon ((blue star)): Indicates a list that is dynamically populated based on the configuration.

  • Expression icon ((blue star)): Indicates whether the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ((blue star)): Indicates that you can add fields in the field set.

  • Remove icon ((blue star)): Indicates that you can remove fields from the field set.

Field Name

Field Type

Description

Label*

 

Default Value: Vertica - Insert
Example: Vertica - Insert

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: N/A
Example: public

String/Expression/Suggestion

Specify the database schema name. Selecting a schema filters the Table name list to show only those tables within the selected schema. The property is suggestible and retrieves available database schemas during suggest values.

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

Table name*

Default Value: N/A
Example: "dbo"."Employee"

String/Expression/Suggestion

Specify the table on which to execute the insert operation.

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

Create table if not present

Default value: Not selected
Example: N/A

Checkbox

Select this check box to automatically create the target table if it does not exist.

This Snap creates a table based on the data types of the columns generated from the first row of the input document.

Number of Retries

Default Value: 0
Example: 3

Integer/Expression

Specify the maximum number of times that the process must be retried before displaying an error.

Retry interval (Seconds)

Default Value: 1
Example: 10

Integer/Expression

Specify the maximum resting time in seconds between subsequent retries.

Snap Execution

Default Value: Execute only
Example: Validate & Execute

Dropdown list