Snowflake Data Cloud Connector > Part II: Data Integration with Snowflake Data Cloud Connector > Lookups for Snowflake Data Cloud > Lookup properties for Snowflake Data Cloud
  

Lookup properties for Snowflake Data Cloud

The following table describes the Snowflake Data Cloud lookup object properties that you can configure in a Lookup transformation:
Property
Description
Connection
Name of the lookup connection.
You can select an existing connection, create a new connection, or define parameter values for the lookup connection property.
Note: You can switch between a non-parameterized and a parameterized Snowflake Data Cloud connection. The advanced property values are retained during the switch.
If you want to overwrite the lookup connection properties at runtime, select the Allow parameter to be overridden at run time option.
Source Type
Type of the source object. Select Single Object, Query1,or Parameter.
Parameter
A parameter file where you define values that you want to update without having to edit the task. Select an existing parameter for the lookup object or click New Parameter to define a new parameter for the lookup object.
The Parameter property appears only if you select parameter as the lookup type.
If you want to overwrite the parameter at runtime, select the Allow parameter to be overridden at run time option.
When the task runs, it uses the parameters from the file that you specify in the task advanced session properties.
Lookup Object
Name of the lookup object for the mapping.
Multiple Matches
Behavior when the lookup condition returns multiple matches. You can return all rows, any row, the first row, the last row, or an error.
You can select from the following options in the lookup object properties to determine the behavior:
  • - Return first row 1
  • - Return last row 1
  • - Return any row
  • - Return all rows
  • - Report error
Filter
Not applicable.
Sort
Not applicable.
1Doesn't apply to mappings in advanced mode.
The following table describes the Snowflake Data Cloud lookup object advanced properties that you can configure in a Lookup transformation:
Advanced Property
Description
Database
Overrides the database specified in the connection.
Schema
Overrides the schema specified in the connection.
Warehouse
Overrides the Snowflake warehouse name specified in the connection.
The warehouse name in the mapping overrides the warehouse name you specify in the connection. Even though you provide an incorrect warehouse name in the connection properties, the connection is successful. However, before you run the mapping, ensure that you specify the correct warehouse name in the mapping properties.
Role
Overrides the Snowflake role assigned to the user specified in the connection.
Pre SQL
Not applicable.
Post SQL
Not applicable.
SQL Override1
Overrides the default SQL query used to read data from the Snowflake source.
Lookup Data Filter1
Limits the number of lookups that the mapping performs on the cache of the lookup source table based on the value you specify in the filter condition.
This property is applicable when you select object as the source type and enable lookup cache on the Advanced tab for the Lookup transformation.
Maximum length is 32768 characters.
For more information about this property, see Lookup source filter in Transformations.
1Doesn't apply to mappings in advanced mode.

Parameterization

When you parameterize lookup objects and connections, you must follow some rules to override the object name.
If you enable the Allow parameter to be overridden at run time option in a transformation, you cannot override the object name using the fully qualified name such as db.schema.tablename.
You must pass the db=<dbname>&schema<schemaname> values in the Additional JDBC URL Parameters field in the Snowflake Data Cloud connection.

Multiple match restrictions

When you configure a lookup, you define the behavior when a lookup condition returns more than one match. You can return all rows, any row, the first row, the last row, or an error.
The following configurations have multiple match policy restrictions: