

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

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

# STL\_FILE\_SCAN
<a name="r_STL_FILE_SCAN"></a>

傳回 Amazon Redshift 在使用 COPY 命令載入資料時讀取的檔案。

查詢此檢視有助於對資料載入錯誤進行故障診斷。STL\_FILE\_SCAN 特別有助於指出平行資料載入中的問題，因為平行資料載入通常會利用單一 COPY 命令載入多個檔案。

所有使用者都可看見 STL\_FILE\_SCAN。超級使用者可以看見所有資料列；一般使用者只能看見自己的資料。如需詳細資訊，請參閱[系統資料表和檢視中資料的可見性](cm_chap_system-tables.md#c_visibility-of-data)。

**注意**  
STL\_FILE\_SCAN 僅包含在主佈建叢集上執行的查詢。但不包含在並行擴縮叢集上或無伺服器命名空間上執行的查詢。若要存取在主要叢集、並行擴縮叢集和無伺服器命名空間上執行的查詢說明計畫，建議您使用 SYS 監控檢視 [SYS\_LOAD\_DETAIL](SYS_LOAD_DETAIL.md)。SYS 監視檢視中的資料會格式化為更易於使用和理解。

## 資料表欄
<a name="r_STL_FILE_SCAN-table-columns2"></a>


| 欄名稱 | 資料類型 | 說明 | 
| --- | --- | --- | 
| userid | integer | 產生項目的使用者之 ID。 | 
| query  | integer | 查詢 ID。查詢欄可用於加入其他系統表格與檢視。 | 
| 分割 | integer | 識別執行查詢之配量的數字。 | 
| name | character(90) | 已載入之檔案的完整路徑和名稱。 | 
| lines | bigint | 從檔案讀取的行數。 | 
| 位元組 | bigint | 從檔案讀取的位元組數。 | 
| loadtime | bigint | 載入檔案所花費的時間 (以微秒為單位)。 | 
| curtime | 時間戳記 | 代表 Amazon Redshift 開始處理檔案之時間的時間戳記。 | 
| is\_partial | integer | 如果值為 true (1)，則表示輸入檔在 COPY 操作期間被分割為多個範圍。如果此值為 false (0)，則輸入檔案不會分割。 | 
| start\_offset | bigint | 如果輸入檔案在 COPY 操作期間被分割，則該值指示分割的偏移值 (以位元組為單位)。如果檔案未分割，則此值為 0。 | 

## 範例查詢
<a name="r_STL_FILE_SCAN-sample-queries2"></a>

下列查詢擷取 Amazon Redshift 需要超過 1,000,000 微秒來讀取之任何檔案的名稱和載入時間。

```
select trim(name)as name, loadtime from stl_file_scan
where loadtime > 1000000;
```

此查詢傳回下列範例輸出。

```
           name            | loadtime
---------------------------+----------
 listings_pipe.txt         |  9458354
 allusers_pipe.txt         |  2963761
 allevents_pipe.txt        |  1409135
 tickit/listings_pipe.txt  |  7071087
 tickit/allevents_pipe.txt |  1237364
 tickit/allusers_pipe.txt  |  2535138
 listings_pipe.txt         |  6706370
 allusers_pipe.txt         |  3579461
 allevents_pipe.txt        |  1313195
 tickit/allusers_pipe.txt  |  3236060
 tickit/listings_pipe.txt  |  4980108
(11 rows)
```