View a markdown version of this page

STV_XRESTORE_ALTER_QUEUE_STATE - Amazon Redshift
Table columnsSample query

Amazon Redshift will no longer support the use of Python UDFs after June 30, 2026. We will start enforcing it in phases. For more information on the details of Python end of life and migration options, see the blog post that was published on June 30, 2025.

STV_XRESTORE_ALTER_QUEUE_STATE

Use STV_XRESTORE_ALTER_QUEUE_STATE to monitor the migration progress of each table during a classic resize. This is specifically applicable when the target node type is RG or RA3. For more information about classic resize to RG or RA3 nodes, go to Classic resize.

STV_XRESTORE_ALTER_QUEUE_STATE is visible only to superusers. For more information, see Visibility of data in system tables and views.

Some or all of the data in this table can also be found in the SYS monitoring view SYS_RESTORE_STATE. The data in the SYS monitoring view is formatted to be easier to use and understand. We recommend that you use the SYS monitoring view for your queries.

Table columns

Column name Data type Description
userid integer The ID of the user who initiated the resize.
db_id integer The ID of the database.
schema char(128) The name of the schema.
table_name char(128) The name of the table.
tbl integer The ID of the table.
status char(64) The status of the migration progress of the table. Possible values are as follows.

  • Waiting: Waiting for redistribution to start

  • Applying: Currently redistributing

  • Finished: Finished redistributing
task_type integer The redistribution type for the table. Possible values are as follows.

  • 1: KEY

  • 2: EVEN

For more information about distribution styles, see Distribution styles.

Sample query

The following query shows the number of tables in a database that are waiting to be resized, are currently being resized, and are finished resizing.

select db_id, status, count(*) 
from stv_xrestore_alter_queue_state 
group by 1,2 order by 3 desc

db_id  |   status   | count
-------+------------+------
694325 | Waiting    |   323
694325 | Finished   |    60
694325 | Applying   |     1