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à.
Per informazioni sull'utilizzo di questo comando, vedereCrea un'integrazione di eventi S3 per copiare automaticamente i file dai bucket Amazon S3.
Gestisce i comandi COPY per il caricamento dei dati in una tabella. Il comando COPY JOB è un'estensione del comando COPY e automatizza il caricamento dei dati dai bucket Amazon S3. Quando crei un processo COPY, Amazon Redshift rileva quando vengono creati nuovi file Amazon S3 in un percorso specificato e li carica automaticamente senza il tuo intervento. Gli stessi parametri utilizzati nel comando COPY originale vengono utilizzati durante il caricamento dei dati. Amazon Redshift tiene traccia dei file caricati (in base al nome del file) per verificare che vengano caricati una sola volta.
Nota
Per informazioni sul comando COPY, inclusi utilizzo, parametri e autorizzazioni, consulta COPY.
Autorizzazione richiesta
Per eseguire il comando COPY di un processo COPY JOB, è necessario disporre del privilegio INSERT della tabella da caricare.
Il ruolo IAM specificato con il comando COPY deve disporre dell'autorizzazione per accedere ai dati da caricare. Per ulteriori informazioni, consulta Autorizzazioni IAM per COPY, UNLOAD e CREATE LIBRARY.
Sintassi
Crea un processo di copia. I parametri del comando COPY vengono salvati con il processo di copia.
Non puoi eseguire COPY JOB CREATE nell'ambito di un blocco di transazione.
COPY copy-command JOB CREATE job-name [AUTO ON | OFF]
Modifica la configurazione di un processo di copia.
COPY JOB ALTER job-name [AUTO ON | OFF]
Esegui un processo di copia. Vengono utilizzati i parametri del comando COPY memorizzati.
COPY JOB RUN job-name
Elenca tutti i processi di copia.
COPY JOB LIST
Mostra i dettagli di un processo di copia.
COPY JOB SHOW job-name
Elimina un processo di copia.
Non è possibile eseguire COPY JOB DROP nell'ambito di un blocco di transazioni.
COPY JOB DROP job-name
Parametri
- copy-command
-
Un comando COPY che carica i dati da Amazon S3 ad Amazon Redshift. La clausola contiene i parametri COPY che definiscono il bucket Amazon S3, la tabella di destinazione, il ruolo IAM e altri parametri utilizzati durante il caricamento dei dati. Sono supportati tutti i parametri del comando COPY per il caricamento di dati Amazon S3 con le seguenti eccezioni:
-
COPY JOB non importa file preesistenti nella cartella a cui fa riferimento il comando COPY. Vengono importati solo i file creati dopo il timestamp di creazione di COPY JOB.
Non è possibile specificare un comando COPY con le opzioni MAXERROR o IGNOREALLERRORS.
Non è possibile specificare un file manifesto. COPY JOB richiede una posizione Amazon S3 designata per monitorare i file appena creati.
Non è possibile specificare un comando COPY con tipi di autorizzazione come le chiavi Access e Secret. Sono supportati solo i comandi COPY che utilizzano il parametro
IAM_ROLEper l'autorizzazione. Per ulteriori informazioni, consulta Parametri di autorizzazione.Il comando COPY JOB non supporta il ruolo IAM predefinito associato al cluster. Devi specificare il
IAM_ROLEnel comando COPY.
Per ulteriori informazioni, consulta COPY da Amazon S3.
-
- job-name
-
Nome del processo utilizzato per fare riferimento al processo COPY. Il nome del lavoro non può contenere un trattino (‐).
- [AUTO ON | OFF]
-
Clausola che indica se i dati Amazon S3 vengono caricati automaticamente nelle tabelle Amazon Redshift.
Se è selezionato
ON, Amazon Redshift monitora il percorso Amazon S3 di origine per individuare i file appena creati e, se ne trova, viene eseguito un comando COPY con i parametri COPY nella definizione del processo. Questa è l'impostazione predefinita.Se è selezionato
OFF, Amazon Redshift non esegue automaticamente il comando COPY JOB.
Note per l'utilizzo
Le opzioni del comando COPY vengono convalidate solo in fase di esecuzione. Ad esempio, un IAM_ROLE e un'origine dati Amazon S3 non validi generano errori di runtime all'avvio del processo COPY JOB.
Se il cluster è in pausa, i processi COPY JOB non vengono eseguiti.
Per eseguire query sui file di comando COPY caricati e per gli errori di caricamento, consulta STL_LOAD_COMMITS, STL_LOAD_ERRORS, STL_LOADERROR_DETAIL. Per ulteriori informazioni, consulta Verifica del caricamento corretto dei dati.
Esempi
L'esempio seguente mostra la creazione di un processo COPY JOB per il caricamento di dati da un bucket Amazon S3.
COPY public.target_table
FROM 's3://amzn-s3-demo-bucket/staging-folder'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyLoadRoleName'
JOB CREATE my_copy_job_name
AUTO ON;
