On this Page

Overview

Snap type:

Write

Description:

This Snap executes a Snowflake bulk upsert. The Snap bulk updates the records if present or inserts records to the target Snowflake table. Incoming documents are first written to a staging file on Snowflake's internal staging area. A temporary table is created on Snowflake with the contents of the staging file. An update operation is then run to update existing records in the target table and/or an insert operation is run to insert new records into the target table.

Depending on the account that you configure with the Snap, you can use the Snowflake Bulk Upsert Snap to upsert data into AWS S3 buckets or Microsoft Azure Storage Blobs.

The Snap creates temporary files in JCC when the staging location is internal and the data source is Input view. These temporary files are removed automatically once the Pipeline completes execution.

Prerequisites:

You must have minimum permissions on the database to execute Snowflake Snaps. To understand if you already have them, you must retrieve the current set of permissions. The following commands enable you to retrieve those permissions:

SHOW GRANTS ON DATABASE <database_name>
SHOW GRANTS ON SCHEMA <schema_name>
SHOW GRANTS TO USER <user_name>

Security prerequisites: You should have the following permission in your Snowflake account to execute this Snap:

Usage (DB and Schema): Privilege to use the database, role, and schema.

The following commands enable minimum privileges in the Snowflake Console:

grant usage on database <database_name> to role <role_name>;
grant usage on schema <database_name>.<schema_name>;

For more information on Snowflake privileges, refer to Access Control Privileges.

The below are mandatory when using an external staging location:

When using an Amazon S3 bucket for storage:

The Snowflake account should contain S3 Access-key ID, S3 Secret key, S3 Bucket and S3 Folder.
The Amazon S3 bucket where the Snowflake will write the output files must reside in the same region as your cluster.

When using a Microsoft Azure storage blob:

A working Snowflake Azure database account.

Behavior Change

In the 4.31 main18944 release and later, the Snowflake - Bulk Upsert Snap no longer supports values from an upstream input document in the Key columns field when the expression button is enabled.

To avoid breaking your existing Pipelines that use a value from the input schema in the Key columns field, update the Snap settings to use an input value from Pipeline parameters instead.

Internal SQL Commands

This Snap uses the following commands internally:

SELECT FROM TABLE: SELECT as a statement enables you to query the database and retrieve a set of rows. SELECT as a clause enables you to define the set of columns returned by a query.
COPY INTO <table>: Enables loading data from staged files to an existing table.
CREATE TEMPORARY TABLE: Enables creating temporary table in the database. See Create Temporary Table Privilege for more information.
MERGE: Enables inserting, updating, and deleting values in a table based on values in a second table or a subquery.

Support and limitations:

Works in Ultra Task Pipelines.
The special character '~' is not supported if it is there in temp directory name for Windows. It is reserved for user's home directory.

Known Issues:

Because of performance issues, all Snowflake Snaps now ignore the Cancel queued queries when pipeline is stopped or if it fails option for Manage Queued Queries, even when selected. Snaps behave as though the default Continue to execute queued queries when the Pipeline is stopped or if it fails option were selected.

Account:

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. The S3 Bucket, S3 Access-key ID, and S3 Secret key properties are not needed for the Snowflake Bulk Upsert Snap as Snowflake uses its internal staging area to host the input data. See Configuring Snowflake Accounts for information on setting up this type of account.

Views:

Input	This Snap has exactly one document input view.
Output	This Snap has at most one document output view.
Error	This Snap has at most one document error view and produces zero or more documents in the view.

Settings

Label

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.

Schema name

The database schema name. Selecting a schema filters the Table name list to show only those tables within the selected schema.

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

Table name

Required. The table on which to execute the bulk load operation.

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

Staging location

The type of staging location that is used for data loading.

The options available include:

External: Location that is not managed by Snowflake. The location should be an AWS S3 Bucket or Microsoft Azure Storage Blob. These credentials are mandatory while validating the Account.
Internal: Location that is managed by Snowflake.

Default value: Internal

File format object

Specifies an existing file format object to use for loading data into the table. The specified file format object determines the format type such as CSV, JSON, XML, and AVRO, or other format options for data files.

Default value: [None]

File format type Specifies a predefined file format object to use for loading data into the table. The available file formats include CSV, JSON, XML and AVRO.
Default value: NONE

File format option

Specifies the file format option; separate multiple options by using blank spaces and commas.

You can use various file format options including binary format which passes through in the same way as other file formats. See File Format Type Options for more information.

Before loading binary data into Snowflake, you must specify the binary encoding format, so that the Snap can decode the string type to binary types before loading into Snowflake. This can be done by specifying the following binary file format:

BINARY_FORMAT=xxx (Where XXX = HEX|BASE64|UTF-8)

However, the file you upload and download must be in similar formats. For instance, if you load a file in HEX binary format, you should specify the HEX format for download as well.

Default value: [None]

Encryption type

