

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

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

# SYS\_EXTERNAL\_QUERY\_DETAIL
<a name="SYS_EXTERNAL_QUERY_DETAIL"></a>

使用 SYS\_EXTERNAL\_QUERY\_DETAIL 來檢視區段層級的查詢詳細資料。每一列代表特定 WLM 查詢的區段，其中包含處理的列數、處理的位元組數以及 Amazon S3 中外部資料表的分割區資訊等詳細資訊。此檢視中的每一列在 SYS\_QUERY\_DETAIL 檢視中也會有一個對應的項目，但此檢視包含與外部查詢處理相關的更多詳細資訊。

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

## 資料表欄
<a name="SYS_EXTERNAL_QUERY_DETAIL-table-columns"></a>


| 欄名稱  | 資料類型  | Description  | 
| --- | --- | --- | 
| user\_id | integer | 提交查詢之使用者的識別碼。 | 
| query\_id | bigint | 外部查詢的查詢識別碼。 | 
| transaction\_id | bigint | 交易識別碼。 | 
| child\_query\_sequence | integer | 重寫使用者查詢的順序。從 0 開始，類似於 segment\_id。 | 
| segment\_id | integer | 查詢區段的區段識別碼。 | 
| source\_type | character(32) | 查詢的資料來源類型，對於 Redshift Spectrum 可以是 S3，對於聯合查詢可以是 PG。 | 
| start\_time | timestamp | 開始查詢的時間。 | 
| end\_time | timestamp | 查詢完成的時間。 | 
| duration | bigint | 查詢花費的時間 (微秒)。 | 
| total\_partitions | integer | Amazon S3 查詢所需的分割區數量。 | 
| qualified\_partitions | integer | Amazon S3 查詢掃描的分割區數量。 | 
| scanned\_files | bigint | 要掃描的 Amazon S3 檔案數目。 | 
| returned\_rows | bigint | Amazon S3 查詢的已掃描列數，或是聯合查詢的傳回列數。 | 
| returned\_bytes | bigint | Amazon S3 查詢的已掃描位元組數，或是聯合查詢的傳回位元組數。 | 
| file\_format | text | Amazon S3 檔案的檔案格式。 | 
| file\_location | text | 外部資料表的 Amazon S3 位置。 | 
| external\_query\_text | text | 聯合查詢的區段層級查詢文字。 | 
| warning\_message | character(4000) | 執行查詢時顯示的警告訊息。 | 
| table\_name | character(136) | 正在操作之步驟的資料表名稱。 | 
| is\_recursive | character(1) | 指示是否對子資料夾遞迴掃描。 | 
| is\_nested | character(1) | 指出是否存取巢狀欄資料類型。 | 
| s3list\_time | bigint | 檔案列出的持續時間，以毫秒為單位。 | 
| get\_partition\_time | long | 從 和 Apache Hive 列出 AWS Glue Data Catalog 和限定指定外部物件分割區所花費的時間。 | 

## 範例查詢
<a name="SYS_EXTERNAL_QUERY_DETAIL-sample-queries"></a>

下列查詢會顯示外部查詢詳細資訊。

```
SELECT query_id,
       segment_id,
       start_time,
       end_time,
       total_partitions,
       qualified_partitions,
       scanned_files,
       returned_rows,
       returned_bytes,
       trim(external_query_text) query_text,
       trim(file_location) file_location
FROM sys_external_query_detail
ORDER BY query_id, start_time DESC
LIMIT 2;
```

輸出範例。

```
 query_id | segment_id |         start_time         |          end_time          | total_partitions | qualified_partitions | scanned_files | returned_rows | returned_bytes | query_text | file_location
----------+------------+----------------------------+----------------------------+------------------+----------------------+---------------+---------------+----------------+------------+---------------
   763251 |          0 | 2022-02-15 22:32:23.312448 | 2022-02-15 22:32:24.036023 |                3 |                    3 |             3 |         38203 |        2683414 |            |
   763254 |          0 | 2022-02-15 22:32:40.17103  | 2022-02-15 22:32:40.839313 |                3 |                    3 |             3 |         38203 |        2683414 |            |
```