STV_XRESTORE_ALTER_QUEUE_STATE - Amazon Redshift
Table columnsSample query
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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 RA3. For more information about classic resize to 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