Specifies the type of encryption to be used on the data. The available encryption options are:

None: Files do not get encrypted.
Server Side Encryption: The output files on Amazon S3 are encrypted with server-side encryption.
Server-Side KMS Encryption: The output files on Amazon S3 are encrypted with Amazon S3-generated KMS key.

Default value: No default value.

The KMS Encryption option is available only for S3 Accounts (not for Azure Accounts) with Snowflake.

If Staging Location is set to Internal, and when Data source is Input view, the Server Side Encryption and Server-Side KMS Encryption options are not supported for Snowflake snaps:

This happens because Snowflake encrypts loading data in its internal staging area and does not allow the user to specify the type of encryption in the PUT API (see Snowflake PUT Command Documentation.)

KMS key

The KMS key that you want to use for S3 encryption. For more information about the KMS key, see AWS KMS Overview and Using Server Side Encryption.

Default value: No default value.

This property applies only when you select Server-Side KMS Encryption in the Encryption Type field above.

Buffer size (MB)

The size of each part, or chunk, of data being uploaded, in MB.

Minimum value: 6 MB

Maximum value: 5000 MB

Default value: 10 MB

The Snap uses the S3 Multipart Upload API to write files to S3. For more details, see Amazon S3 Multipart Upload Limits.

Key columns

Required. Specify the column to use for existing entries in the target table.

Default Value: None
Example: EmpID

The Key columns field does not support values from the upstream input document when the expression button is enabled. The value must be defined for all inputs and remain constant throughout the Snap execution. Therefore, the Snap supports expressions to include only constant pipeline parameters. If you are using a function to get or transform the value from a pipeline parameter, that value must evaluate to a value that is not null and is not empty at the time of pipeline execution.

Delete Upsert Condition

Delete Upsert Condition when true, causes the case to be executed.

Default: None

Preserve case sensitivity

Manage Queued Queries

Select this property to decide whether the Snap should continue or cancel the execution of the queued Snowflake Execute SQL queries when you stop the pipeline.

Default value: Continue to execute queued queries when the pipeline is stopped or if it fails.

If you select Cancel queued queries when the pipeline is stopped or if it fails, then the read queries under execution are canceled, whereas the write queries under execution are not canceled. Snowflake internally determines which queries are safe to be canceled and cancels those queries.

Load empty strings

If selected, empty string values in the input documents are loaded as empty strings to the string-type fields. Otherwise, empty string values in the input documents are loaded as null. Null values are loaded as null regardless.

Default value: Selected

Additional Options Use this field set to configure options when the Snap encounters error in a file.

On Error

Select an action to perform when the Snap encounters error in a file. The available actions are:

ABORT_STATEMENT: Aborts the upsert action and displays an error.
CONTINUE: Continues loading the file. The error is displayed in the output document.
SKIP_FILE: Skips upserting the files that contain errors.
SKIP_FILE_*error_limit*: Skips file when the number of errors in the file exceeds the number specified in the Error Limit field.
SKIP_FILE_*error_percent_limit*%: Skips file when the percentage of errors in the file exceeds the percentage specified in the Error Percentage Limit field.

Default value: ABORT_STATEMENT
Example: SKIP_FILE

Error Limit

Appears when you select SKIP_FILE_*error_limit* in theOn Error dropdown list.

Specify the possible number of errors that can exist in a file before skipping it. When the number of errors in the file exceeds the specified error limit, the Bulk Upsert Snap skips inserting, updating, or replacing the file.

Default value: 0
Example: 10

Error Percentage Limit

Appears when you select SKIP_FILE_*error_percent_limit*% in the On Error dropdown list.

Specify the limit of the percentage of errors after which the Snap should skip writing the file. If the error in the file exceeds the specified percentage, the Bulk Upsert Snap skips inserting, updating, or replacing the file.

Default value: 0
Example: 5

Snap execution

Select one of the three modes in which the Snap executes. 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.

Troubleshooting

Error

Reason

Resolution

Cannot lookup a property on a null value.

The value referenced in the Key Column field is null.

This Snap does not support values from an upstream input document in the Key columns field when the expression button is enabled.

Update the Snap settings to use an input value from Pipeline parameters and run the Pipeline again.

Example

Upserting Records

This example Pipeline demonstrates how you can efficiently update and delete data (rows) using the Key Column ID field and Upsert Delete condition. We use Snowflake - Bulk Upsert Snap to accomplish this task.

First, we configure the Mapper Snap with the required details to pass them as inputs to the downstream Snap.

After validation, the Mapper Snap prepares the output as shown below to pass to the Snowflake Bulk - Upsert Snap.

Next, we configure the Snowflake - Bulk Upsert Snap to:

Upsert the existing row for P_ID column, (so, we provide P_ID in the Key column field).
Delete the rows where the FIRSTNAME is snaplogic in the target table, (so, we specify FIRSTNAME = 'snaplogic' in the Delete Upsert Condition field).

