O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). # Solução de problemas de carregamento de dados Ao carregar dados em tabelas do Amazon Redshift, você pode se deparar com erros do Amazon S3, dados de entrada inválidos e erros do comando COPY. As seções a seguir fornecem informações sobre como identificar e solucionar erros de carregamentos de dados. **Topics** + [Solução de problemas de integração de eventos do S3 e erros de COPY JOB](s3-integration-troubleshooting.md) + [Erros S3ServiceException](s3serviceexception-error.md) + [Tabelas de sistema para solucionar problemas de carregamento de dados](system-tables-for-troubleshooting-data-loads.md) + [Erros no carregamento de caracteres multibyte](multi-byte-character-load-errors.md) + [Referência de erros de carregamento](r_Load_Error_Reference.md) # Solução de problemas de integração de eventos do S3 e erros de COPY JOB Use as informações a seguir para solucionar problemas comuns com integrações de eventos do Amazon S3 e COPY JOB com o Amazon Redshift. ## Falha na criação da integração de eventos do S3 Se a criação da integração de eventos do S3 falhar, o status da integração será `Inactive`. Verifique se os seguintes itens estão corretos para o data warehouse do Amazon Redshift: + Você adicionou a entidade principal autorizada e a origem de integração correta ao namespace de destino no Amazon Redshift. Consulte [Pré-requisitos para criar uma integração de eventos do S3](loading-data-copy-job.md#loading-data-copy-job-prerequisites). + Você adicionou a política baseada em recursos correta ao bucket de origem do Amazon S3. Consulte [Pré-requisitos para criar uma integração de eventos do S3](loading-data-copy-job.md#loading-data-copy-job-prerequisites). ## Os dados do Amazon S3 não estão aparecendo no banco de dados de destino Se os dados de um COPY JOB não aparecerem, verifique o seguinte: + Consulte SYS\$1COPY\$1JOB\$1DETAIL para ver se o arquivo do Amazon S3 foi carregado, se a ingestão está pendente ou se há um erro. Para obter mais informações, consulte [SYS\$1COPY\$1JOB\$1DETAIL](SYS_COPY_JOB_DETAIL.md). + Consulte STL\$1ERROR ou SYS\$1COPY\$1JOB\$1INFO se o arquivo do Amazon S3 não estiver lá ou se houver um tempo de espera inesperado. Procure por erros de credenciais ou um detalhe que sugira que a integração está inativa. Para obter mais informações, consulte [STL\$1ERROR](r_STL_ERROR.md) e [SYS\$1COPY\$1JOB\$1INFO](SYS_COPY_JOB_INFO.md). # Erros S3ServiceException Os erros mais comuns de s3ServiceException são causados por uma string de credenciais incorreta ou formatada incorretamente, tendo seu cluster e seu bucket em diferentes regiões da AWS e permissões insuficientes do Amazon S3. A seção fornece informações para a solução de problemas de cada tipo de erro. ## String de credenciais inválida Se sua string de credenciais foi formatada inadequadamente, você receberá a seguinte mensagem de erro: ``` ERROR: Invalid credentials. Must be of the format: credentials 'aws_access_key_id=;aws_secret_access_key= [;token=]' ``` Verifique se a sequência de credenciais não contém espaços ou quebras de linha e está entre aspas simples. ## ID de chave de acesso inválido Se seu ID de chave de acesso não existir, você receberá a seguinte mensagem de erro: ``` [Amazon](500310) Invalid operation: S3ServiceException:The AWS Access Key Id you provided does not exist in our records. ``` Muitas vezes, trata-se de um erro de copiar e colar. Certifique-se de que o ID de chave de acesso foi inserido corretamente. Além disso, se você está usando chaves de sessão temporárias, verifique se o valor de `token` foi definido. ## Chave de acesso secreta inválida Se sua chave de acesso secreta estiver incorreta, você receberá a seguinte mensagem de erro: ``` [Amazon](500310) Invalid operation: S3ServiceException:The request signature we calculated does not match the signature you provided. Check your key and signing method.,Status 403,Error SignatureDoesNotMatch ``` Muitas vezes, trata-se de um erro de copiar e colar. Certifique-se de que a chave de acesso secreta foi inserida corretamente e que ela é a chave correta para o ID de chave de acesso. ## O bucket está em uma região diferente O bucket do Amazon S3 especificado no comando COPY deve estar na mesma região do cluster AWS. Se o seu bucket do Amazon S3 e seu cluster estiverem em regiões diferentes, você receberá um erro semelhante ao seguinte: ``` ERROR: S3ServiceException:The bucket you are attempting to access must be addressed using the specified endpoint. ``` Você pode criar um bucket do Amazon S3 em uma região específica selecionando a região ao criar o bucket usando o Console de Gerenciamento do Amazon S3 ou especificando um endpoint ao criar o bucket usando a API ou CLI do Amazon S3. Para obter mais informações, consulte [Carregar arquivos no Amazon S3 para usar com COPY](t_uploading-data-to-S3.md). Para mais informações sobre regiões do Amazon S3, consulte [Acessar um bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingBucket.html#access-bucket-intro) no *Guia do usuário do Amazon Simple Storage Service*. Você também pode especificar a região usando a opção [REGION](copy-parameters-data-source-s3.md#copy-region) com o comando COPY. ## Acesso negado Se o usuário não tiver permissões suficientes, você receberá a seguinte mensagem de erro: ``` ERROR: S3ServiceException:Access Denied,Status 403,Error AccessDenied ``` Uma possível causa é o usuário identificado pelas credenciais não ter acesso de LIST e GET ao bucket do Amazon S3. Para outras causas, consulte [Solucionar erros de Acesso Negado (403 Proibido) no Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/troubleshoot-403-errors.html) no *Guia do usuário do Amazon Simple Storage Service*. Para obter informações sobre o gerenciamento do acesso de usuários aos buckets, consulte [Gerenciamento de identidade e acesso no Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) no *Guia do usuário do Amazon Simple Storage Service*. # Tabelas de sistema para solucionar problemas de carregamento de dados As seguintes tabelas de sistema do Amazon Redshift podem ser úteis na solução de problemas de carregamento de dados: + Consulte [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) para descobrir erros que ocorreram durante os carregamentos específicos. + Consulte [STL\$1FILE\$1SCAN](r_STL_FILE_SCAN.md) para visualizar o tempo de carregamento de arquivos específicos ou para ver se um arquivo específico foi mesmo lido. + Consulte [STL\$1S3CLIENT\$1ERROR](r_STL_S3CLIENT_ERROR.md) para encontrar detalhes de erros encontrados durante a transferência de dados do Amazon S3. **Para encontrar e diagnosticar erros de carregamento** 1. Crie uma exibição ou defina uma consulta que retorne detalhes dos erros de carregamento. O seguinte exemplo junta a tabela STL\$1LOAD\$1ERRORS à tabela STV\$1TBL\$1PERM a IDs para comparar os IDs de tabela aos nomes reais da tabela. ``` 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); ``` 1. Defina a opção MAXERRORS em seu comando COPY como um valor grande o suficiente para permitir que COPY retorne informações úteis sobre seus dados. Se COPY encontrar erros, uma mensagem de erro o direciona a consultar a tabela STL\$1LOAD\$1ERRORS para obter detalhes. 1. Consulte a exibição LOADVIEW para visualizar detalhes de erros. Por exemplo: ``` select * from loadview where table_name='venue'; ``` ``` tbl | table_name | query | starttime --------+------------+-------+---------------------------- 100551 | venue | 20974 | 2013-01-29 19:05:58.365391 | input | line_number | colname | err_code | reason +----------------+-------------+---------+----------+-------------------- | venue_pipe.txt | 1 | 0 | 1214 | Delimiter not found ``` 1. Corrija o problema no arquivo de entrada ou no script do carregamento com base nas informações que a exibição retorna. Alguns erros típicos de carregamento a observar incluem: + Divergência entre os tipos de dados na tabela e valores nos campos nos dados de entrada. + Divergência entre o número de colunas na tabela e o número de campos nos dados de entrada. + Aspas incompatíveis. O Amazon Redshift oferece suporte a aspas simples e duplas; no entanto, essas aspas devem ser balanceadas adequadamente. + Formato incorreto de dados de data/hora nos arquivos de entrada. + Valores fora do intervalo nos arquivos de entrada (para colunas numéricas). + O número de valores distintos de uma coluna excede a limitação de sua codificação de compactação. # Erros no carregamento de caracteres multibyte As colunas com um tipo de dados CHAR aceitam somente caracteres UTF-8 de único byte, com valor de byte de até 127, ou 7F hex, que também é o conjunto de caracteres ASCII. Colunas VARCHAR aceitam caracteres UTF-8 multibyte até o máximo de quatro bytes. Para obter mais informações, consulte [Tipos de caracteres](r_Character_types.md). Se uma linha em seus dados de carregamento contiver um caractere que não for válido para o tipo de dados da coluna, COPY retornará um erro e registrará uma linha na tabela de log de sistema STL\$1LOAD\$1ERRORS com o erro número 1220. O campo ERR\$1REASON inclui a sequência de bytes, em hex, para o caractere inválido. Uma alternativa para corrigir caracteres não válidos em seus dados de carregamento é substituir os caracteres não válidos durante o processo de carregamento. Para substituir os caracteres UTF-8 não válidos, especifique a opção ACCEPTINVCHARS com o comando COPY. Se a opção ACCEPTINVCHARS estiver definida, o caractere especificado substituirá o ponto de código. Se a opção ACCEPTINVCHARS não estiver definida, o Amazon Redshift aceitará os caracteres como UTF-8 válidos. Para obter mais informações, consulte [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars). A lista de pontos de código a seguir são caracteres UTF-8 válidos. As operações COPY não retornarão um erro se a opção ACCEPTINVCHARS não estiver definida. No entanto, esses pontos de código são caracteres inválidos. Use opção [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars) para substituir o ponto de código por um caractere especificado por você. Esses pontos de código incluem o intervalo de valores de `0xFDD0` a `0xFDEF` e valores até `0x10FFFF`, terminados em `FFFE` ou `FFFF`: + `0xFFFE`, `0x1FFFE`, `0x2FFFE`, …, `0xFFFFE`, `0x10FFFE` + `0xFFFF`, `0x1FFFF`, `0x2FFFF`, …, `0xFFFFF`, `0x10FFFF` O exemplo a seguir mostra o motivo do erro quando COPY tenta carregar o caractere UTF-8 `e0 a1 c7a4` em uma coluna CHAR: ``` Multibyte character not supported for CHAR (Hint: Try using VARCHAR). Invalid char: e0 a1 c7a4 ``` Se o erro for relacionado a um tipo de dados VARCHAR, o motivo do erro incluirá um código de erro e a sequência hexadecimal UTF-8 inválida. O exemplo a seguir mostra o motivo do erro quando COPY tenta carregar UTF-8 `a4` em um campo VARCHAR: ``` String contains invalid or unsupported UTF-8 codepoints. Bad UTF-8 hex sequence: a4 (error 3) ``` A tabela a seguir lista as descrições e ações alternativas sugeridas para erros de carregamento VARCHAR. Se um desses erros ocorrer, substitua o caractere com uma sequência de código UTF-8 válida ou remova o caractere. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/redshift/latest/dg/multi-byte-character-load-errors.html) # Referência de erros de carregamento Se um erro ocorrer durante o carregamento de dados de um arquivo, consulte a tabela [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) para identificar o erro e determinar a possível explicação. A tabela a seguir lista todos os códigos de erros que podem ocorrer durante carregamentos de dados: ## Códigos de erro de carregamento [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/redshift/latest/dg/r_Load_Error_Reference.html)