Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

SYS_UNLOAD_DETAIL

Focus mode
SYS_UNLOAD_DETAIL - Amazon Redshift

Use SYS_UNLOAD_DETAIL to view details of an UNLOAD operation. It records one row for each file created by an UNLOAD statement. For example, if an UNLOAD creates 12 files, SYS_UNLOAD_DETAIL will contain 12 corresponding rows.

SYS_UNLOAD_DETAIL is visible to all users. Superusers can see all rows; regular users can see only their own data. For more information, see Visibility of data in system tables and views.

Table columns

Column name Data type Description
user_id integer The identifier of the user who generated the entry.
query_id integer The query identifier of the UNLOAD command.
session_id integer The ID of the process associated with the query statement.
transaction_id bigint The ID of the transaction associated with the query statement.
file_name character (1280) The complete Amazon S3 object path for the file.
start_time timestamp The time when the transaction began.
end_time timestamp The time when the transaction completed.
line_count bigint The number of lines (rows) unloaded to the file.
transfer_size bigint The number of bytes transferred.
file_format character (10) The file format of the unloaded files.

Sample queries

The following query shows the unloaded query details, including format, rows, and file count of unload command.

select query_id, substring(file_name, 0, 50), transfer_size, file_format from sys_unload_detail;

Sample output.

query_id | substring | transfer_size | file_format ----------+-------------------------------------------------------------+---------------+------------- 9272 | s3://amzn-s3-demo-bucket/my_unload_doc_venue0000_part_00.gz | 395886 | Text 9272 | s3://amzn-s3-demo-bucket/my_unload_doc_venue0001_part_00.gz | 406444 | Text 9272 | s3://amzn-s3-demo-bucket/my_unload_doc_venue0002_part_00.gz | 409431 | Text 9272 | s3://amzn-s3-demo-bucket/my_unload_doc_venue0003_part_00.gz | 403051 | Text 9272 | s3://amzn-s3-demo-bucket/my_unload_doc_venue0004_part_00.gz | 413592 | Text 9272 | s3://amzn-s3-demo-bucket/my_unload_doc_venue0005_part_00.gz | 395689 | Text (6 rows)

On this page

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.