Vertica - Select

Overview

The Vertica - Select Snap enables you to fetch data from a database by providing a table name and configuring the connection.

The Snap produces the records from the database on its output view, which can then be processed by a downstream Snap.

JSON paths can be used in a query and will have values from an incoming document substituted into the query. However, documents missing values for a given JSON path will be written to the Snap's error view. After a query is executed, the query's results are merged into the incoming document, overwriting any existing keys' values. The original document is output if there are no results from the query.

Queries produced by the Snap have the format:

SELECT * FROM [table] WHERE [where clause] ORDER BY [ordering] LIMIT [limit] OFFSET [offset]

If more powerful functionality is desired, then the Vertica - Execute Snap should be used.

Prerequisites

None.

Supported Accounts

Snap views

Type Description Examples of upstream and downstream Snaps
Input

This Snap has exactly one document input view.
Output

This Snap has at most one document output view.
Learn more about Error handling.

Snap settings

Legend:
  • Expression icon (): Allows using pipeline parameters to set field values dynamically (if enabled). SnapLogic Expressions are not supported. If disabled, you can provide a static value.
  • SnapGPT (): Generates SnapLogic Expressions based on natural language using SnapGPT. Learn more.
  • Suggestion icon (): Populates a list of values dynamically based on your Snap configuration. You can select only one attribute at a time using the icon. Type into the field if it supports a comma-separated list of values.
  • Upload : Uploads files. Learn more.
Learn more about the icons in the Snap settings dialog.
Field/Field set Description
Label

String

Required. Specify a unique name for the Snap. Modify this to be more appropriate, especially if more than one of the same Snaps is in the pipeline.

Default value: Vertica Select

Example: Vertica Select
Schema name

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.
Note: The values can be passed using the pipeline parameters but not the upstream parameter.

Default value: N/A

Example: public
Table name

String/Expression/ Suggestion

 Required. Specify the table on which to execute the select operation.
Note: The values can be passed using the pipeline parameters but not the upstream parameter.

Default value: N/A

Example: employees
Output fields

String/Expression/ Suggestion

 Specify the output columns to select from the table. If not specified, all columns will be selected (SELECT *).

Default value: N/A

Example: first_name, last_name, email
Where clause

String/Expression

 Specify the SQL WHERE clause to filter records. Do not include the WHERE keyword.

Default value: N/A

Example: status = 'active' AND created_date > '2020-01-01'
Order by

String/Expression

 Specify the ORDER BY clause for sorting results. Do not include the ORDER BY keyword.

Default value: N/A

Example: last_name ASC, first_name ASC
Limit rows

Integer/Expression

 Specify the maximum number of rows to return (LIMIT clause).

Default value: N/A

Example: 100
Limit offset

Integer/Expression

 Specify the number of rows to skip before returning results (OFFSET clause).

Default value: 0

Example: 50
Number of retries

Integer/Expression

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

Default value: 0

Example: 2
Retry interval (seconds)

Integer/Expression

 Specify the maximum resting time in seconds between subsequent retries.

Default value: 1

Example: 2
Auto commit

Dropdown list

 Select one of the options for this property to override the state of the Auto commit property on the account. The Auto commit at the Snap level has three values: True, False, and Use account setting.
  • True - The Snap will execute with auto-commit enabled regardless of the value set for Auto commit in the Account used by the Snap.
  • False - The Snap will execute with auto-commit disabled regardless of the value set for Auto commit in the Account used by the Snap.
  • Use account setting - The Snap will execute with Auto commit property value inherited by the Account used by the Snap.

Default value: Use account setting
Snap Execution

Dropdown list

Choose one of the three modes in which the Snap executes. The available options are:

Validate & Execute: Performs limited execution of the Snap and generates a data preview during pipeline validation. Subsequently, 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 that are downstream from it.

Default value: Execute only

Example: Validate & Execute