> For the complete documentation index, see [llms.txt](https://docs.ovaledge.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ovaledge.com/release8.1/connectors/connector-repositories/data-warehouse/snowflake.md).

# Snowflake

This article outlines the integration with the Snowflake connector, enabling streamlined metadata management through features such as crawling, profiling, querying, data preview, Data Quality, Data Access Management, and lineage building (both automatic and manual).

The Snowflake connector establishes connectivity through a JDBC driver. It supports Username & Password and Key Pair Authentication. The connector enables access to metadata from Snowflake objects, including tables, views, columns, functions, and stored procedures.

<figure><img src="/files/NF8xcj4LFQxINbZxwhUW" alt=""><figcaption></figcaption></figure>

## Overview

### Connector Details

<table data-header-hidden><thead><tr><th width="411.5"></th><th></th></tr></thead><tbody><tr><td>Connector Category</td><td>Data Warehouse</td></tr><tr><td>OvalEdge Release Supported</td><td>Release6.3.4 and later</td></tr><tr><td><p>Connectivity</p><p>[How the connection is established with Snowflake]</p></td><td>JDBC driver</td></tr></tbody></table>

Connectivity to the Snowflake connector is established using a JDBC driver. The supported driver version is listed below:

| Driver Details | Version |
| -------------- | ------- |
| JDBC driver    | 8.2.0   |

### Connector Features

| Feature                                      |                                                                         Availability                                                                        |
| -------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------: |
| Crawling                                     |                                                                              ✅                                                                              |
| Delta Crawling                               |                                                                              ❌                                                                              |
| Profiling                                    |                                                                              ✅                                                                              |
| Sample Profiling                             |                                                                              ✅                                                                              |
| Query Sheet                                  |                                                                              ✅                                                                              |
| Data Preview                                 |                                                                              ✅                                                                              |
| Auto Lineage                                 | <p>✅<br>To learn more, click <a href="https://docs.ovaledge.com/connectors/connector-repositories/data-warehouse/snowflake/snowflake-lineage">here</a>.</p> |
| Manual Lineage                               |                                                                              ✅                                                                              |
| Secure Authentication via Credential Manager |                                                                              ✅                                                                              |
| Data Quality                                 |                                                                              ✅                                                                              |
| DAM (Data Access Management)                 |                                                                              ✅                                                                              |
| Bridge                                       |                                                                              ✅                                                                              |

### Metadata Mapping

The following objects are crawled from Snowflake and mapped to the corresponding UI assets.

<table><thead><tr><th width="180">Snowflake Object</th><th width="218">Snowflake Attribute</th><th width="174">OvalEdge Attribute</th><th width="175">OvalEdge Category</th><th width="170">OvalEdge Type</th></tr></thead><tbody><tr><td>Table</td><td>TABLE_NAME</td><td>Table</td><td>Tables</td><td>table</td></tr><tr><td>Table</td><td>table_type</td><td>Type</td><td>Tables</td><td>table</td></tr><tr><td>Table</td><td>comment</td><td>Source Description</td><td>Descriptions</td><td>Source Description</td></tr><tr><td>Columns</td><td>COLUMN_NAME</td><td>Column</td><td>Table Columns</td><td>-</td></tr><tr><td>Columns</td><td>data_type</td><td>Column Type</td><td>Table Columns</td><td>-</td></tr><tr><td>Columns</td><td>comment</td><td>Source Description</td><td>Table Columns</td><td>-</td></tr><tr><td>Columns</td><td>ordinal_position</td><td>Column Position</td><td>Table Columns</td><td>-</td></tr><tr><td>Columns</td><td>character_maximum_length/numeric_precision</td><td>Data Type Size</td><td>Table Columns</td><td>-</td></tr><tr><td>Views</td><td>name</td><td>View</td><td>Tables</td><td>view</td></tr><tr><td>Views</td><td>text</td><td>View Query</td><td>Views</td><td>View</td></tr><tr><td>Procedures</td><td>NAME</td><td>Name</td><td>Procedures</td><td>-</td></tr><tr><td>Procedures</td><td>COMMENT</td><td>Source Description</td><td>Descriptions</td><td>-</td></tr><tr><td>Procedures</td><td>body</td><td>Procedure</td><td>Procedures</td><td>-</td></tr><tr><td>Functions</td><td>NAME</td><td>Name</td><td>Functions</td><td>-</td></tr><tr><td>Functions</td><td>body</td><td>Function</td><td>Functions</td><td>-</td></tr><tr><td>Functions</td><td>COMMENT</td><td>Source Description</td><td>Descriptions</td><td>-</td></tr></tbody></table>

## Set up a Connection

### Prerequisites

The following are the prerequisites to establish a connection:

#### Whitelisting Ports

Make sure that inbound port “443” is whitelisted to enable successful connectivity with the Snowflake database.

{% hint style="warning" %}
The default port number for the Snowflake data source is 443. If a different port is used, ensure that the updated port number is specified during connection setup, the port is whitelisted, and communication between the system and Snowflake data source is properly established.
{% endhint %}

#### **Service Account User Permissions**

{% hint style="warning" %}
It is recommended to use a dedicated service account to establish the connection to the data source, configured with the following minimum set of permissions.
{% endhint %}

{% hint style="info" %}
**👨‍💻Who can provide these permissions?** These permissions are typically granted by the Snowflake administrator, as users may not have the required access to assign them independently.
{% endhint %}

<table><thead><tr><th width="196.6666259765625">Operation</th><th width="185.49993896484375">Objects</th><th width="289.3333740234375">Sys Tables</th><th width="196.6666259765625">Access Permissions</th></tr></thead><tbody><tr><td>Crawling</td><td>Databases</td><td>information_schema.schemata</td><td>USAGE</td></tr><tr><td>Crawling</td><td>Databases</td><td>SHOW DATABASES</td><td>USAGE</td></tr><tr><td>Crawling</td><td>Databases</td><td>SHOW DATABASES</td><td>USAGE</td></tr><tr><td>Crawling</td><td>Schemas</td><td>information_schema.schemata</td><td>USAGE</td></tr><tr><td>Crawling &#x26; Profiling</td><td>Tables</td><td>information_schema.tables</td><td>SELECT</td></tr><tr><td>Crawling &#x26; Profiling</td><td>Table Columns</td><td>information_schema.columns</td><td>SELECT</td></tr><tr><td>Crawling</td><td>Table Columns</td><td>SHOW PRIMARY KEYS</td><td>SELECT</td></tr><tr><td>Crawling, Profiling , &#x26; Lineage Building</td><td>Views</td><td>SHOW VIEWS IN SCHEMA</td><td>SELECT</td></tr><tr><td>Crawling, Profiling</td><td>Functions</td><td>SHOW USER FUNCTIONS IN SCHEMA</td><td>SELECT</td></tr><tr><td>Crawling, Profiling</td><td>Functions</td><td>DESC FUNCTION</td><td>SELECT</td></tr><tr><td>Crawling, Profiling , &#x26; Lineage Building</td><td>Stored Procedures</td><td>SHOW USER PROCEDURE IN SCHEMA</td><td>SELECT</td></tr><tr><td>Crawling, Profiling , &#x26; Lineage Building</td><td>Stored Procedures</td><td>DESC PROCEDURE</td><td>SELECT</td></tr><tr><td>Crawling</td><td>File Formats</td><td>SHOW FILE FORMATS IN DATABASE</td><td>SELECT</td></tr><tr><td>Crawling</td><td>Pipes</td><td>SHOW PIPES IN DATABASE</td><td>SELECT</td></tr><tr><td>Crawling</td><td>Tasks</td><td>SHOW TASKS IN DATABASE</td><td>SELECT</td></tr><tr><td>Crawling</td><td>Tasks</td><td>SHOW STREAMS IN DATABASE</td><td>SELECT</td></tr><tr><td>Crawling</td><td>Stages</td><td>SHOW STAGES IN SCHEMA</td><td>SELECT</td></tr><tr><td>Crawling</td><td>Stages</td><td>infromation_schema.STAGES</td><td>SELECT</td></tr><tr><td>Crawling</td><td>Column Relationships</td><td>SHOW IMPORTED KEYS</td><td>SELECT</td></tr></tbody></table>

### Connection Configuration Steps

{% hint style="warning" %}
Users are required to have the Connector Creator role in order to configure a new connection.
{% endhint %}

1. Log into **OvalEdge**, go to **Administration > Connectors**, click **+ (New Connector)**, search for **Snowflake**, and complete the required parameters.

{% hint style="info" %}
Fields marked with an asterisk (\*) are mandatory for establishing a connection.
{% endhint %}

<table><thead><tr><th width="220.25">Field Name</th><th>Description</th></tr></thead><tbody><tr><td>Connector Type</td><td>By default, "<strong>Snowflake</strong>" is displayed as the selected connector type.</td></tr><tr><td>Authentication</td><td><p>The following two types of authentication are supported for Snowflake:</p><ul><li>Username &#x26; Password</li><li>Key Pair Authentication</li></ul><p><strong>Note:</strong> If schemas do not appear during Crawl/Profile after successful connection validation using Key Pair Authentication, ensure the required JVM arguments are configured in the Tomcat setenv.sh file.</p></td></tr></tbody></table>

{% tabs %}
{% tab title="Username & Password" %}

<table><thead><tr><th width="200.25">Field Name</th><th>Description</th></tr></thead><tbody><tr><td>Credential Manager*</td><td><p>Select the desired credentials manager from the drop-down list. Relevant parameters will be displayed based on the selection.</p><p>Supported Credential Managers:</p><ul><li>OE Credential Manager</li><li>AWS Secrets Manager</li><li>HashiCorp</li><li>Azure Key Vault</li></ul><p>For more details, click <a href="https://docs.ovaledge.com/release8.1/connectors/additional-requirements/credential-manager-configuration">here</a>.</p></td></tr><tr><td>License Add Ons</td><td><ul><li>Select the checkbox for Auto Lineage Add-On to build data lineage automatically.</li><li>Select the checkbox for Data Quality Add-On to identify data quality issues using data quality rules and anomaly detection.</li><li>Select the checkbox for Data Access Add-On to enable the data access functionality.</li></ul><p>For more details, click <a href="https://docs.ovaledge.com/release8.1/connectors/introduction-to-connectors/setup-and-connectivity/license-types-and-add-ons">here</a>.</p></td></tr><tr><td>Connector Name*</td><td><p>Enter a unique name for the Snowflake connection              </p><p>(Example: "Snowflake_Prod").</p></td></tr><tr><td>Connector Environment</td><td>Select the environment (Example: PROD, STG) configured for the connector.<br>For more details, click <a href="https://docs.ovaledge.com/release8.1/connectors/introduction-to-connectors/setup-and-connectivity/prerequisites#connector-environment">here</a>.</td></tr><tr><td>Connector description</td><td>Enter a brief description of the connector.</td></tr><tr><td>Server*</td><td>Enter the Snowflake database server name or IP address (Example: xxxx-sxxxxxx.xxxx4ijtzasl.xx-south-1.rxs.xxxxx.com or 1xx.xxx.1.xx).</td></tr><tr><td>Port*</td><td>By default, the port number for the Snowflake, "433" is auto-populated. If required, the port number can be modified as per custom port number that is configured for the Snowflake.</td></tr><tr><td>Database</td><td>Enter the database name to which the service account user has access within the Snowflake.</td></tr><tr><td>Warehouse</td><td>Enter the Snowflake virtual warehouse to run queries and operations. Ensure the service account has the required usage permissions.</td></tr><tr><td>Role</td><td>Enter the Snowflake role assigned to the service account. This role governs access to metadata crawling, profiling, and lineage building.</td></tr><tr><td>Driver*</td><td>By default, the Snowflake driver details are auto-populated. </td></tr><tr><td>Source Code View</td><td>Provide the view in the format Database.Schema.View to enable source code access.</td></tr><tr><td>Username*</td><td>Enter the service account username set up to access the Snowflake database (Example: "<em>oesauser</em>").</td></tr><tr><td>Password*</td><td>Enter the password associated with the service account user.</td></tr><tr><td>Connection String</td><td><p>Configure the connection string for the Snowflake database:</p><ul><li><strong>Automatic Mode</strong>: The system generates a connection string based on the provided credentials.</li><li><strong>Manual Mode</strong>: Enter a valid connection string manually.</li></ul><p>Replace placeholders with actual database details.</p><p>{sid} refers to the database name</p></td></tr><tr><td>Plugin Server</td><td>Enter the server name when running as a plugin server.</td></tr><tr><td>Plugin Port</td><td>Enter the port number on which the plugin is running.</td></tr></tbody></table>
{% endtab %}

{% tab title="Key Pair Authentication" %}

<table><thead><tr><th width="199">Field Name</th><th>Description</th></tr></thead><tbody><tr><td>Key Pair Source*</td><td><p>Select the source of the private key used for Key Pair Authentication.</p><ul><li>Private Key File Path</li><li>Private Key Content</li></ul></td></tr><tr><td>Credential Manager*</td><td><p>Select the desired credentials manager from the drop-down list. Relevant parameters will be displayed based on the selection.</p><p>Supported Credential Managers:</p><ul><li>OE Credential Manager</li><li>AWS Secrets Manager</li><li>HashiCorp</li><li>Azure Key Vault</li></ul><p>For more details, click <a href="https://docs.ovaledge.com/connectors/additional-requirements/credential-manager-configuration">here</a>.</p></td></tr><tr><td>License Add Ons</td><td><ul><li>Select the checkbox for Auto Lineage Add-On to build data lineage automatically.</li><li>Select the checkbox for Data Quality Add-On to identify data quality issues using data quality rules and anomaly detection.</li><li>Select the checkbox for Data Access Add-On to enable the data access functionality.</li></ul><p>For more details, click <a href="https://docs.ovaledge.com/connectors/introduction-to-connectors/setup-and-connectivity/license-types-and-add-ons">here</a>.</p></td></tr><tr><td>Connector Name*</td><td><p>Enter a unique name for the Snowflake connection              </p><p>(Example: "Snowflake_Prod").</p></td></tr><tr><td>Connector Environment</td><td>Select the environment (Example: PROD, STG) configured for the connector.<br>For more details, click <a href="https://docs.ovaledge.com/connectors/introduction-to-connectors/setup-and-connectivity/prerequisites#connector-environment">here</a>.</td></tr><tr><td>Connector description</td><td>Enter a brief description of the connector.</td></tr><tr><td>Server*</td><td>Enter the Snowflake database server name or IP address (Example: xxxx-sxxxxxx.xxxx4ijtzasl.xx-south-1.rxs.xxxxx.com or 1xx.xxx.1.xx).</td></tr><tr><td>Port*</td><td>By default, the port number for the Snowflake, "433" is auto-populated. If required, the port number can be modified as per custom port number that is configured for the Snowflake.</td></tr><tr><td>Database</td><td>Enter the database name to which the service account user has access within the Snowflake.</td></tr><tr><td>Warehouse</td><td>Enter the Snowflake virtual warehouse to run queries and operations. Ensure the service account has the required usage permissions.</td></tr><tr><td>Role</td><td>Enter the Snowflake role assigned to the service account. This role governs access to metadata crawling, profiling, and lineage building.</td></tr><tr><td>Driver*</td><td>By default, the Snowflake driver details are auto-populated. </td></tr><tr><td>Source Code View</td><td>Provide the view in the format Database.Schema.View to enable source code access.</td></tr><tr><td>Username*</td><td>Enter the service account username set up to access the Snowflake database (Example: "<em>oesauser</em>").</td></tr><tr><td>Private Key file path*</td><td>Enter the full file path to the private key file used for Snowflake authentication. The private key file must be placed in the OE VM, container, or attached EFS so that the application can access it. Ensure the specified file path is valid and accessible from the connector environment.<br><strong>Note</strong>: This field appears only when the <strong>Key Pair Source</strong> is selected as <strong>Private Key File Path</strong>.</td></tr><tr><td>Private Key Content*</td><td>Enter the complete encrypted private key content used for Snowflake Key Pair Authentication. Ensure the full encrypted private key content is provided without modification.<br><strong>Note</strong>: This field appears only when the <strong>Key Pair Source</strong> is selected as <strong>Private Key Content</strong>.</td></tr><tr><td>Private key pass phrase*</td><td>Enter the pass phrase associated with the private key file. This is required if the private key is encrypted.</td></tr><tr><td>Connection String</td><td><p>Configure the connection string for the Snowflake database:</p><ul><li>Automatic Mode: The system generates a connection string based on the provided credentials.</li><li>Manual Mode: Enter a valid connection string manually.</li></ul><p>Replace placeholders with actual database details.</p><p>{sid} refers to the database name</p></td></tr><tr><td>Plugin Server</td><td>Enter the server name when running as a plugin server.</td></tr><tr><td>Plugin Port</td><td>Enter the port number on which the plugin is running.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

**Default Governance Roles**

<table data-header-hidden><thead><tr><th width="221.5"></th><th></th></tr></thead><tbody><tr><td>Default Governance Roles*</td><td>Select the appropriate users or teams for each governance role from the drop-down list. All users configured in the security settings are available for selection.</td></tr></tbody></table>

**Admin Roles**

<table data-header-hidden><thead><tr><th width="222.75"></th><th></th></tr></thead><tbody><tr><td>Admin Roles*</td><td>Select one or more users from the dropdown list for Integration Admin and Security &#x26; Governance Admin. All users configured in the security settings are available for selection.</td></tr></tbody></table>

**No of Archive Objects**

<table data-header-hidden><thead><tr><th width="222.75"></th><th></th></tr></thead><tbody><tr><td>No Of Archive Objects*</td><td><p>This shows the number of recent metadata changes to a dataset at the source. By default, it is off. To enable it, toggle the Archive button and specify the number of objects to archive.</p><p>Example: Setting it to 4 retrieves the last four changes, displayed in the 'Version' column of the 'Metadata Changes' module.</p></td></tr></tbody></table>

**Bridge**

<table data-header-hidden><thead><tr><th width="220.25"></th><th></th></tr></thead><tbody><tr><td>Select Bridge*</td><td><p>If applicable, select the bridge from the drop-down list.</p><p>The drop-down list displays all active bridges that have been configured. These bridges facilitate communication between data sources and the system without requiring changes to firewall rules.</p></td></tr></tbody></table>

2. After entering all connection details, the following actions can be performed:
   1. Click **Validate** to verify the connection.
   2. Click **Save** to store the connection for future use.
   3. Click **Save & Configure** to apply additional settings before saving.
3. The saved connection will appear on the Connectors home page.

## Manage Connector Operations

### Crawl/Profile

{% hint style="warning" %}
To perform crawl and profile operations, users must be assigned the Integration Admin role.
{% endhint %}

The **Crawl/Profile** button allows users to select one or more schemas for crawling and profiling.&#x20;

1. Navigate to the Connectors page and click **Crawl/Profile**.
2. Select the schemas to be crawled.
3. The **Crawl** option is selected by default. To perform both operations, select the **Crawl & Profile** radio button.
4. Click **Run** to collect metadata from the connected source and load it into the **Data Catalog**.
5. After a successful crawl, the information appears in the **Data Catalog > Databases** tab.

The Schedule checkbox allows automated crawling and profiling at defined intervals, from a minute to a year.

1. Click the **Schedule** checkbox to enable the Select Period drop-down.
2. Select a time interval for the operation from the **drop-down menu**.
3. Click **Schedule** to initiate metadata collection from the connected source.
4. The system will automatically execute the selected operation (**Crawl** or **Crawl & Profile**) at the scheduled time.

#### Other Operations

The Connectors page provides a centralized view of all configured connectors, along with their health status.

**Managing connectors includes:**

* **Connectors Health:** Displays the current status of each connector using a **green** icon for active connections and a **red** icon for inactive connections, helping to monitor the connectivity with data sources.
* **Viewing**: Click the **Eye icon** next to the connector name to view connector details, including databases, tables, columns, and codes.

**Nine Dots Menu Options:**

To view, edit, validate, build lineage, configure, or delete connectors, click on the **Nine Dots** menu.

* **Edit Connector:** Update and revalidate the data source.
* **Validate Connector:** Check the connection's integrity.
* **Settings**: Modify connector settings.
  * **Crawler**: Configure data extraction.
  * **Profiler**: Customize data profiling rules and methods.
  * **Query Policies**: Define query execution rules based on roles.
  * **Access Instructions**: Add notes on how data can be accessed.
  * **Business Glossary Settings:** Manage term associations at the connector level.
  * **Anomaly Detection Settings:** Configure anomaly detection preferences at the connector level.
  * **Others**: Configure notification recipients for metadata changes.
* **Build Lineage**: Automatically build data lineage using source code parsing.
* **Delete Connector**: Remove a connector with confirmation.

For more details on connector settings, click [here](https://docs.ovaledge.com/release8.1/connectors/introduction-to-connectors/setup-and-connectivity/connector-settings).

## **Limitations** <a href="#connectivity-troubleshooting" id="connectivity-troubleshooting"></a>

<table><thead><tr><th width="89">S. No.</th><th width="99">Feature</th><th>Limitation</th></tr></thead><tbody><tr><td>1</td><td>Profiling</td><td>OvalEdge does not support profiling of Snowflake views that contain variables. Views using variables may be skipped during profiling, and the profiling job may complete with a <strong>Partial Success</strong> status.</td></tr></tbody></table>

## **Connectivity Troubleshooting** <a href="#connectivity-troubleshooting" id="connectivity-troubleshooting"></a>

If incorrect parameters are entered, error messages may appear. Ensure all inputs are accurate to resolve these issues. If issues persist, contact the assigned support team.

<table><thead><tr><th width="83" align="center">S. No</th><th width="232">Error Message</th><th>Error Description &#x26; Resolution</th></tr></thead><tbody><tr><td align="center"><strong>1</strong></td><td><strong>Schemas are not displayed during Crawl/Profile when using Key Pair Authentication</strong></td><td><p>Connection validation succeeds, but no schemas appear in the Crawl/Profile screen due to JVM access restrictions affecting the Snowflake JDBC driver (Apache Arrow initialization).</p><p><strong>Resolution:</strong> </p><ul><li><p>Add the following JVM arguments in the Tomcat setenv.sh file and restart the application services:</p><ul><li>--add-opens=java.base/java.nio=ALL-UNNAMED</li><li>--add-opens=java.base/sun.nio.ch=ALL-UNNAMED</li></ul></li></ul></td></tr><tr><td align="center"><strong>2</strong></td><td><strong>Unable to read encrypted data: Error finalizing the cipher</strong></td><td><p>This error occurs when validating a Snowflake connection using <strong>Key Pair Authentication</strong> if the encrypted private key cannot be decrypted. The most common causes are a missing or incorrect private key passphrase, an invalid or corrupted <code>.p8</code> private key file, or a mismatch between the encrypted private key and the configured passphrase.</p><p><strong>Resolution:</strong></p><ul><li>Verify that the selected private key file is valid and accessible from the configured path.</li><li>If the private key is encrypted, ensure the correct <strong>Private Key Pass Phrase</strong> is provided in the connector configuration.</li><li>Validate that the private key can be successfully decrypted using OpenSSL or an equivalent tool.</li><li>If the key file is corrupted or invalid, regenerate the encrypted private key and update the connector configuration with the new key and its corresponding passphrase.</li><li>After updating the configuration, validate the connection again. Once the connection is validated successfully, crawl and profile operations should complete normally.</li></ul></td></tr><tr><td align="center"><strong>3</strong></td><td><strong>Authentication failed</strong></td><td><p>Indicates invalid authentication credentials or authentication configuration.</p><p><strong>Resolution:</strong></p><ul><li>Verify the username, password, or Key Pair Authentication details.</li><li>Ensure the private key path and passphrase (if applicable) are correct.</li><li>Confirm the Snowflake user account is active and not locked.</li></ul></td></tr><tr><td align="center"><strong>4</strong></td><td><strong>Communications link failure</strong> / <strong>Connection refused</strong></td><td><p>Indicates that the application cannot establish a network connection to the Snowflake server.</p><p><strong>Resolution:</strong></p><ul><li>Verify the server hostname and port (default <strong>443</strong>).</li><li>Ensure firewall or proxy settings allow outbound HTTPS connections.</li><li>Confirm the Snowflake account is reachable from the application server.</li></ul></td></tr><tr><td align="center"><strong>5</strong></td><td><strong>Invalid number format for port number</strong></td><td><p>Indicates that the configured port value is invalid.</p><p><strong>Resolution:</strong></p><ul><li>Enter a valid numeric port value (typically <strong>443</strong>).</li><li>Remove any spaces or non-numeric characters.</li><li>Verify the configured port matches your Snowflake environment.</li></ul></td></tr><tr><td align="center"><strong>6</strong></td><td><strong>Database does not exist</strong></td><td><p>Indicates that the specified database name is incorrect or inaccessible.</p><p><strong>Resolution:</strong></p><ul><li>Verify the configured database name is correct.</li><li>Ensure the user has <strong>USAGE</strong> privilege on the database.</li><li>Confirm the database exists using <code>SHOW DATABASES</code>.</li></ul></td></tr><tr><td align="center"><strong>7</strong></td><td><strong>Failed to retrieve DataSource from DataSourceProvider</strong></td><td><p>Indicates that the JDBC datasource or connection pool could not be initialized.</p><p><strong>Resolution:</strong></p><ul><li>Verify the JDBC connection details and driver configuration.</li><li>Confirm the Warehouse and Role values are valid.</li><li>Recreate the connection if cached connection pool information is corrupted.</li></ul></td></tr><tr><td align="center"><strong>8</strong></td><td><strong>Unable to view databases, schemas, tables, or views</strong></td><td><p>Usually caused by insufficient privileges or inaccessible warehouse resources.</p><p><strong>Resolution:</strong></p><ul><li>Ensure the user has <strong>USAGE</strong> privileges on the required databases and schemas.</li><li>Verify <strong>SELECT</strong> access to metadata objects and required tables/views.</li><li>Confirm the configured Warehouse is active and accessible.</li></ul></td></tr><tr><td align="center"><strong>9</strong></td><td><strong>Some columns are missing</strong> / <strong>Unsupported Data Type for Profile</strong></td><td><p>Certain Snowflake data types are excluded from profiling or require additional permissions.</p><p><strong>Resolution:</strong></p><ul><li>Verify the user has <strong>SELECT</strong> permission on the table.</li><li>Note that data types such as <strong>BINARY, VARBINARY, OBJECT, and ARRAY</strong> are not profiled.</li><li>Review the column data type before running profiling.</li></ul></td></tr><tr><td align="center"><strong>10</strong></td><td><strong>Stored procedures or functions are not retrieved</strong></td><td><p>Indicates missing permissions or unavailable procedure definitions.</p><p><strong>Resolution:</strong></p><ul><li>Ensure the user has access to <strong>INFORMATION_SCHEMA.PROCEDURES</strong>.</li><li>Verify <strong>USAGE</strong> privileges on the database and schema.</li><li>Confirm the procedure definition is available in Snowflake metadata.</li></ul></td></tr><tr><td align="center"><strong>11</strong></td><td><strong>Indexes are not fetched</strong></td><td><p>Index metadata retrieval is disabled or required metadata is unavailable.</p><p><strong>Resolution:</strong></p><ul><li>Enable <strong>Indexes</strong> in the crawler configuration.</li><li>Verify the required metadata permissions.</li><li>Note that Snowflake primarily uses clustering rather than traditional indexes.</li></ul></td></tr><tr><td align="center"><strong>12</strong></td><td><strong>Row count is 0</strong> / <strong>Could not profile table. No Data found</strong></td><td><p>Indicates that profiling queries returned no usable data or that required permissions are missing.</p><p><strong>Resolution:</strong></p><ul><li>Verify the table contains data.</li><li>Ensure <strong>SELECT</strong> permission is available on the table.</li><li>Confirm the Warehouse is active before running profiling.</li></ul></td></tr><tr><td align="center"><strong>13</strong></td><td><strong>Query execution failed</strong></td><td><p>Indicates that the SQL statement could not be executed successfully.</p><p><strong>Resolution:</strong></p><ul><li>Review the complete SQL error message in the application logs.</li><li>Verify object names, SQL syntax, and required permissions.</li><li>Execute the same query directly in Snowflake to validate the result.</li></ul></td></tr><tr><td align="center"><strong>14</strong></td><td><strong>Sample profiling is slow or times out</strong></td><td><p>Indicates insufficient compute resources or large profiling workloads.</p><p><strong>Resolution:</strong></p><ul><li>Reduce the configured profiling sample size.</li><li>Use a larger Warehouse or profile during off-peak hours.</li><li>Verify network connectivity and Warehouse performance.</li></ul></td></tr><tr><td align="center"><strong>15</strong></td><td><strong>Connection pool errors</strong></td><td><p>Indicates exhausted, stale, or improperly managed JDBC connections.</p><p><strong>Resolution:</strong></p><ul><li>Review the configured connection pool size.</li><li>Restart the application to clear stale connections if required.</li><li>Ensure the Warehouse remains active throughout execution.</li></ul></td></tr><tr><td align="center"><strong>16</strong></td><td><strong>Credential Manager authentication failed</strong></td><td><p>Indicates that credentials could not be retrieved from the configured secret store.</p><p><strong>Resolution:</strong></p><ul><li>Verify the selected Credential Manager type and secret name.</li><li>Ensure the secret contains all required authentication values.</li><li>Confirm the application has permission to access the secret.</li></ul></td></tr><tr><td align="center"><strong>17</strong></td><td><strong>Key Pair Authentication failed</strong></td><td><p>Indicates an invalid private key configuration or missing public key registration.</p><p><strong>Resolution:</strong></p><ul><li>Verify the private key file path, format (PEM), and passphrase.</li><li>Ensure the corresponding public key is registered for the Snowflake user.</li><li>Validate the key independently using SnowSQL or OpenSSL.</li></ul></td></tr><tr><td align="center"><strong>18</strong></td><td><strong>No active warehouse selected in the current session</strong></td><td><p>Indicates that the configured Warehouse is unavailable or suspended.</p><p><strong>Resolution:</strong></p><ul><li>Verify the configured Warehouse name.</li><li>Resume the Warehouse if it is suspended.</li><li>Ensure the user has <strong>USAGE</strong> privilege on the Warehouse.</li></ul></td></tr><tr><td align="center"><strong>19</strong></td><td><strong>Query logs are not retrieved</strong></td><td><p>Indicates insufficient privileges to access Snowflake query history.</p><p><strong>Resolution:</strong></p><ul><li>Grant access to the required query history views.</li><li>Verify the configured role has the necessary privileges.</li><li>Allow time for newly executed queries to appear in query history.</li></ul></td></tr><tr><td align="center"><strong>20</strong></td><td><strong>Error while validateConnection: unable to read encrypted dataError while validateConnection: Invalid Base64 characters</strong></td><td><p>Indicates that the private key file is corrupted, incorrectly encoded, or cannot be decrypted.</p><p><strong>Resolution:</strong></p><ul><li>Verify that the private key file is valid and not corrupted.</li><li>Confirm the correct passphrase is provided for encrypted keys.</li><li>Validate the key using OpenSSL before configuring the connector.</li></ul></td></tr></tbody></table>

## FAQs

<details>

<summary>What is the difference between a database and a schema in Snowflake?</summary>

A database is the top-level container, while schemas organize objects within a database. The connector expects the database name during configuration and discovers schemas within that database.

</details>

<details>

<summary>Why does the connection string change automatically?</summary>

The connector automatically generates the JDBC connection string based on the configured connection properties. This behavior is expected and should not be modified manually unless required.

</details>

<details>

<summary>Why is the nullable status of a column displayed incorrectly?</summary>

The connector reads the nullable property from `INFORMATION_SCHEMA.COLUMNS`. If the metadata returned by Snowflake is incorrect or unavailable, verify the source metadata and connector compatibility.

</details>

<details>

<summary>How do I configure Credential Manager authentication?</summary>

Select the appropriate Credential Manager type, provide the secret name or path, and ensure the secret contains the required authentication details and is accessible to the application.

</details>

<details>

<summary>Why are query log filters not returning the expected results?</summary>

Verify the configured time range, query types, and excluded users. Also note that Snowflake query history may not reflect recently executed queries immediately.

</details>

<details>

<summary>Why do some connector operations succeed while others fail?</summary>

Different connector operations require different Snowflake privileges. A user may have sufficient permissions for metadata discovery but not for profiling, query execution, or query history retrieval.

</details>

<details>

<summary>The connection works in Snowflake, but not in the connector. Why?</summary>

The Snowflake web interface and JDBC connections may use different authentication methods, default roles, warehouses, or network paths. Verify that the connector configuration matches the Snowflake environment.

</details>

<details>

<summary>What are the recommended Snowflake privileges for the connector?</summary>

Grant only the minimum required privileges, including **USAGE** on databases, schemas, and warehouses, along with **SELECT** permissions on the required objects and metadata views.

</details>

<details>

<summary>How can I verify that the connector is configured correctly?</summary>

Validate the connection, confirm databases, schemas, and tables are visible, execute a simple query, verify row counts, and ensure the configured Warehouse is active.

</details>

<details>

<summary>Which Snowflake versions are supported?</summary>

The connector supports all current Snowflake editions and cloud deployments that are compatible with the supported Snowflake JDBC driver version.

</details>

***

Copyright © 2026, OvalEdge LLC, Peachtree Corners GA USA


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ovaledge.com/release8.1/connectors/connector-repositories/data-warehouse/snowflake.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.