# tSnowflakeInput Standard properties

These properties are used to configure tSnowflakeInput running in the Standard Job framework.

The Standard tSnowflakeInput component belongs to the Cloud family.

The component in this framework is available in all Talend products.

Information noteNote: This component is a specific version of a dynamic database connector. The properties related to database settings vary depending on your database type selection. For more information about dynamic database connectors, see [DB Generic components](https://help.qlik.com/talend/r/en-US/8.0/components/db-generic/db-generic-component).

## Basic settings

| Properties | Description |
| --- | --- |
| Database | Select the desired database type from the list and click<br>Apply. |
| Property Type | Select the way the connection details<br>will be set.<br><br><ul> <li> <p> <span>Built-In</span>: The connection details will be set                                locally for this component. You need to specify the values for all                                related connection properties manually.</p> </li> <li> <p> <span>Repository</span>: The connection details stored                                centrally in <span><span>Repository</span><abbr> &gt; </abbr><span>Metadata</span></span> will be reused by this component. </p> <p>You need to click                                the <span>[...]</span> button next to it and in the pop-up                                    <span>Repository Content</span> dialog box, select the                                connection details to be reused, and all related connection                                properties will be automatically filled in.</p> </li> </ul><br><br>This property is not available when other connection component is selected from<br>the Connection Component dropdown list. |
| Component list | Select the component that opens the database connection to be reused by this<br>component. |
| Account | In the Account field, enter, in double<br>quotation marks, the account name that has been assigned to you by Snowflake. |
| Authentication Type | Set the authentication type.<br><br><ul> <li> <p> <span>Basic</span>: Select this option if key pair                           authentication is not enabled. </p> </li> <li> <p> <span>Key Pair</span>: Select this option if key pair                           authentication is enabled.</p> <p>See <a href="https://docs.snowflake.net/manuals/user-guide/jdbc-configure.html#using-key-pair-authentication" target="_blank">Using Key Pair Authentication</a> for related                           information.</p> </li> <li> <p> <span>OAuth 2.0</span>: Select this option to use external                           OAuth for data accessing.</p> <p>See <a href="https://docs.snowflake.com/en/user-guide/oauth-ext-overview.html" target="_blank">External OAuth Overview</a> for related                           information.</p> </li> </ul><br><br>Information noteNote: Before selecting the Key<br>Pair option, make sure you have set the key pair authentication<br>data in the Basic settings view of the tSetKeystore<br>component as follows.<br><br><ol> <li>Leave the <span>TrustStore type</span> field unchanged.</li> <li>Set <span>TrustStore file</span> to                           <kbd>""</kbd>.</li> <li>Clear the <span>TrustStore password</span> field.</li> <li>Select <span>Need Client authentication</span>.</li> <li>Enter the path to the key store file in double quotation marks in the                              <span>KeyStore file</span> field (or click the                              <span>[…]</span> button to the right of the                              <span>KeyStore file</span> field and navigate to the key                           store file).</li> <li>Enter the key store file password in the <span>KeyStore                              password</span> field.</li> <li>Clear the <span>Check server identity</span> option.</li> </ol> |
| OAuth token endpoint | Enter OAuth 2.0 token endpoint.<br><br>This option is available when<br>OAuth 2.0 is selected from the<br>Authentication Type dropdown list. |
| Client ID | Enter the client ID of your application.<br><br>This option is available when<br>OAuth 2.0 is selected from the<br>Authentication Type dropdown list. |
| Client Secret | Enter the client secret of your application.<br><br>This option is available when<br>OAuth 2.0 is selected from the<br>Authentication Type dropdown list. |
| Grant type | Set the grant type for retrieving the access token. Two options are<br>provided: Client Credentials and<br>Password.<br><br>Click [Client Credentials](https://tools.ietf.org/html/rfc6749#section-1.3.4) and [Resource Owner Password Credentials](https://tools.ietf.org/html/rfc6749#section-1.3.3) for related<br>information.<br><br>This option is available when OAuth<br>2.0 is selected from the Authentication<br>Type dropdown list. |
| OAuth username | Enter the OAuth username.<br><br>This option is available when<br>Password is selected from the Grant<br>type dropdown list. |
| OAuth password | Enter the OAuth password.<br><br>To enter the password, click the [...] button<br>next to the password field, enter the password between double quotes in the<br>pop-up dialog box, and then click OK to save the<br>settings.<br><br>This option is available when Password<br>is selected from the Grant type dropdown<br>list.<br><br>Information noteNote: OAuth password does not support spaces. |
| Scope | Enter the scope. See [Scopes](https://docs.snowflake.com/en/user-guide/oauth-ext-overview.html#scopes) for related information.<br><br>This option is<br>available when OAuth 2.0 is selected from the<br>Authentication Type dropdown list. |
| User Id and Password | Enter, in double quotation marks, your authentication information to<br>log in to Snowflake.<br><br><ul> <li> <p>In the <span>User ID</span> field, enter, in                        double quotation marks, your login name that has been defined in Snowflake                        using the <em>LOGIN_NAME</em> parameter of                        Snowflake. For details, ask the administrator of your Snowflake                    system.</p> </li> <li> <p>To enter the password, click the <span>[...]</span> button         next to the password field, enter the password in double quotes in the pop-up dialog box,         and click <span>OK</span> to save the settings.</p> </li> </ul> |
| Warehouse | Enter, in double quotation marks, the name of the<br>Snowflake warehouse to be used. This name is case-sensitive and is normally upper<br>case in Snowflake. |
| Schema | Enter,<br>within double quotation marks, the name of the database schema to be used. This name<br>is case-sensitive and is normally upper case in Snowflake. |
| Database | Enter, in double quotation<br>marks, the name of the Snowflake database to be used. This name is case-sensitive<br>and is normally upper case in Snowflake. |
| Table | Click the [...] button and in the displayed wizard, select the<br>Snowflake table to be used. |
| Schema and Edit Schema | A schema is a row description. It defines the number of fields<br>(columns) to be processed and passed on to the next component. When you create a Spark<br>Job, avoid the reserved word line when naming the<br>fields.<br><br><br>Built-In: You create and store the schema locally for this component<br>only.<br><br><br>Repository: You have already created the schema and stored it in the<br>Repository. You can reuse it in various projects and Job designs.<br><br>If the Snowflake data type to be handled is VARIANT, OBJECT, or ARRAY, while<br>defining the schema in the component, select String for the<br>corresponding data in the Type column of the schema editor<br>wizard.<br><br>Click Edit<br>schema to make changes to the schema. If the current schema is of the Repository type, three options are available:<br><br><ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion.</p> <p>If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul><br><br>Note that if the input value of any non-nullable primitive field is null, the row of data including that field will be rejected.<br><br>This component offers the advantage of the<br>dynamic schema feature. This allows you to retrieve unknown columns from source<br>files or to copy batches of columns from a source without mapping each column<br>individually. For further information about dynamic schemas, see [Dynamic schema](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/dynamic-schema).<br><br>This<br>dynamic schema feature is designed for the purpose of retrieving unknown columns of a<br>table and is recommended to be used for this purpose only; it is not recommended for the<br>use of creating tables. |
| Manual Query | Select this checkbox and in the Full SQL query<br>string field, enter, within double quotation marks, the query statement<br>to be executed. For information about the Snowflake SQL commands, see [SQL Command Reference](https://docs.snowflake.net/manuals/sql-reference-commands.html).<br><br>This component supports vector search capabilities, you can use this option to<br>specify the query condition using the vector previously created in<br>Snowflake.<br><br>For more information on Snowflake vector search, see the<br>corresponding [Snowflake documentation](https://docs.snowflake.com/en/sql-reference/data-types-vector). |
| Condition | Enter, in double quotation marks, the boolean expression to be used<br>to filter data from your Snowflake table. This expression is actually used as WHERE<br>clause in the SELECT query run by tSnowflakeInput. |

## Advanced settings

| Properties | Description |
| --- | --- |
| Additional JDBC Parameters | Specify additional connection properties for the database connection you are<br>creating. The properties are separated by semicolon and each property is a key-value<br>pair, for example, *encryption=1;clientname=Talend*.<br><br>This field is available only when you select Use<br>this Component from the Connection Component<br>dropdown list and select Internal from the<br>Storage dropdown list in the Basic<br>settings view. |
| Login Timeout | Specify the timeout period (in minutes)<br>of Snowflake login attempts. An error will be generated if no response is received<br>in this period.<br><br>This field is available only when you select Use<br>this Component from the Connection Component<br>dropdown list and select Internal from the<br>Storage dropdown list in the Basic<br>settings view. |
| Role | Enter, in<br>double quotation marks, the default access control role to use to initiate the<br>Snowflake session.<br><br>This role must already exist and<br>has been granted to the user ID you are using to connect to Snowflake. If this field<br>is left empty, the PUBLIC role is automatically granted. For information about<br>Snowflake access control model, see [Understanding the Access Control<br>Model](https://docs.snowflake.net/manuals/user-guide/security-access-control.html).<br><br>This field is available only when you select Use<br>this Component from the Connection Component<br>dropdown list and select Internal from the<br>Storage dropdown list in the Basic<br>settings view. |
| URL suffix | Enter, in double quotation marks, the Snowflake custom domain URL of your<br>choice. For more information about Snowflake URL formats, see [Standard account URLs](https://docs.snowflake.com/en/user-guide/organizations-connect#standard-account-urls).<br><br>For Snowflake components other than tSnowflakeConnection, this field is<br>available when you select Use This Component from the<br>Connection Component drop-down list in the<br>Basic settings view. |
| Use unquoted object identifiers | Select this checkbox to use unquoted table name and<br>schema column names. Note that unquoted identifiers need to match the Snowflake<br>Identifier Syntax. A column name or a table name not conforming to the<br>Snowflake Identifier Syntax will be quoted even if this checkbox is<br>selected.<br><br>If you deselect the checkbox, all object identifiers are<br>automatically quoted.<br><br>This property is not available when you select the<br>Manual Query checkbox.<br><br>For information about the Snowflake<br>Identifier Syntax, see [Identifier Requirements](https://docs.snowflake.net/manuals/sql-reference/identifiers-syntax.html). |
| Use session timezone | Select this check box to use the time zone of the session instead of the JVM<br>time zone. By default, this option is not selected. |
| tStatCatcher Statistics | Select this checkbox to gather the Job processing metadata at the Job level<br>as well as at each component level. |

## Global Variables

| Variables | Description |
| --- | --- |
| NB\_LINE | The number of rows processed. This is an After variable and<br>it returns an integer. |
| ERROR\_MESSAGE | The error message generated by the component when an error<br>occurs. This is an After variable and it returns a string. |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is start component of a data flow in your Job. It sends data<br>to other components via a Row<br>link. |