Amazon Redshift non supporterà più la creazione di nuovi Python UDFs a partire dalla Patch 198. Python esistente UDFs continuerà a funzionare fino al 30 giugno 2026. Per ulteriori informazioni, consulta il [post del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Risoluzione di problemi di caricamento dei dati Quando carichi i dati nelle tabelle Amazon Redshift, puoi riscontrare errori di Amazon S3, dati di input non validi ed errori del comando COPY. In questa sezione vengono fornite le informazioni relative all’identificazione e alla risoluzione degli errori di caricamento dei dati. **Topics** + [Risoluzione dei problemi di integrazione degli eventi S3 e degli errori del processo COPY JOB](s3-integration-troubleshooting.md) + [ServiceException Errori S3](s3serviceexception-error.md) + [Tabelle di sistema per la risoluzione di caricamento dei dati](system-tables-for-troubleshooting-data-loads.md) + [Errori di caricamento di caratteri multibyte](multi-byte-character-load-errors.md) + [Riferimento per gli errori di caricamento](r_Load_Error_Reference.md) # Risoluzione dei problemi di integrazione degli eventi S3 e degli errori del processo COPY JOB Utilizza le informazioni seguenti per risolvere i problemi di integrazione degli eventi Amazon S3 e degli errori del processo COPY JOB comuni con Amazon Redshift. ## Creazione dell’integrazione degli eventi S3 non riuscita Se la creazione dell’integrazione degli eventi S3 non è riuscita, lo stato dell’integrazione è `Inactive`. Assicurati che quanto segue sia corretto per il data warehouse Amazon Redshift. + Hai aggiunto il principale autorizzato e l’origine di integrazione corretti per il namespace di destinazione in Amazon Redshift. Per informazioni, consulta [Prerequisiti per la creazione di un’integrazione di eventi S3](loading-data-copy-job.md#loading-data-copy-job-prerequisites). + Hai aggiunto la policy basata sulle risorse corretta al bucket Amazon S3 di origine. Per informazioni, consulta [Prerequisiti per la creazione di un’integrazione di eventi S3](loading-data-copy-job.md#loading-data-copy-job-prerequisites). ## I dati Amazon S3 non vengono visualizzati nel database di destinazione Se i dati del processo COPY JOB non vengono visualizzati, controlla quanto segue. + Esegui query su SYS\$1COPY\$1JOB\$1DETAIL per visualizzare se il file Amazon S3 è stato caricato, se l’importazione è in sospeso o se si è verificato un errore. Per ulteriori informazioni, consulta [SYS\$1COPY\$1JOB\$1DETAIL](SYS_COPY_JOB_DETAIL.md). + Consulta STL\$1ERROR o SYS\$1COPY\$1JOB\$1INFO se il file Amazon S3 non è presente o c’è un tempo di attesa imprevisto. Cerca errori nelle credenziali o qualsiasi cosa che suggerisca che l’integrazione non è attiva. Per ulteriori informazioni, consultare [STL\$1ERROR](r_STL_ERROR.md) e [SYS\$1COPY\$1JOB\$1INFO](SYS_COPY_JOB_INFO.md). # ServiceException Errori S3 ServiceException Gli errori s3 più comuni sono causati da una stringa di credenziali formattata in modo errato o errato, dal fatto che il cluster e il bucket si trovano in AWS regioni diverse e autorizzazioni Amazon S3 insufficienti. La sezione fornisce informazioni sulla risoluzione dei problemi per ogni tipo di errore. ## Stringa di credenziali non valida Se la stringa delle credenziali non è stata formattata correttamente, riceverai il seguente messaggio di errore: ``` ERROR: Invalid credentials. Must be of the format: credentials 'aws_access_key_id=;aws_secret_access_key= [;token=]' ``` Verificare che la stringa di credenziali non contenga spazi o interruzioni di riga e sia racchiusa tra virgolette singole. ## ID chiave di accesso non valido Se l'ID della chiave di accesso non esiste, riceverai il seguente messaggio di errore: ``` [Amazon](500310) Invalid operation: S3ServiceException:The AWS Access Key Id you provided does not exist in our records. ``` Spesso si tratta di un errore di copia e incolla. Verifica che l'ID chiave di accesso sia stato inserito correttamente. Inoltre, se usi le chiavi di sessione temporanee, verifica che il valore per `token` sia impostato. ## Chiave di accesso segreta non valida Se la chiave di accesso segreta non è corretta, riceverai il seguente messaggio di errore: ``` [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 ``` Spesso si tratta di un errore di copia e incolla. Verifica che la chiave di accesso segreta sia stata inserita correttamente e che sia la chiave corretta per l'ID chiave di accesso. ## Bucket in una regione differente Il bucket Amazon S3 specificato nel comando COPY deve trovarsi nella stessa AWS regione del cluster. Se il bucket Amazon S3 e il cluster si trovano in regioni differenti, verrà ricevuto un errore simile al seguente: ``` ERROR: S3ServiceException:The bucket you are attempting to access must be addressed using the specified endpoint. ``` È possibile creare un bucket Amazon S3 in una regione specifica selezionando la regione quando si crea il bucket con la console di gestione Amazon S3 oppure specificando un endpoint quando si crea il bucket con la CLI o l'API di Amazon S3. Per ulteriori informazioni, consulta [Caricamento di file in Amazon S3 da usare con COPY](t_uploading-data-to-S3.md). Per maggiori informazioni sulle regioni di Amazon S3, consultare [Accesso a un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingBucket.html#access-bucket-intro) nella *Guida per l'utente di Amazon Simple Storage Service*. In alternativa, puoi specificare la regione utilizzando l'opzione [REGION](copy-parameters-data-source-s3.md#copy-region) con il comando COPY. ## Accesso negato Se l'utente non dispone di autorizzazioni sufficienti, riceverai il seguente messaggio di errore: ``` ERROR: S3ServiceException:Access Denied,Status 403,Error AccessDenied ``` Una causa possibile è che l'utente identificato dalle credenziali non dispone dell'accesso LIST e GET al bucket Amazon S3. Per altre cause, consulta [Risoluzione dei problemi relativi agli errori di accesso negato (403 Accesso negato) in Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/troubleshoot-403-errors.html) nella *Guida per l'utente di Amazon Simple Storage Service*. Per informazioni sulla gestione dell'accesso utente ai bucket, consulta [Identity and Access Management in Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) nella *Guida per l'utente di Amazon Simple Storage*. # Tabelle di sistema per la risoluzione di caricamento dei dati Le seguenti tabelle di sistema Amazon Redshift possono essere utili nella risoluzione di problemi di caricamento dei dati: + Esegui la query su [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) per scoprire gli errori che si sono verificati durante carichi specifici. + Esegui la query su [STL\$1FILE\$1SCAN](r_STL_FILE_SCAN.md) per visualizzare i tempi di caricamento di file specifici o per vedere se un file specifico è stato letto. + Eseguire la query su [STL\$1S3CLIENT\$1ERROR](r_STL_S3CLIENT_ERROR.md) per trovare i dettagli degli errori rilevati durante il trasferimento dei dati da Amazon S3. **Per trovare e diagnosticare errori di caricamento** 1. Creare una vista o definire una query che restituisca dettagli sugli errori di caricamento. L'esempio seguente unisce la tabella STL\$1LOAD\$1ERRORS alla tabella STV\$1TBL\$1PERM per abbinare la tabella ai nomi effettivi delle tabelle. IDs ``` 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. Impostare l'opzione MAXERRORS nel comando COPY su un valore sufficientemente grande da consentire a COPY di restituire informazioni utili sui dati. Se COPY rileva errori, un messaggio di errore indica di consultare la tabella STL\$1LOAD\$1ERRORS per i dettagli. 1. Eseguire una query sulla vista LOADVIEW per visualizzare i dettagli dell'errore. Ad esempio: ``` 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. Risolvere il problema nel file di input o nello script di caricamento, in base alle informazioni restituite dalla vista. Alcuni tipici errori di caricamento da tenere in considerazione includono: + Mancata corrispondenza tra i tipi di dati nella tabella e i valori nei campi di dati di input. + Mancata corrispondenza tra il numero di colonne nella tabella e il numero di campi nei dati di input. + Virgolette non corrispondenti. Amazon Redshift supporta le virgolette singole e doppie; tuttavia, queste virgolette devono essere bilanciate in modo appropriato. + Formato date/time errato per i dati nei file di input. + Out-of-range valori nei file di input (per colonne numeriche). + Numero di valori distinti per una colonna superiore alla limitazione per la sua codifica di compressione. # Errori di caricamento di caratteri multibyte Le colonne con un tipo di dati CHAR accettano solo caratteri UTF-8 a byte singolo, fino un valore di byte 127 o 7F esadecimale, che rappresenta anche il set di caratteri ASCII. Le colonne VARCHAR accettano caratteri multibyte UTF-8, fino a un massimo di quattro byte. Per ulteriori informazioni, consulta [Tipi di carattere](r_Character_types.md). Se una riga nei dati di caricamento contiene un carattere non valido per il tipo di dati della colonna, COPY restituisce un errore e registra una riga nella tabella del log di sistema STL\$1LOAD\$1ERRORS con il numero di errore 1220. Il campo ERR\$1REASON include la sequenza di byte, in esadecimale, per il carattere non valido. Un'alternativa alla correzione di caratteri non validi nei dati di caricamento è la sostituzione dei caratteri non validi durante il processo di caricamento. Per sostituire i caratteri UTF-8 non validi, specifica l'opzione ACCEPTINVCHARS con il comando COPY. Se l'opzione ACCEPTINVCHARS è impostata, il carattere specificato sostituisce il punto codice. Se l'opzione ACCEPTINVCHARS non è impostata, Amazon Redshift accetta i caratteri come UTF-8 valido. Per ulteriori informazioni, consulta [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars). Il seguente elenco di punti codice è valido UTF-8, le operazioni COPY non restituiscono un errore se l'opzione ACCEPTINVCHARS non è impostata. Tuttavia, questi punti codice sono caratteri non validi. Puoi utilizzare l'opzione [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars) per sostituire un punto di codice con un carattere specificato. Questi punti di codice includono l'intervallo di valori da `0xFDD0` a `0xFDEF` e valori fino a `0x10FFFF`, terminando con `FFFE` o `FFFF`: + `0xFFFE`, `0x1FFFE`, `0x2FFFE`, …, `0xFFFFE`, `0x10FFFE` + `0xFFFF`, `0x1FFFF`, `0x2FFFF`, …, `0xFFFFF`, `0x10FFFF` L'esempio seguente mostra il motivo dell'errore quando COPY prova a caricare il carattere UTF-8 `e0 a1 c7a4` in una colonna CHAR. ``` Multibyte character not supported for CHAR (Hint: Try using VARCHAR). Invalid char: e0 a1 c7a4 ``` Se l'errore è correlato a un tipo di dati VARCHAR, il motivo dell'errore include un codice di errore e la sequenza esadecimale UTF-8 non valida. L'esempio seguente mostra il motivo dell'errore quando COPY prova a caricare il carattere UTF-8 `a4` in un campo VARCHAR. ``` String contains invalid or unsupported UTF-8 codepoints. Bad UTF-8 hex sequence: a4 (error 3) ``` Nella tabella seguente sono elencate le descrizioni e le soluzioni alternative suggerite per gli errori di caricamento VARCHAR. Se si verifica uno di questi errori, sostituisci il carattere con una sequenza di codice UTF-8 valida o rimuovi il carattere. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/redshift/latest/dg/multi-byte-character-load-errors.html) # Riferimento per gli errori di caricamento Se si verificano errori durante il caricamento dei dati da un file, esegui una query sulla tabella [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) per identificare l'errore e determinare la possibile spiegazione. La seguente tabella elenca tutti i codici di errore che potrebbero verificarsi durante i caricamenti di dati: ## Codici di errore di caricamento [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/redshift/latest/dg/r_Load_Error_Reference.html)