

 从补丁 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/)。

# SVL\_S3QUERY
<a name="r_SVL_S3QUERY"></a>

使用 SVL\_S3QUERY 视图获取有关段和节点切片级别的 Amazon Redshift Spectrum 查询的详细信息。

SVL\_S3QUERY 对所有用户可见。超级用户可以查看所有行；普通用户只能查看其自己的数据。有关更多信息，请参阅 [系统表和视图中的数据可见性](cm_chap_system-tables.md#c_visibility-of-data)。

**注意**  
SVL\_S3QUERY 仅包含在主预置集群上运行的查询。它不包含在并发扩展集群或无服务器命名空间上运行的查询。要访问在主集群、并发扩展集群和无服务器命名空间上运行的查询的解释计划，我们建议您使用 SYS 监控视图 [SYS\_EXTERNAL\_QUERY\_DETAIL](SYS_EXTERNAL_QUERY_DETAIL.md)。SYS 监控视图中的数据经过格式化处理，便于使用和理解。

## 表列
<a name="r_SVL_S3QUERY-table-columns"></a>


| 列名称  | 数据类型  | 描述  | 
| --- | --- | --- | 
| userid | integer | 生成了给定条目的用户的 ID。 | 
| query | integer | 查询 ID。 | 
| segment | integer | 段编号。一个查询包含多个区段，而且每个区段包含一个或多个步骤。 | 
| step | integer | 运行的查询步骤。 | 
| node | integer | 节点编号。 | 
| slice | integer | 运行的特定段所针对的数据切片。 | 
| starttime | timestamp | 开始执行查询的时间（采用 UTC 表示）。 | 
| endtime | timestamp | 完成执行查询的时间（采用 UTC 表示） | 
| elapsed | integer | 已用时间（以微秒为单位） | 
| external\_table\_name | char(136) | s3 扫描步骤的外部表名称的内部格式。 | 
| is\_partitioned | char(1) | 如果为 true (t)，则此列值表示外部表已进行分区。 | 
| is\_rrscan | char(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 层返回到集群的字节的数量。 | 
| files | integer | 此 S3 扫描步骤中在此切片上已处理的文件的数量。 | 
| splits | int | 在此切片上处理的拆分数。对于大型可拆分数据文件（例如，大于 512 MB 左右的数据文件），Redshift Spectrum 会尝试将文件拆分为多个 S3 请求以便进行并行处理。 | 
| total\_split\_size | bigint | 在此切片上处理的所有拆分的总大小（以字节为单位）。 | 
| max\_split\_size | bigint | 为此切片处理的最大拆分大小（以字节为单位）。 | 
| total\_retries | integer | 已处理文件的总重试次数。 | 
| max\_retries | integer | 单个已处理文件的最大重试次数。 | 
| max\_request\_duration | integer | 单个 Redshift Spectrum 请求的最长持续时间（以微秒为单位）。 | 
| avg\_request\_duration | double precision | Redshift Spectrum 请求的平均持续时间（以微秒为单位）。 | 
| max\_request\_parallelism | integer | 此 S3 扫描步骤中此切片上的未完成的 Redshift Spectrum 的最大数量。 | 
| avg\_request\_parallelism | double precision | 此 S3 扫描步骤中此切片上的并行 Redshift Spectrum 请求的平均数量。 | 

## 示例查询
<a name="r_SVL_S3QUERY-sample-query"></a>

以下示例获取上次完成的查询的扫描步骤详细信息。

```
select query, segment, slice, elapsed, s3_scanned_rows, s3_scanned_bytes, s3query_returned_rows, s3query_returned_bytes, files 
from svl_s3query 
where query = pg_last_query_id() 
order by query,segment,slice;
```

```
query | segment | slice | elapsed | s3_scanned_rows | s3_scanned_bytes | s3query_returned_rows | s3query_returned_bytes | files
------+---------+-------+---------+-----------------+------------------+-----------------------+------------------------+------
 4587 |       2 |     0 |   67811 |               0 |                0 |                     0 |                      0 |     0
 4587 |       2 |     1 |  591568 |          172462 |         11260097 |                  8513 |                 170260 |     1
 4587 |       2 |     2 |  216849 |               0 |                0 |                     0 |                      0 |     0
 4587 |       2 |     3 |  216671 |               0 |                0 |                     0 |                      0 |     0
```