# Modify Snowflake warehouse

You can use the **Modify Snowflake warehouse** job entry to change the settings of an existing Snowflake virtual warehouse.

Modifying a warehouse is useful when usage patterns change throughout the day, week, month, or year. For example, you might scale up the warehouse during ETL processing to meet service-level agreements (SLAs), then scale it back down when the ETL completes.

For more information about working with Snowflake in PDI, see [PDI and Snowflake](/pdia-data-integration/extracting-data-into-pdi/pdi-and-snowflake-cp.md).

For more information about Snowflake warehouse settings, see the [Snowflake documentation](https://docs.snowflake.com/).

### General

* **Entry name**: Specify the unique name of the Modify Snowflake warehouse entry on the canvas. You can customize the name or leave it as the default.

### Options

The **Modify Snowflake warehouse** entry includes options for selecting a warehouse and changing warehouse attributes.

![Modify Snowflake warehouse](/files/SdRaTMfCHxFLdK52u4fR)

#### Database connection and warehouse

Specify the Snowflake database connection and identify the virtual warehouse you want to modify.

| Option                        | Description                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Database connection**       | <p>Select an existing Snowflake connection. If you do not have an existing connection, click <strong>New</strong>. If you need to modify an existing connection, click <strong>Edit</strong>.</p><p><strong>Note:</strong> If timeout errors occur, see <a href="/spaces/YwnJ6Fexn4LZwKRHghPK/pages/iQuisDXs4kfQKWZQH1Iy">Snowflake timeout errors</a>.</p> |
| **Use default warehouse**     | Select to use the Snowflake default warehouse identified in the **Database connection**.                                                                                                                                                                                                                                                                    |
| **Use an existing warehouse** | Select to use a warehouse other than the default one. Choose the warehouse name from the list.                                                                                                                                                                                                                                                              |

#### Warehouse settings

You can resize a warehouse at any time, even while it is running.

The **Auto suspend (in seconds)** setting helps ensure that an inactive warehouse stops consuming credits. The **Auto resume warehouse** setting controls whether the warehouse starts automatically when needed.

| Option                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Warehouse size**            | <p>Select a size for this virtual warehouse:</p><ul><li><strong>X-Small</strong> (default)</li><li><strong>Small</strong></li><li><strong>Medium</strong></li><li><strong>Large</strong></li><li><strong>X-Large</strong></li><li><strong>2X-Large</strong></li><li><strong>3X-Large</strong></li><li><strong>4X-Large</strong></li></ul><p><strong>Important:</strong> The size affects the number of servers in each cluster and the number of credits consumed while the warehouse is running.</p> |
| **Scaling policy**            | <p>Select the policy for automatically starting and shutting down clusters in a multi-cluster warehouse running in auto-scale mode:</p><ul><li><strong>Standard</strong></li><li><strong>Economy</strong></li></ul>                                                                                                                                                                                                                                                                                   |
| **Auto suspend (in seconds)** | <p>Specify the time (in seconds) for the warehouse to auto-suspend when it becomes inactive. The default is 600 seconds (10 minutes).</p><p>You must specify a value of 60 or greater.</p><p><strong>Important:</strong> If you leave this option blank, the warehouse never suspends. Leave this option blank only if your workload requires a continually running warehouse.</p>                                                                                                                    |
| **Resource monitor**          | <p>Select an existing resource monitor to assign to this warehouse. The default is blank (no monitor).</p><p><strong>Note:</strong> A resource monitor is a permissions-based control that governs monthly credits used by this warehouse and any other warehouses that share the monitor.</p>                                                                                                                                                                                                        |
| **Auto resume warehouse**     | <p>Specify whether to automatically resume the warehouse when a SQL statement is submitted.</p><ul><li>Cleared (default): the warehouse resumes only when you use the <a href="/spaces/YwnJ6Fexn4LZwKRHghPK/pages/Fbg9EQz75SuOYylTkSit">Start Snowflake warehouse</a> job entry.</li><li>Selected: the warehouse resumes automatically when a new query is submitted.</li></ul>                                                                                                                       |

#### Cluster settings

The minimum and maximum cluster settings work together:

* If the minimum and maximum cluster count are the same, the warehouse runs in **Maximized** mode.
* If the minimum cluster count is less than the maximum cluster count, the warehouse runs in **Auto-scale** mode.

| Option                    | Description                                                                                                                                                   |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Minimum cluster count** | Select the minimum number of server clusters. Valid values are 1 to 10. The default is 1. This value must be less than or equal to **Maximum cluster count**. |
| **Maximum cluster count** | Select the maximum number of server clusters. Valid values are 1 to 10. The default is 1. Higher values require Snowflake Enterprise Edition.                 |

#### Activity settings

This setting controls what happens if the job requests a Snowflake warehouse that does not exist.

| Option                              | Description                                                                                                                                                                                          |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fail if warehouse doesn't exist** | <p>Specify how the job should behave if the requested warehouse does not exist:</p><ul><li>Selected (default): fail the job.</li><li>Cleared: continue the job and move to the next entry.</li></ul> |


---

# Agent Instructions: 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:

```
GET https://docs.pentaho.com/pdia-data-integration/pdi-job-entries-reference-overview/modify-warehouse-pdi-job-entry.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
