STL_LOAD_ERRORS

顯示所有 Amazon Redshift 載入錯誤的記錄。

STL_LOAD_ERROR 包含所有 Amazon Redshift 載入錯誤的歷史記錄。如需可能載入錯誤和說明的完整清單，請參閱載入錯誤參考。

查STL_LOADERROR_DETAIL詢 STL_LOAD_ERRORS 以找出有關錯誤的一般資訊之後，查詢其他詳細資訊，例如發生剖析錯誤的確切資料列和資料行。

所有使用者都可以看到此檢視。超級使用者可以看見所有資料列；一般使用者只能看見自己的資料。如需詳細資訊，請參閱系統資料表和檢視中資料的可見性。

資料表欄位

資料欄名稱	資料類型	描述
userid	integer	產生項目的使用者之 ID。
分割	integer	發生錯誤的配量。
tbl	integer	表格 ID。
starttime	timestamp	載入的開始時間，以 UTC 表示。
session	integer	執行載入之工作階段的工作階段 ID。
query	integer	查詢 ID。查詢欄可用於加入其他系統表格與檢視。
filename	character(256)	用於載入之輸入檔案的完整路徑。
line_number	bigint	載入檔案中發生錯誤的行號。對於來自 JSON 的 COPY，JSON 物件中發生錯誤之最後一行的行號。
colname	character(127)	發生錯誤的欄位。
類型	character(10)	欄位的資料類型。
col_length	character(10)	資料欄長度 (如適用)。當資料類型具有限制長度時，會填入此欄位。例如，對於資料類型為 "character(3)" 的資料欄，此資料欄將包含值 "3"。
position	integer	欄位中錯誤的位置。
raw_line	character(1024)	包含錯誤的原始載入資料。載入資料中的多位元組字元會取代為句點。
raw_field_value	char(1024)	導致剖析錯誤之欄位 "colname" 的預先剖析值。
err_code	integer	錯誤代碼。
err_reason	character(100)	錯誤的說明。
是 (_ 部分)	integer	值，如果真（1）表示輸入文件被分成一個 COPY 操作過程中的範圍。如果此值為 false (0)，則輸入檔案不會分割。
起始 _ 位移	bigint	值，如果輸入文件在 COPY 操作期間被分割，則表示分割的偏移值（以字節為單位）。如果檔案中的行號不明，則行號為 -1。如果檔案未分割，則此值為 0。
複製工作 ID	bigint	複製工作識別碼。A 0 表示沒有工作識別碼。

範例查詢

下列查詢會將 STL_LOAD_ERRORS 聯結至 STL_LOADERROR_DETAIL，以檢視最近載入期間發生之錯誤的詳細資訊。

select d.query, substring(d.filename,14,20), 
d.line_number as line, 
substring(d.value,1,16) as value,
substring(le.err_reason,1,48) as err_reason
from stl_loaderror_detail d, stl_load_errors le
where d.query = le.query
and d.query = pg_last_copy_id(); 

 query |    substring      | line |  value   |              err_reason
-------+-------------------+------+----------+----------------------------
    558| allusers_pipe.txt |  251 | 251      | String contains invalid or 
                                               unsupported UTF8 code
    558| allusers_pipe.txt |  251 | ZRU29FGR | String contains invalid or 
                                               unsupported UTF8 code
    558| allusers_pipe.txt |  251 | Kaitlin  | String contains invalid or 
                                               unsupported UTF8 code
    558| allusers_pipe.txt |  251 | Walter   | String contains invalid or 
                                               unsupported UTF8 code

下列範例會使用 STL_LOAD_ERRORS 與 STV_TBL_PERM 搭配來建立新檢視，然後使用該檢視來判斷將資料載入至 EVENT 資料表時發生哪些錯誤：

create view loadview as
(select distinct tbl, trim(name) as table_name, query, starttime,
trim(filename) as input, line_number, colname, err_code,
trim(err_reason) as reason
from stl_load_errors sl, stv_tbl_perm sp
where sl.tbl = sp.id);

接著，下列查詢實際上會傳回上次載入 EVENT 資料表時發生的錯誤：

select table_name, query, line_number, colname, starttime, 
trim(reason) as error
from loadview
where table_name ='event'
order by line_number limit 1;

此查詢會傳回 EVENT 資料表上次發生的載入錯誤。如果未發生任何載入錯誤，則查詢不會傳回任何資料列。在此範例中，查詢會傳回單一錯誤：

 table_name | query | line_number | colname | error | starttime
------+-----+----+----+--------------------------------------------------------+----------------------
event | 309 |  0 |  5 | Error in Timestamp value or format [%Y-%m-%d %H:%M:%S] | 2014-04-22 15:12:44

(1 row)

如果 COPY 指令會自動分割大型、未壓縮的文字分隔檔案資料以促進平行處理原則，則 line_number、is_partial 和 start_ offset 欄會顯示與分割有關的資訊。（如果原始文件中的行號不可用，則行號可能是未知的。）

--scan ranges information
SELECT line_number, POSITION, btrim(raw_line), btrim(raw_field_value),
btrim(err_reason), is_partial, start_offset FROM stl_load_errors
WHERE query = pg_last_copy_id();

--result
-1,51,"1008771|13463413|463414|2|28.00|38520.72|0.06|0.07|NO|1998-08-30|1998-09-25|1998-09-04|TAKE BACK RETURN|RAIL|ans cajole sly","NO","Char length exceeds DDL length",1,67108864