Warehouse Settings

Use Warehouse Settings to manage a warehouse after it is created, including its name, maintenance window, security controls, and deletion. Some settings are available only for SaaS or BYOC warehouses and may vary by cloud platform.

To open the Warehouse Settings page:

1. Log in to the VeloDB Cloud console.
2. In the upper-left corner, select the warehouse that you want to use.
3. In the left navigation pane, under MORE, click Warehouse Settings.

Switch the active warehouse

Use the warehouse selector in the upper-left corner to switch the active warehouse.

The selector lists the warehouses you can access. For each warehouse, it shows the name, status, and warehouse ID. Click Copy to copy the ID.

Use the search box to find a warehouse, then click its name to switch to it. Click All Warehouses to open the warehouse list, or click Create New Warehouse to create one.

Note:

A warehouse ID contains 8 characters. The first 4 identify the cloud platform and region, for example, AWVA for AWS US East (N. Virginia). The final 4 characters are a random alphanumeric suffix.

General

Rename the warehouse

You can rename the warehouse while it is Running. Renaming only updates the warehouse name and does not affect normal warehouse operation. This applies to both SaaS and BYOC warehouses.

Renaming does not change the warehouse's running status or stop or restart its compute clusters. Existing connections, queries, and data ingestion continue normally. The warehouse ID and connection endpoints stay the same, so you do not need to change application connection strings.

To edit the name, you need write access to the warehouse, and its status must be Running or Stopped. The new name must be unique within the organization and contain no more than 32 characters. Use only letters, numbers, Chinese characters, underscores (_), and hyphens (-).

1. In Warehouse Settings > General, find Warehouse Name and click the edit icon.
2. Enter the new name, then press Enter to save it.
3. Verify that the new name appears in the warehouse selector.

The name update is synchronized in the background after you save it.

If your own scripts or automation look up warehouses by name, update those references to use the new name.

Manage custom tags

For BYOC warehouses, you can view, add, or update custom tags to organize and identify cloud resources in your own cloud account.

In General, find Tags, then click Manage Tags to open the Custom Tags drawer.

When you add a tag, select one of the following scopes:

Scope	Description
Warehouse and Clusters	Applies the tag to both warehouse-level resources and cluster resources.
Cluster	Applies the tag only to the selected cluster resources.

Enter the Tag Key and Tag Value, then click Confirm.

Note:

• You can add up to 40 custom tags.
• If a tag with the same key already exists on the cloud platform, the new value overwrites the existing value.
• Some tags are generated by VeloDB Cloud. Do not modify or delete system-generated tags on the cloud platform.

Maintenance

Upgrade the core version

The Version Upgrade section shows the warehouse's current core version. Click Upgrade to open Upgrades, where you can review Available Versions, schedule or reschedule an upgrade, and view History.

For upgrade details, see Upgrade Core Version.

Configure the maintenance window

The maintenance window is a weekly time period during which scheduled updates start. Choose an off-peak period for the applications that use the warehouse. An update may continue after the window ends.

1. In Maintenance, click the Edit icon in the Maintenance Window section.
2. Select Day of the week, Start time, and Window duration. The time is displayed in your browser's local time zone. Check the UTC offset shown next to Maintenance Window.
3. Click Save Changes.

If the window shows Not configured, configure it before scheduling an upgrade for the next maintenance window. You can also click Set up in the upgrade scheduling dialog.

Changing the maintenance window does not change updates that are already scheduled. To use the new window, click Reschedule for the affected update: open Upgrade for core version upgrades, or View Updates under OS Updates for OS updates. See Change or cancel a scheduled upgrade for core version upgrade instructions.

Manage OS updates

OS updates apply security fixes to operating system packages separately from VeloDB Core upgrades. This feature is in Private Preview. For enablement, scheduling, cancellation, and history, see OS Updates.

Manage insights and diagnostics

Use Insights & diagnostics to manage data used to monitor warehouse health, troubleshoot issues, and power Advisor recommendations.

Item	Description
Metrics	Warehouse health, resource usage, runtime counters, and availability signals. Metrics are required for reliability and support.
Logs	Diagnostic logs for failed jobs, service errors, ingestion issues, and performance troubleshooting.
AI Assistant	Documentation Q&A and slow SQL / query analysis diagnostics for the warehouse.

Use the toggles in this section to manage optional diagnostic data. Required items cannot be disabled.

Security

Change the warehouse admin password

The Warehouse Admin Password is the password for the admin database user. Database clients and applications use it to connect to the warehouse. It is different from your VeloDB Cloud console account password.

Click Change Password to set or reset it.

Note:

The password must be 8-20 characters. It can contain letters, numbers, and the special characters ~!@#$%^&*()_+{}[]:;<>,.?-.

Configure the public IP allowlist

The Public IP Allowlist controls which source public IP addresses can use the public access path. For SaaS warehouses, it controls public warehouse connections and console data-plane operations. For BYOC warehouses, it controls console data-plane operations, not direct warehouse connections through your cloud network.

Click Edit IP Allowlist, and then select an option under Allow public access to this warehouse from:

Option	Behavior
Any IP address	Allows the public access path from any source IP address.
No public access	Blocks the public access path.
Specific IP addresses	Allows only the IP addresses or CIDR blocks that you enter.

Click Save changes, and wait for the new policy to take effect before testing connections.

Warning:

Any IP address exposes the public access path to all source IP addresses. Use Specific IP addresses whenever possible.

For public access setup, see Public Endpoint for SaaS warehouses or Connect to a BYOC Warehouse for BYOC warehouses.

For encryption settings, see Warehouse Encryption.

Delete the warehouse

Delete the warehouse only when you no longer need it. You must remove its clusters before deletion. Deleting a warehouse permanently removes its data and cannot be undone. For a BYOC warehouse, complete the required cloud infrastructure teardown after deletion.

For the deletion procedure and BYOC infrastructure teardown, see Delete a Warehouse.

See also

• Upgrade Core Version: schedule core version upgrades and review upgrade history.
• Warehouse Encryption: manage warehouse encryption and customer-managed keys.
• Create BYOC Warehouses: create a BYOC warehouse and add custom tags during creation.