O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na [publicação do blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/) publicada em 30 de junho de 2025. # STL\_LOAD\_ERRORS Exibe os registros de todos os erros de carregamento do Amazon Redshift. STL\_LOAD\_ERRORS contém um histórico de todos os erros de carregamento do Amazon Redshift. Consulte [Referência de erros de carregamento](r_Load_Error_Reference.md) para obter uma lista abrangente de possíveis erros de carregamento e explicações. Consulte [STL\_LOADERROR\_DETAIL](r_STL_LOADERROR_DETAIL.md) para obter detalhes adicionais, como a linha de dados exata e coluna onde ocorreu um erro de análise, depois de consultar STL\_LOAD\_ERRORS para descobrir informações gerais sobre o erro. STL\_LOAD\_ERRORS permanece visível para todos os usuários. Os superusuários podem ver todas as linhas; usuários regulares podem ver somente seus próprios dados. Para obter mais informações, consulte [Visibilidade de dados em tabelas e visualizações de sistema](cm_chap_system-tables.md#c_visibility-of-data). **nota** STL\_LOAD\_ERRORS contém apenas as consultas executadas nos principais clusters provisionados. Ele não contém consultas executadas em clusters de escalabilidade simultânea ou em namespaces sem servidor. Para acessar os planos de explicação das consultas executadas em clusters principais, clusters de escalabilidade simultânea e namespaces sem servidor, recomendamos usar a visualização de monitoramento SYS [SYS\_LOAD\_ERROR\_DETAIL](SYS_LOAD_ERROR_DETAIL.md). Os dados na exibição de monitoramento SYS são formatados para serem mais fáceis de usar e compreender. ## Colunas da tabela | Nome da coluna | Tipo de dados | Descrição | | --- | --- | --- | | userid | integer | O ID do usuário que gerou a entrada. | | slice | integer | A fatia onde o erro ocorreu. | | tbl | integer | ID da tabela. | | starttime | timestamp | O horário (em UTC) de início do carregamento. | | sessão | integer | O ID de sessão para a sessão executando o carregamento. | | consultar | integer | ID da consulta. A coluna de consulta pode ser usada para unir outras tabelas e exibições do sistema. | | filename | character(256) | O caminho completo do arquivo de entrada para a carga. | | line\_number | bigint | O número da linha no arquivo de carga com o erro. Para o comando COPY do JSON, o número da linha da última linha do objeto JSON com o erro. | | colname | character(127) | O campo com erro. | | type | character(10) | O tipo de dados do campo. | | col\_length | character(10) | O tamanho da coluna, se aplicável. Este campo é preenchido quando o tipo de dados tem um limite de tamanho. Por exemplo, uma coluna com um tipo de dados "character(3)" conterá o valor "3". | | position | integer | A posição do erro no campo. | | raw\_line | character(1024) | Os dados de carga brutos que contêm o erro. Os caracteres multibyte nos dados de carga são substituídos por um ponto. | | raw\_field\_value | char(1024) | O valor da análise preliminar para o campo "colname" que leva ao erro de análise. | | err\_code | integer | Código de erro. | | err\_reason | character(100) | A explicação para o erro. | | is\_parcial | integer | Valor que, se true (1), indica que o arquivo de entrada é dividido em intervalos durante uma operação COPY. Se esse valor for false (0), o arquivo de entrada não será dividido. | | start\_offset | bigint | Valor que, se o arquivo de entrada for dividido durante uma operação COPY, indica o valor de deslocamento da divisão (em bytes). Se o número da linha no arquivo for desconhecido, o número da linha será -1. Se o arquivo não estiver dividido, esse valor será 0. | | copy\_job\_id | bigint | O identificador do trabalho de cópia. 0 indica que não há nenhum identificador de trabalho. | ## Consultas de exemplo A consulta a seguir une as tabelas STL\_LOAD\_ERRORS e STL\_LOADERROR\_DETAIL para exibir os detalhes dos erros que ocorreram durante a carga mais recente. ``` 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 ``` O exemplo a seguir usa a tabela STL\_LOAD\_ERRORS com a STV\_TBL\_PERM para criar uma exibição nova e, em seguida, usa essa exibição para determinar que erros ocorreram durante o carregamento de dados na tabela 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); ``` Em seguida, a consulta abaixo retorna o último erro ocorrido durante o carregamento na tabela 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; ``` A consulta retorna o último erro de carga ocorrido na tabela EVENT. Se não houver erros de carga, a consulta retorna zero linhas. Neste exemplo, a consulta retorna um único erro: ``` 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) ``` Nos casos em que o comando COPY divide automaticamente dados de arquivos grandes, descompactados e delimitados por texto para facilitar o paralelismo, as colunas *line\_number*, *is\_parcial* e *start\_offset* exibem as informações relativas às divisões. (O número da linha pode ser desconhecido nos casos em que o número da linha do arquivo original não está disponível.) ``` --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 ```