

 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/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

使用 SVL\_S3QUERY 檢視以取得區段和節點配量層級的資料湖查詢詳細資訊。

所有使用者都可看見 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 | 執行的查詢步驟。 | 
| 節點 | integer | 節點號碼。 | 
| 分割 | 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 層的列數。在 RG 佈建叢集上，這是在篩選下推之前，由叢集的原生讀取器直接從 Amazon S3 讀取的資料列數目。 | 
| s3\_scanned\_bytes | bigint | 從 Amazon S3 經掃描並送至 Redshift Spectrum 層的位元組數。在 RG 佈建叢集上，這是叢集原生讀取器處理的總掃描範圍大小，以位元組為單位。 | 
| s3query\_returned\_rows | bigint | 從 Redshift Spectrum 層傳回至叢集的資料列數。在 RG 佈建叢集上，這是篩選下推後外部資料表掃描產生的資料列數。 | 
| s3query\_returned\_bytes | bigint | 從 Redshift Spectrum 層傳回至叢集的位元組數。在 RG 佈建叢集上，這是篩選下推後外部資料表掃描產生的位元組數。 | 
| files | integer | 在此分割上此 S3 掃描步驟已處理的檔案數。 | 
| splits | int | 在此分割上處理的分割數。有了大型可分割資料檔案 (例如，大於 512 MB 的資料檔案)，Redshift Spectrum 會嘗試將檔案分割至多個 S3 請求來進行平行處理。在 RG 佈建叢集上，這是叢集原生讀取器耗用的掃描範圍數目。 | 
| total\_split\_size | bigint | 在此分割上處理的所有分割大小總計 (位元組)。在 RG 佈建叢集上，這是使用的所有掃描範圍總大小，以位元組為單位。 | 
| max\_split\_size | bigint | 為此分割處理的分割大小上限 (位元組)。在 RG 佈建叢集上，這是使用的最大掃描範圍大小，以位元組為單位。 | 
| total\_retries | integer | 處理檔案的重試數總計。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。如需 RG 上的 Amazon S3 用戶端重試，請參閱 STL\_S3CLIENT。 | 
| max\_retries | integer | 個別處理檔案的重試數上限。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。如需 RG 上的 Amazon S3 用戶端重試，請參閱 STL\_S3CLIENT。 | 
| max\_request\_duration | integer | 個別 Redshift Spectrum 請求的最大持續期間 (微秒)。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 | 
| avg\_request\_duration | double precision | Redshift Spectrum 請求的平均持續時間 (微秒)。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 | 
| max\_request\_parallelism | integer | 在此 S3 掃描步驟的分割上未完成 Redshift Spectrum 數上限。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 | 
| avg\_request\_parallelism | double precision | 在此 S3 掃描步驟的分割上平行 Redshift Spectrum 請求數平均。在 RG 節點類型叢集上，此資料欄已棄用且包含 -1。 | 

## 範例查詢
<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
```