Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# SVCS\_S3QUERY\_SUMMARY
使用 SVCS\_S3QUERY\_SUMMARY 檢視取得已在系統上執行之所有資料湖查詢的摘要。一個區段可以執行一個外部資料表掃描。
**注意**
字首為 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 層的列數。在 RG 佈建叢集上，這是在篩選下推之前，由叢集的原生讀取器跨所有配量直接從 Amazon S3 掃描的資料列總數。 |
| s3\_scanned\_bytes | bigint | 根據壓縮檔案，從 Amazon S3 經掃描並送至 Redshift Spectrum 層的位元組數。在 RG 佈建叢集上，這是在篩選下推之前，由叢集的原生讀取器跨所有配量直接從 Amazon S3 掃描的位元組總數。 |
| s3query\_returned\_rows | bigint | 從 Redshift Spectrum 層傳回至叢集的資料列數。在 RG 佈建叢集上，這是在篩選下推之後，叢集原生讀取器在所有配量中傳回的資料列總數。 |
| s3query\_returned\_bytes | bigint | 從 Redshift Spectrum 層傳回至叢集的位元組數。傳回至 Amazon Redshift 的大量資料可能會影響系統效能。在 RG 佈建叢集上，這是在篩選下推之後，叢集原生讀取器在所有配量中傳回的位元組總數。 |
| files | integer | 為此資料湖查詢處理的檔案數。限制平行處理之好處的少數檔案。 |
| 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 查詢的重試數總計。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。如需 RG 上的 Amazon S3 用戶端重試，請參閱 STL\_S3CLIENT。 |
| max\_retries | integer | 一個個別處理檔案的重試數上限。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。如需 RG 上的 Amazon S3 用戶端重試，請參閱 STL\_S3CLIENT。 |
| max\_request\_duration | bigint | 個別檔案請求的最大持續期間 (微秒)。長時間執行的查詢可能表示存在瓶頸。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 |
| avg\_request\_duration | bigint | 檔案請求的平均持續時間 (微秒)。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 |
| max\_request\_parallelism | integer | 此 Redshift Spectrum 查詢在某個分割上的最大平行請求數。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 |
| avg\_request\_parallelism | double precision | 此 Redshift Spectrum 查詢在某個分割上的平均平行請求數。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 |
| total\_slowdown\_count | bigint | 外部資料表掃描期間發生，具有降速錯誤的 Amazon S3 請求總數。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 |
| max\_slowdown\_count | integer | 在某分割上外部資料表掃描期間發生，具有降速錯誤的最大 Amazon S3 請求數。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 |
## 範例查詢
以下範例會取得前次執行查詢的掃描步驟詳細資訊。
```
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
```