

 Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の 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\$1LOAD\$1ERRORS
<a name="r_STL_LOAD_ERRORS"></a>

すべての Amazon Redshift ロードエラーのレコードを表示します。

STL\$1LOAD\$1ERRORS には、Amazon Redshift ロードエラーの履歴が含まれます。発生する可能性があるロードエラーと説明の包括的なリストについては、「[ロードエラー参照](r_Load_Error_Reference.md)」を参照してください。

STL\$1LOAD\$1ERRORS をクエリしてエラーに関する一般的な情報を得た後で、解析エラーが発生したデータの正確な行と列などの追加的な詳細を得るために [STL\$1LOADERROR\$1DETAIL](r_STL_LOADERROR_DETAIL.md) をクエリします。

STL\$1LOAD\$1ERRORS はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。

**注記**  
STL\$1LOAD\$1ERRORS には、メインのプロビジョニング済みクラスターで実行されるクエリのみが含まれます。同時実行スケーリングクラスターやサーバーレス名前空間で実行されるクエリは含まれていません。メインクラスターと、同時実行スケーリングクラスターやサーバーレス名前空間の両方で実行されるクエリの説明プランにアクセスするには、SYS モニタリングビュー [SYS\$1LOAD\$1ERROR\$1DETAIL](SYS_LOAD_ERROR_DETAIL.md) を使用することをお勧めします。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。

## テーブルの列
<a name="r_STL_LOAD_ERRORS-table-columns2"></a>

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_STL_LOAD_ERRORS.html)

## サンプルクエリ
<a name="r_STL_LOAD_ERRORS-sample-queries2"></a>

次のクエリは、STL\$1LOAD\$1ERRORS を STL\$1LOADERROR\$1DETAIL に結合して、最後に実行されたロード中に発生したエラーの詳細を表示します。

```
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
```

次の例では、STV\$1TBL\$1PERM と共に STL\$1LOAD\$1ERRORS を使用することにより、新しいビューを作成し、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 テーブルで発生した最新のロードエラーを返します。ロードエラーが発生していない場合、このクエリが返す行の数は 0 です。この例では、クエリは次のように 1 つのエラーを返します。

```
 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\$1number*、*is\$1partial*、および *start\$1offset* 列には、その分割処理に関する情報が表示されます。(元のファイルの行番号が使用できない場合は、行番号が不定になる可能性があります。) 

```
--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
```