After execution, this Snap inserts a new record into the existing row for the P_ID key column in Snowflake.

Inserted Records Output in JSON	Inserted Records in Snowflake

Upon execution, if the Delete Upsert condition is true, the Snap deletes the records in the target table as shown below.

Output in JSON	Deleted Record in Snowflake

Download this Pipeline.

Bulk Loading Records

In the following example, we update a record using the Snowflake Bulk Upsert Snap. The invalid records which cannot be inserted will be routed to an error view.

In the pipeline execution:

The Mapper (Data) Snap maps the record details to the input fields of Snowflake Upsert Snap:
Snowflake Upsert Snap updates the record using the "PRASANNA"."Persons" table object:
Successful execution of the pipeline displays the following data preview (Note that one input has been made and two records with the name P_ID have been updated within the Persons table.):

Downloads

Important steps to successfully reuse Pipelines

Download and import the pipeline into the SnapLogic application.
Configure Snap accounts as applicable.
Provide pipeline parameters as applicable.

	File	Modified

No files shared here yet.

Release	Snap Pack Version	Date	Type	Updates
November 2024	main29029	13 Nov 2024	Stable	Updated and certified against the current SnapLogic Platform release.
August 2024	438patches28811	01 Nov 2024	Latest	Fixed an issue with the Snowflake Snaps where the Snaps intermittently displayed an error requesting to `rollback`/`commit`.
August 2024	438patches28667	01 Nov 2024	Latest	Added the Snowflake - Snowpipe Streaming Snap that enables data insertion into Snowflake using the Snowpipe Streaming API. It allows for continuous data ingestion into Snowflake tables as soon as data becomes available.
August 2024	main27765	21 Aug 2024	Stable	Upgraded the `org.json.json` library from v20090211 to v20240303, which is fully backward compatible.
May 2024	437patches27531	07 Aug 2024	Latest	Enhanced the Snowflake - Select Snap with Time Travel query support that enables you to access historical data at any point within a defined period. This includes restoring data-related objects, duplicating and backing up data, and analyzing data usage.
May 2024	437patches27156	10 Jul 2024	Latest	Enhanced the Snowflake Azure OAuth2, Snowflake Google Storage OAuth2, and Snowflake S3 OAuth2 accounts with the Grant type dropdown list that enables you to authorize your account using the available (Authorization code, Client credentials, or Password) grant types. Updated the tooltip for the Encrypted Private Key Passphrase property in the Snowflake Azure Database Account for readability.
May 2024	437patches26821	27 Jun 2024	Latest	Added Snowflake - Vector Search Snap to enable advanced vector-based queries as part of the Select statement. Enhanced the Snowflake Snap Pack with full vector support, including schema generation and output compatibility with vector data types.
May 2024	437patches26508	28 May 2024	Latest	Fixed an issue with the Snowflake - Bulk Load and Snowflake - Bulk Upsert Snaps that displayed a `null pointer exception` when the File format type field was left blank or empty. Upgraded the JDBC driver for the Snowflake Snap Pack to v3.16.0.
May 2024	main26341	08 May 2024	Stable	Enhanced the Snowflake Bulk Load and Snowflake Insert Snaps to support iceberg tables. Iceberg tables partition and organize data across multiple nodes to distribute the workload and speed up data processing. Updated the Delete Condition (Truncates a Table if empty) field in the Snowflake - Delete Snap to Delete condition (deletes all records from a table if left blank) to indicate that all entries will be deleted from the table when this field is blank, but no truncate operation is performed.
February 2024	436patches25630	28 Mar 2024	Latest	Enhanced the Snowflake Bulk Load Snap to fetch the file format types based on the selected Datasource. The Snap now supports only CSV and NONE file format types (as a Suggestions list) when the Datasource is Input view. Enhanced the Snowflake Bulk Upsert Snap to support only CSV and NONE file format types (as a Suggestions list).
February 2024	main25112	14 Feb 2024	Stable	Updated and certified against the current SnapLogic Platform release.
November 2023	435patches24865	05 Feb 2024	Latest	Fixed an issue across the Snowflake Snaps that populated all suggestions for the Schema and Table Names existing in the configured Snowflake Account. Now, the Snaps only populate suggestions related to the database configured in the Account.
November 2023	435patches24110	14 Dec 2023	Latest	Added a lint warning to the Snowflake-Bulk Load Snap that recommends users to select the Purge checkbox when the Data source is input view and the Staging location is External.
November 2023	main23721	08 Nov 2023	Stable	The Snowflake Snap Pack is now bundled with the default Snowflake JDBC driver v3.14.
August 2023	434patches23541	30 Oct 2023	Latest	Fixed an issue with the Snowflake-Bulk Load Snap where the Snap wrote irrelevant errors to the error view when both of the following conditions occurred: The inserted data was not in the same order as the table schema. The Staging location was Internal. Now, the Snap writes the correct errors to the error view.
August 2023	main22460	16 Aug 2023	Stable	The Snowflake - Execute Snap now includes a new Query type field. When Auto is selected, the Snap tries to determine the query type automatically.
May 2023	433patches21890	17 Jul 2023	Latest	Enhanced the Snowflake - Bulk Load and Snowflake - Bulk Upsert Snaps with a new Flush chunk size (in bytes) field. When using internal staging, data is written to a temporary chunk file. When the file exceeds the specified size, it is copied to the Snowflake stage and deleted. Added validation of external storage credentials for Snowflake S3 Accounts.
May 2023	433patches21370	02 Jun 2023	Latest	Fixed an issue where the output document was missing information about the error records count and the reason for the error. Fixed an issue that caused stored procedure executions to fail in the Snowflake - Multi Execute Snap.
May 2023	main21015	10 May 2023	Stable	Snaplogic is specified as a partner tag in all requests going to Snowflake, making it easier for Snowflake to identify the requests coming from Snaplogic. The default JDBC driver JAR for the Snowflake Snap Pack is upgraded to version 3.13.28 to support the `GEOMETRY` data type.
February 2023	432patches20906	09 May 2023	Latest	The default JDBC driver JAR for the Snowflake Snap Pack is upgraded to version 3.13.28 to support the `GEOMETRY` data type. Fixed an issue with the Snowflake Multi Execute Snap to enable processing of large amounts of data (more than 2 billion records). Fixed a column mismatch issue that was caused by an assumed null AWS token that could potentially be an empty string.
February 2023	432patches20266	03 Apr 2023	Latest	Fixed an issue with the Snowflake - Bulk Load Snap that resulted in lowercase (or mixed case) column names when creating a new table under specific conditions. The new Create table with uppercase column names checkbox addresses this issue.
February 2023	432patches20120	09 Mar 2023	Latest	The Snowflake Bulk Load, Bulk Upsert, and Unload Snaps now support expressions for the Staging location field.
February 2023	main19844	09 Feb 2023	Stable	The JDBC Driver (JAR file) setting in all the Snowflake Accounts is optional. If you do not provide a JDBC driver, the account uses the default Snowflake JDBC driver JAR V3.13.25 that is bundled with the Snap Pack.
November 2022	431patches19581	20 Jan 2023	Latest	The Snowflake SCD2 Snap works as expected and does not display the `Cannot find input data related to the output record` error when you use the TIMESTAMPNTZ data type columns as Natural key fields. Fixed the memory leakage issue ( because of Key/pair authentication that occupied some memory) in the Snowflake Snaps. The performance of the Snowflake Snaps is optimized—there is less memory consumption, and exact memory dumps before and after the Pipeline execution.
November 2022	431patches19454	12 Jan 2023	Latest	The Snowflake Snap Pack supports geospatial data types. As the Snowflake Snap Pack requires using our custom Snowflake JDBC driver for full support of all data types, contact support@snaplogic.com for details.
November 2022	431patches19220	08 Dec 2022	Latest	The Snowflake S3 OAuth2 Account now support expressions for external staging fields.
November 2022	431patches19220	08 Dec 2022	Latest	The Snowflake - Bulk Upsert Snap no longer supports values from an upstream input document in the Key columns field when the expression button is enabled. The value must remain constant throughout the Snap’s execution and now limits support for expressions to include only Pipeline parameters. To avoid breaking your existing Pipelines that use a value from the input schema in the Key columns field, update the Snap settings to use an input value from Pipeline parameters instead. The Snowflake Bulk Load Snap no longer displays the validation warning in the following cases: When you configure the Validation Mode as NONE and Validation Errors Type as Do not show errors in the Snap, or When Validation Mode is RETURN_n_ROWS, RETURN_ERRORS, or RETURN_ALL_ERRORS.
November 2022	main18944	10 Nov 2022	Stable	The Snowflake - Bulk Load Snap now routes the `403-Access Denied` error to the error view (when the error view is enabled) when you do not have `DeleteObject` permission to delete the temporary files in the S3 bucket. Fixed the following issues in the Snowflake - Bulk Load Snap: The Snap failed when the Preserve case sensitivity field was not selected and the column names in the input document and the target table were the same but the cases were different. Now, the Snap does not fail and loads the data correctly to the target table. The Snap created a table when it did not exist with multiple columns in the target table when there were two input views, but the column name cases were different in both views. Now, the Snap creates the table from the metadata provided by the second input view and loads the data into the target table from the first input view. The Snowflake Insert Snap now creates the target table only from the table metadata of the second input view when the following conditions are met: The Create table if not present checkbox is selected. The target table does not exist. The table metadata is provided in the second input view.
November 2022	430patches18911	08 Nov 2022	Latest	Because of performance issues, all Snowflake Snaps now ignore the Cancel queued queries when pipeline is stopped or if it fails option for Manage Queued Queries, even when selected. Snaps behave as though the default Continue to execute queued queries when the Pipeline is stopped or if it fails option were selected.
October 2022	430patches18781	27 Oct 2022	Latest	The Snowflake Insert and Snowflake Bulk Upsert Snaps now do not fail with the `SQL Operation failed` error, when you insert the uppercase key name into a mixed-case column if the Preserve case sensitivity checkbox is deselected. The Snowflake Bulk Load Snap now works as expected when you configure On Error with SKIP_FILE_error_percent_limit% and set the Error Percent Limit to more than the percentage of rows with invalid data in the CSV file.
October 2022	430patches18432	13 Oct 2022	Latest	The Snowflake Bulk Load Snap now has a Validation Errors Type dynamic field, which provides options for displaying validation errors. You can now choose Aggregate errors per row to display a summary view of errors.
September 2022	430patches17962	19 Sep 2022	Latest	The Snowflake Bulk Load Snap now triggers the metadata query only once even for invalid input, thereby improving the performance of Snap.
September 2022	430patches17894	15 Sep 2022	Latest	The Snowflake Select Snap now works as expected when the table name is dependent on an upstream input.
August 2022	430patches17748	02 Sep 2022	Latest	Fixes in the Snowflake Bulk Load Snap: The Snap now routes the `403-Access Denied` error to the error view (when the error view is enabled) when you do not have `DeleteObject` permission to delete the temporary files in the S3 bucket. The Snap now checks for the expiration time whenever it receives a new access token for refreshing the token in Snowflake OAuth2 account.
August 2022	430patches17377	25 Aug 2022	Latest	The following issues are fixed in the Snowflake - Bulk Load Snap: The Snap successfully loads the data even when you deselect the Preserve case- sensitivity checkbox and the source and target column names are similar, but with different casing. When the Snap has two input views, it creates the target table from the metadata provided by the second input view and loads the data into the target table from the first input view. The Snowflake Select Snap now validates successfully even when you set the Table Name field with an expression.
August 2022	main17386	11 Aug 2022	Stable	The following Snowflake Accounts support Key Pair Authentication. Snowflake Azure Database Account Snowflake Google Storage Database Account Snowflake S3 Database Account Snowflake S3 Dynamic Account
4.29 Patch	429patches16478	21 Jul 2022	Latest	Fixed an issue with Snowflake - Bulk Load Snap where Snap failed with 301 status code - SnapDataException.
4.29 Patch	429patches16458	27 Jun 2022	Latest	Fixed the following issues with the Snaps that use Snowflake Accounts Key Pair Authentication. The Snaps were not able to read the private keys provided as Pipeline parameters, because the key was malformed by replacing the line breaks with whitespace characters. Now, the private keys are properly formed and read when provided as Pipeline parameters. The Snap displayed a Null Point Exception error when you pass an invalid key into the Private Key field like test. Now, the Snap displays a valid error message. Fixed an issue with the Snaps due to an upgrade made to HikariCP that caused a conditional failure and prevented the downstream Snaps to supply the parameters to the stored procedure. Fixed an issue with Snowflake Execute and Snowflake Select Snaps where the Snap displayed an exception error when the FLOAT or DOUBLE datatype column has the value as NaN (Not a Number). Now the output value is written as-is (NaN) for FLOAT or DOUBLE datatype column and does not display an exception. Enhanced the following Snowflake Accounts with support for Key Pair Authentication. Snowflake Azure Database Account Snowflake Google Storage Database Account Snowflake S3 Database Account Snowflake S3 Dynamic Account Removed support for unencrypted Private Keys to enforce security in Snowflake accounts.
4.29	main15993	14 May 2022	Stable	Upgraded with the latest SnapLogic Platform release.
4.28 Patch	428patches15236	12 Apr 2022	Latest	Updated the Snowflake - Bulk Upsert Snap for the following: The Snap displayed a incorrect resolution when the length of the value exceeded the value defined in a column. The Snap failed with a NullPointer Exception when no value was provided for Error Limit field and Error percentage limit fields. The Snap displayed an incorrect error message when S3 details were not provided. Added the On Error dropdown list, where you can select an action to perform when the Snap encounters errors in a file. Removed the Username field in the following accounts to allow reusing of accounts among different users: Snowflake Azure OAuth2 Account Snowflake S3 OAuth2 Account Snowflake Google Storage OAuth2 Account The following enhancements were done for Snowflake - Bulk Load Snap: The Snap skips AWS account validation if S3 Storage Integration property is provided. The Snap skips the validate command if S3 Storage Integration property is not provided The Snap overrides the storage integration specified in the account settings with the storage integration specified in the Snap settings. Enhanced the Snowflake - Unload Snap to skip AWS account validation if S3 Storage Integration property is provided.
4.28	main14627	12 Feb 2022	Stable	Enhanced the Snowflake S3 Database Account with the S3 Storage Integration field to support authentication of Amazon S3 bucket hosting as the external stage. When you provide a value in this field, the Snap enables the COPY command to avoid using AWS credentials for authentication. Added the following account types that enable OAuth2 authentication for all the Snowflake Snaps. Snowflake Azure OAuth Account Snowflake Google Storage OAuth2 Account Snowflake S3 OAuth2 Account Updated the label for Delete Condition to Delete Condition (Truncates Table if empty) in the Snowflake Delete Snap
4.27	427patches12999	23 Nov 2021	Latest	Enhanced the Snowflake SCD2 Snap to support Pipeline parameters for Natural key and Cause-historization fields.
4.27	main12833	13 Nov 2021	Stable	Enhanced the Snowflake S3 Database Account to skip batch execution, when the Batch size value is one. When the Batch size is greater than one, the batch is executed. Added the following truncate options to Snowflake - Bulk Load Snap to truncate existing data before performing data load to more efficiently transfer data where possible. Truncate data: Truncates existing data before performing data load. Truncate columns: Truncates column values that are larger than the maximum column length in the table. Enhanced the Snowflake - Execute Snap to invoke stored procedures.
4.26 Patch	426patches11469	03 Sep 2021	Latest	Fixed an issue with Snowflake Insert and Snowflake Bulk Load Snaps where the schema names or database names containing underscore (_) caused the time out of Pipelines.
4.26	main11181	14 Aug 2021	Stable	Enhanced Snowflake - Lookup and Snowflake SCD2 Snaps with the Input Date Format field to select from the following two options: Continue to execute the snap with the given input Date format Auto Convert the format to Snowflake default format Added a new account type Snowflake Google Storage Database to connect to Google Cloud Storage to load data. Added support for all existing Snowflake Snap accounts to connect to a Snowflake instance hosted on the Google Cloud Platform
4.25	425patches10190	07 Jul 2021	Latest	Enhanced the Snowflake S3 Database and Snowflake S3 Dynamic accounts with a new field S3 AWS Token that allows you to connect to private and protected Amazon S3 buckets.
4.25	main9554	08 May 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.24 Patch	424patches8905	14 Apr 2021	Latest	Enhanced the Snowflake - Bulk Load Snap to allow transforming data using a new field Select Query before loading data into the Snowflake database. This option enables you to query the staged data files by either reordering the columns or loading a subset of table data from a staged file. This Snap supports CSV and JSON file formats for this data transformation.
4.24	main8556	13 Feb 2021	Stable	Enhanced the Snowflake - Select Snap to return only the selected output fields or columns in the output schema (second output view) using the Fetch Output Fields In Schema check box. If the Output Fields field is empty all the columns are visible.
4.23 Patch	423patches7905	28 Dec 2020	Latest	Fixed the performance issue in the Snowflake - Bulk Load Snap while using External Staging on Amazon S3.
4.23	main7430	14 Nov 2020	Stable	Enhanced the Snowflake - Unload and Snowflake - Bulk Load Snaps with Storage Integration field which supports using the Cross Account IAM in the external staging. Enhanced the following Snowflake Snaps by enabling session management for Snowflake queries by adding Manage Queued Queries field to enables you to track and cancel queued queries when the pipeline stops or fails. The default option allows the pipeline to continue the queued queries and not have the Snowflake Snaps to trigger additional queries for session management: Snowflake - Bulk Load \| Snowflake - Bulk Upsert Snowflake - Insert \| Snowflake - Delete Snowflake - Execute \| Snowflake - Multi Execute Snowflake - Lookup \| Snowflake - Select Snowflake - Unload \| Snowflake - Update Snowflake SCD2
4.22 Patch	422patches7246	06 Nov 2020	Latest	Fixed an issue with the Snowflake Snaps that failed while displaying similar error in the Snowflake URL connection: `message, javax.management.MalformedObjectNameException: Invalid character '=' in value part of property, repeatedly when there is "=" or ":"` .
4.22 Patch	422patches6849	16 Oct 2020	Latest	Enhanced the following Snowflake Snaps by adding a new field, Manage Queued Queries, to enable you to decide whether a given Snap should continue or cancel executing the queued Snowflake Execute SQL queries. Snowflake - Bulk Load \| Snowflake - Bulk Upsert Snowflake - Insert \| Snowflake - Delete Snowflake - Execute \| Snowflake - Multi Execute Snowflake - Lookup \| Snowflake - Select Snowflake - Unload \| Snowflake - Update Snowflake SCD2 Enhanced Snowflake Snaps by enabling the Session Management of the Snowflake Queries to give the user an option to be able to track and cancel queued queries when the pipeline stops or fails. Default option is to let the pipeline to continue the queued queries and not have the Snowflake Snaps to trigger additional queries for session management.
4.22	main6403	12 Sep 2020	Stable	Updated with the latest SnapLogic Platform release.
4.21 Patch	421patches6272	27 Jul 2020	Latest	Fixes the issue where Snowflake SCD2 Snap generates two output documents despite no changes to Cause-historization fields with DATE, TIME and TIMESTAMP Snowflake data types, and with Ignore unchanged rows field selected.
4.21 Patch	421patches6144	02 Jul 2020	Latest	Fixed the following issues with DB Snaps: The connection thread waits indefinitely causing the subsequent connection requests to become unresponsive. Connection leaks occur during Pipeline execution. Fixed the exception `RefCnt has gone negative` across the Snaps in the Snowflake Snap Pack.
4.21 Patch	db/snowflake8860	02 Jun 2020	Latest	Added a new field, Handle Timestamp and Date Time Data, to Snowflake Lookup Snap. This field enables you to decide whether the Snap should translate UTC time to your local time and the format of the Date Time data.
4.21 Patch	MULTIPLE8841	19 May 2020	Latest	Fixed the connection issue in Database Snaps by detecting and closing open connections after the Snap execution ends.
4.21	snapsmrc542	09 May 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.20 Patch	db/snowflake8800	14 Apr 2020	Latest	Certifies the Snowflake Snap Pack against JDBC Driver version 3.12.3. Snowflake Execute and Multi-Execute Snaps may break existing Pipelines if the JDBC Driver is updated to a newer version. With the updated JDBC driver (version 3.12.3), the Snowflake Execute and Multi-Execute Snaps' output displays a Status of "-1" instead of "0" without the Message field upon successfully executing DDL statements. If your Pipelines use these Snaps and downstream Snaps use the Status field's value from these, you must modify the downstream Snaps to proceed on a status value of -1 instead of 0. This change in the Snap behavior follows from the change introduced in the Snowflake JDBC driver in version 3.8.1: "Statement.getUpdateCount() and PreparedStatement.getUpdateCount() return the number of rows updated by DML statements. For all other types of statements, including queries, they return -1."
4.20 Patch	db/snowflake8758	03 Mar 2020	Latest	Re-release of fixes from db/snowflake8687 for 4.20: Fixes the Snowflake Bulk Load snap where the Snap fails to load documents containing single quotes when the Load empty strings checkbox is not selected.
4.20	snapsmrc535	08 Feb 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.19 Patch	db/snowflake8687	04 Feb 2020	Latest	Fixed the Snowflake Bulk Load snap where the Snap fails to load documents containing single quotes when the Load empty strings checkbox is not selected.
4.19 Patch	db/snowflake8499	04 Jan 2020	Latest	Added the property Handle Timestamp and Date Time Data to Snowflake - Execute and Snowflake - Select Snaps. This property enables you to decide whether the Snap should translate UTC time to your local time.
4.19 Patch	db/snowflake8412	13 Dec 2019	Latest	Fixed an issue with the Snowflake - Update Snap wherein the Snap is unable to perform operations when: An expression is used in the Update condition property. Input data contain the character '?'.
4.19	snaprsmrc528	14 Nov 2019	Stable	Added a new field-set, Auto Historization Query, in the Snowflake SCD2 Snap to support auto-historization of column data. With this enhancement you can detect whether the incoming record is a historical event or a current event. Raised the minimum buffer size in the Snowflake - Bulk Upsert and Snowflake - Bulk Load Snaps to 6 MB.
4.18 Patch	db/snowflake8044	14 Oct 2019	Latest	Fixed an issue with the Snowflake - Select Snap wherein the Snap converts the Snowflake-provided timestamp value to the local timezone of the account.
4.18 Patch	db/snowflake8044	14 Oct 2019	Latest	Enhanced the Snap Pack to support AWS SDK 1.11.634 to fix the NullPointerException issue in the AWS SDK. This issue occurred in AWS-related Snaps that had HTTP or HTTPS proxy configured without a username and/or password.
4.18 Patch	MULTIPLE7884	09 Oct 2019	Latest	Fixed an issue with the PostgreSQL grammar to better handle the single quote characters.
4.18 Patch	db/snowflake7821	16 Sep 2019	Latest	Fixed an issue with the Snowflake - Execute Snap wherein the Snap is unable to support the '$' character in query syntax.
4.18 Patch	MULTIPLE7778	28 Aug 2019	Latest	Updated the AWS SDK library version to default to Signature Version 4 Signing process for API requests across all regions.
4.18 Patch	db/snowflake7739	20 Aug 2019	Latest	Fixed an issue with the Snowflake - Bulk Upsert Snap wherein the Snap fails when using a pipeline parameter in Key columns. Fixed an issue with the Snowflake - Unload Snap wherein the Snap does not abort the query when you stop the Pipeline execution.
4.18	snapsmrc523	10 Aug 2019	Stable	Added the Use Result Query property to the Multi Execute Snap, which enables you to write results to an output view.
4.17	ALL7402	11 Jun 2019	Latest	Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.
4.17 Patch	db/snowflake7396	10 Jun 2019	Latest	Fixed an issue wherein bit data types in the Snowflake - Select table convert to true or false instead of 0 or 1.
4.17 Patch	db/snowflake7334	31 May 2019	Latest	Added AWS Server-Side Encryption support for AWS S3 and AWS KMS (Key Management Service) for Snowflake Bulk Load, Snowflake Bulk Upsert, and Snowflake Unload Snaps.
4.17	snapsmrc515	11 Jun 2019	Latest	Fixed an issue with the Snowflake Execute Snap wherein the Snap would send the input document to the output view even if the Pass through field is not selected in the Snap configuration. With this fix, the Snap sends the input document to the output view, under the key original, only if you select the Pass through field. 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 Patch	db/snowflake6945	13 Mar 2019	Latest	Fixed an issue with the Snowflake Lookup Snap failing when Date datatype is used in JavaScript functions.
4.16 Patch	db/snowflake6928	08 Mar 2019	Latest	Added support for file format options for input data from upstream Snaps, to the Snowflake Bulk Load Snap.
4.16 Patch	db/snowflake6819	22 Feb 2019	Latest	Snowflake Bulk Load: Added new property, Buffer size (MB). Configure this to specify the size limit of each buffer when writing to external staging systems such as S3. Fixed an issue with the Lookup Snap passing data simultaneously to output and error views when some values contained spaces at the end.
4.16	snapsmrc508	16 Feb 2019	Stable	Snowflake Account: Added the ability to use SnapLogic to securely connect to and query a Snowflake instance using Azure Blob as its storage layer. Snowflake Account: Added support for Snowflake JDBC driver JAR version 3.6.17. Snowflake Unload, Bulk Load, and Bulk Upsert: Updated the Snaps to enable SnapLogic users to successfully connect to a Snowflake instance to query, bulk load, and unload data from Azure Blob storage.
4.15	snapsmrc500	15 Dec 2018	Stable	Added two new Snaps, Snowflake - Multi Execute, and Snowflake SCD2. Snowflake - Multi Execute is used for executing multiple DDL and DML queries on the Snowflake DB. Snowflake SCD2 is used for Type 2 field historization. Enhanced the Snowflake Bulk Upsert Snaps to improve the Snaps performance. Enhanced the Snowflake Snap Pack to reflect Azure certification.
4.14	snapsmrc490	11 Aug 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.13	snapsmrc486	12 May 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.12	snapsmrc480	17 Feb 2018	Stable	Upgraded with the latest SnapLogic Platform release.
4.11 Patch	MULTIPLE4377	18 Dec 2017	Latest	Fixed a document call issue that was slowing down the Snowflake Bulk Load Snap.
4.11 Patch	db/snowflake4283	16 Nov 2017	Latest	Snowflake Bulk Load - Fixed an issue by adding PUT command to the list of DDL command list for Snowflake.
4.11 Patch	db/snowflake4273	14 Nov 2017	Latest	Snowflake Bulk Load - Resolved an issue with Snowflake Bulk Load Delimiter Consistency (comma and newline).
4.11	snapsmrc465	11 Nov 2017	Stable	Upgraded with the latest SnapLogic Platform release.
4.10 Patch	snowflake4133		Latest	Updated the Snowflake Bulk Load Snap with Preserve case sensitivity property to preserve the case sensitivity of column names.
4.10	snapsmrc414	12 Aug 2017	Stable	Updated the Snowflake Bulk Load Snap with Load empty strings property for the empty string values in the input documents to be loaded as empty strings to the string-type fields. Updated the Snowflake Bulk Load Snap with Table Columns to support the order of the entries on the staged files that contain a subset of the columns in the Snowflake table. Added the property Use Result Query to view the output preview field with a result statement. Tested for the JDBC driver JAR version 3.1.1 on the Database and the Dynamic accounts.
4.9.0 Patch	snowflake3234	06 Jul 2017	Latest	Enhanced Snowflake - Execute Snap results to include additional details
4.9.0 Patch	snowflake3125	22 Jun 2017	Latest	Addressed an issue in Snowflake Bulk Load where the comma character in a value is not escaped.
4.9	snapsmrc405	13 May 2017	Stable	JDBC Driver Class property added to enable the user to custom configure the JDBC driver in the Database and the Dynamic accounts.
4.8.0 Patch	snowflake2760	27 Mar 2017	Latest	Potential fix for JDBC deadlock issue.
4.8.0 Patch	snowflake2739	09 Mar 2017	Latest	Addressed an issue with the Snowflake schema not correctly represented in the Mapper Snap.
4.8	snapsmrc398	11 Feb 2017	Stable	Info tab added to accounts. Database accounts now invalidate connection pools if account properties are modified and login attempts fail. Enhanced the default count of input and output view (UI) behavior of the Snaps for better user experience. Note that the Snowflake Select, Table List and Lookup Snap views remain unchanged.