> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/integrations-and-plugins/integrations/snowflake/troubleshoot-snowflake.md).

# Troubleshoot Snowflake

{% hint style="success" %}
**Audience:** Admins, Developers, Solution Architects

**Purpose:** Describes troubleshooting methods for issues with the Snowflake integration
{% endhint %}

The following table presents solutions to common issues with the Snowflake integration. For additional help, see the [Snowflake documentation](https://docs.snowflake.com/).

<table data-search="false"><thead><tr><th>Issue</th><th>Cause</th><th>What to do</th></tr></thead><tbody><tr><td>Your Snowflake connection failed.</td><td>The integration is misconfigured.</td><td>Check your configuration. Confirm that you have allowlisted <code class="expression">space.vars.Kizen_company_name</code>'s egress IP addresses.</td></tr><tr><td>You received an error message that reads: <code>Error while using Snowflake Plugin</code>.</td><td>You have bad Snowflake credentials or an invalid query.</td><td>Review the error message for more details. Update your integration secret or query, and retry.</td></tr><tr><td>You received an error message that reads: <code>Error decoding JSON</code>.</td><td>Your integration secret isn't valid JSON.</td><td>Update your integration secret.</td></tr><tr><td>You received an error message that reads: <code>Expected a single value result, but the query returned multiple rows or columns</code>.</td><td>The Return Single Value script input of the Read Data action is true, but the query selected more than one row or column.</td><td>Adjust your query to select exactly one value.</td></tr><tr><td>You received the HTTP 401 Unauthorized status code.</td><td>Your PAT is bad or expired.</td><td>Generate a new PAT.</td></tr><tr><td>You received the HTTP 403 Forbidden status code.</td><td>Your user or service account has insufficient privileges.</td><td>Review the privileges, and assign the necessary ones.</td></tr><tr><td>You received the HTTP 404 Not Found status code.</td><td>Your Snowflake account isn't valid.</td><td>Confirm your Snowflake account.</td></tr><tr><td>You received the HTTP 429 Too Many Requests status code.</td><td>Your request exceeded Snowflake's rate limits.</td><td>Try again after the limit clears. To avoid this error in the future, reduce how often the <code class="expression">space.vars.automation</code> runs, narrow results with <code>LIMIT</code>, or combine multiple lookups into a single query.</td></tr><tr><td>You received an empty string.</td><td>The query ran successfully but matched no rows.</td><td>This is expected behavior. An empty result returns <code>""</code>, not null.</td></tr><tr><td>Your result string is truncated.</td><td>The result set is larger than 5 MB.</td><td>Target your query with <code>LIMIT</code>.</td></tr></tbody></table>

***

## What's Next

For details on reviewing your Snowflake configuration and integration secret, see [Enable Snowflake in Kizen](/docs/integrations-and-plugins/integrations/snowflake/enable-snowflake-in-kizen.md). To access your database query, see [Add Snowflake Data to an Agentic Workflow](/docs/integrations-and-plugins/integrations/snowflake/add-snowflake-data-to-an-agentic-workflow.md).

<details>

<summary><strong>Related Topics</strong></summary>

* [Snowflake](/docs/integrations-and-plugins/integrations/snowflake.md)
* [Enable Snowflake in Kizen](/docs/integrations-and-plugins/integrations/snowflake/enable-snowflake-in-kizen.md)
* [Add Snowflake Data to an Agentic Workflow](/docs/integrations-and-plugins/integrations/snowflake/add-snowflake-data-to-an-agentic-workflow.md)

</details>

***

*Snowflake and all other Snowflake product, feature, and service names mentioned herein are registered trademarks or trademarks of Snowflake Inc. in the United States and other countries. Kizen's Snowflake integration is not affiliated with, sponsored by, or endorsed by Snowflake Inc.*


---

# 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://developer.kizen.com/docs/integrations-and-plugins/integrations/snowflake/troubleshoot-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.