从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://www.amazonaws.cn/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。
# SVCS\_S3QUERY\_SUMMARY
可以使用 SVCS\_S3QUERY\_SUMMARY 视图获取已在系统上运行的所有 Redshift Spectrum 查询（S3 查询）的摘要。一个段可以执行一个外部表扫描。
**注意**
带有前缀 SVCS 的系统视图提供了有关主集群和并发扩展集群上的查询的详细信息。这些视图与带有前缀 SVL 的视图类似，但 SVL 视图仅提供在主集群上运行的查询的信息。
SVCS\_S3QUERY\_SUMMARY 对所有用户可见。超级用户可以查看所有行；普通用户只能查看其自己的数据。有关更多信息，请参阅 [系统表和视图中的数据可见性](cm_chap_system-tables.md#c_visibility-of-data)。
有关 SVL\_S3QUERY 的信息，请参阅 [SVL\_S3QUERY](r_SVL_S3QUERY.md)。
## 表列
| 列名称 | 数据类型 | 描述 |
| --- | --- | --- |
| userid | integer | 已生成给定条目的用户的 ID。 |
| query | integer | 查询 ID。您可以使用此值联接各种其他系统表和视图。 |
| xid | bigint | 事务 ID。 |
| pid | integer | 进程 ID。 |
| segment | integer | 段编号。一个查询包含多个区段，而且每个区段包含一个或多个步骤。 |
| step | integer | 运行的查询步骤。 |
| starttime | timestamp | 开始运行该段中的 Redshift Spectrum 查询的 UTC 时间。一个段可以具有一个外部表扫描。 |
| endtime | timestamp | 完成该段中的 Redshift Spectrum 查询的 UTC 时间。一个段可以具有一个外部表扫描。 |
| elapsed | integer | 运行该段中的 Redshift Spectrum 查询所需的时间长度（以微秒为单位）。 |
| aborted | integer | 如果查询已由系统停止或已由用户取消，则此列包含 1。如果查询运行完成，则此列包含 0。 |
| external\_table\_name | char(136) | 外部表扫描的表的外部名称的名称内部格式。 |
| file\_format | character(16) | 外部表数据的文件格式。 |
| is\_partitioned | char(1) | 如果为 true (t)，则此列值表示外部表已进行分区。 |
| is\_rrscan | char(1) | 如果为 true (t)，则此列值表示已应用限制范围的扫描。 |
| is\_nested | varchar(1) | 如果为 true (t)，该列值表示访问嵌套的列数据类型。 |
| s3\_scanned\_rows | bigint | 已从 Amazon S3 扫描并发送到 Redshift Spectrum 层的行数量。 |
| s3\_scanned\_bytes | bigint | 已从 Amazon S3 扫描并发送到 Redshift Spectrum 层的基于压缩数据的字节的数量。 |
| s3query\_returned\_rows | bigint | 已从 Redshift Spectrum 层返回到集群的行的数量。 |
| s3query\_returned\_bytes | bigint | 已从 Redshift Spectrum 层返回到集群的字节的数量。返回到 Amazon Redshift 的大量数据可能会影响系统性能。 |
| files | integer | 针对此 Redshift Spectrum 查询已处理的文件的数量。文件数量少会限制并行处理的优势。 |
| files\_max | integer | 一个切片上处理的最大文件数。 |
| files\_avg | integer | 一个切片上处理的平均文件数。 |
| splits | bigint | 为此分段处理的拆分数。在此切片上处理的拆分数。对于大型可拆分数据文件（例如，大于 512 MB 左右的数据文件），Redshift Spectrum 会尝试将文件拆分为多个 S3 请求以便进行并行处理。 |
| splits\_max | integer | 在此切片上处理的最大拆分数。 |
| splits\_avg | bigint | 在此切片上处理的平均拆分数。 |
| total\_split\_size | bigint | 处理的所有拆分的总大小。 |
| max\_split\_size | bigint | 处理的最大拆分大小（以字节为单位）。 |
| avg\_split\_size | bigint | 处理的平均拆分大小（以字节为单位）。 |
| total\_retries | bigint | 该段中的 Redshift Spectrum 查询的总重试次数。 |
| max\_retries | integer | 一个处理的文件的最大重试次数。 |
| max\_request\_duration | bigint | 单个文件请求的最长持续时间（以微秒为单位）。长时间运行的查询可能表示瓶颈。 |
| avg\_request\_duration | bigint | 文件请求的平均持续时间（以微秒为单位）。 |
| max\_request\_parallelism | integer | 该 Redshift Spectrum 查询的一个切片中的最大并行请求数。 |
| avg\_request\_parallelism | double precision | 该 Redshift Spectrum 查询的一个切片中的平均并行请求数。 |
| total\_slowdown\_count | bigint | 在外部表扫描期间出现减速错误的总 Amazon S3 请求数。 |
| max\_slowdown\_count | integer | 在一个切片上的外部表扫描期间出现减速错误的最大 Amazon S3 请求数。 |
## 示例查询
以下示例获取上次运行的查询的扫描步骤详细信息。
```
select query, segment, elapsed, s3_scanned_rows, s3_scanned_bytes, s3query_returned_rows, s3query_returned_bytes, files
from svcs_s3query_summary
where query = pg_last_query_id()
order by query,segment;
```
```
query | segment | elapsed | s3_scanned_rows | s3_scanned_bytes | s3query_returned_rows | s3query_returned_bytes | files
------+---------+---------+-----------------+------------------+-----------------------+------------------------+------
4587 | 2 | 67811 | 0 | 0 | 0 | 0 | 0
4587 | 2 | 591568 | 172462 | 11260097 | 8513 | 170260 | 1
4587 | 2 | 216849 | 0 | 0 | 0 | 0 | 0
4587 | 2 | 216671 | 0 | 0 | 0 | 0 | 0
```