In this article
Overview
You can use this Snap to execute a query to search for similar records from the Snowflake database.
Snap Type
The Snowflake - Vector Search Snap is a Read-type Snap.
Prerequisites
Valid client ID.
A valid account with the required permissions.
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 |
|
|
|
Output | Document |
|
| For each input document, all results are grouped into a single output document |
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:
Learn more about Error handling in Pipelines. |
Snap Settings
Asterisk ( * ): Indicates a mandatory field.
Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.
Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.
Add icon ( ): Indicates that you can add fields in the fieldset.
Remove icon ( ): Indicates that you can remove fields from the fieldset.
Upload icon ( ): Indicates that you can upload files.
Field Name | Field Type | Description |
---|---|---|
Label* Default Value: Snowflake Vector Search | String | 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 | String/Expression/Suggestion | Specify the schema name for searching for a vector. |
Table name* Default Value: N/A | String/Expression/Suggestion | Specify the table name for searching for a vector. |
Vector column* Default Value: N/A | String/Expression/Suggestion | Specify the vector column name to search. |
Similarity Function* Default Value: L2 | Dropdown List | Select the similarity functions used for comparing vectors. The available options are:
|
Where Clause Default Value: N/A | String/Expression/Suggestion | Specify the clause to use in the vector search query statement.
|
Limit Rows Default Value: 4 | Integer/Expression/Suggestion | Specify the number of results to return for each query. |
Include values Default Value: Deselected | Checkbox/Expression | Select this checkbox to include vector values in the response. This field does not support input schema. |
Include scores Default Value: Selected | Checkbox/Expression | Select this checkbox to include similarity scores in the response. |
Number of Retries Default Value: 0 | Integer/Expression | Specify the maximum number of attempts to be made to receive a response. |
Retry Interval (Seconds) Default Value: 0 | Integer/Expression | Specify the minimum number of seconds the Snap must wait before each retry attempt. |
Handle Timestamp and Date Time Data Default Value: Default Date Time format in UTC Time Zone | Dropdown List | Select how you want the Snap to handle timestamp and date time data. The available options are:
|
Snap execution Default Value: | Dropdown list | Select one of the following three modes in which the Snap executes:
|
Troubleshooting
Error | Reason | Resolution |
---|---|---|
Account validation failed. | The Pipeline ended before the batch could complete execution due to a connection error. | Verify that the Refresh token field is configured to handle the inputs properly. If you are not sure when the input data is available, configure this field as zero to keep the connection always open. |
Examples
Excluding Fields from the Input Data Stream
We can exclude the unrequired fields from the input data stream by omitting them in the Input schema fieldset. This example demonstrates how we can use the <Snap Name> to achieve this result:
<screenshot of Pipeline/Snap and description>
Download this Pipeline.
Downloads
Download and import the Pipeline into SnapLogic.
Configure Snap accounts, as applicable.
Provide Pipeline parameters, as applicable.