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à.
COPYJOB(anteprima)
| Questa è la documentazione non definitiva per autocopy (SQLCOPYJOB), che è in versione di anteprima. La documentazione e la funzionalità sono soggette a modifiche. Consigliamo di utilizzare questa caratteristica solo in ambienti di test e non in ambienti di produzione. L'anteprima pubblica terminerà il 31 ottobre 2024. I cluster di anteprima verranno rimossi automaticamente due settimane dopo il termine dell'anteprima. Per i termini e condizioni dell'anteprima, consulta la sezione su beta e anteprime nei AWS termini del servizio |
Per ulteriori informazioni sull'utilizzo di questo comando, consulta Caricamento di tabelle con inserimento continuo di file da Amazon S3 (anteprima).
Gestisce COPY i comandi che caricano i dati in una tabella. Il COPY JOB comando è un'estensione del COPY comando e automatizza il caricamento dei dati dai bucket Amazon S3. Quando crei un COPY lavoro, Amazon Redshift rileva quando vengono creati nuovi file Amazon S3 in un percorso specifico e quindi li carica automaticamente senza il tuo intervento. Gli stessi parametri utilizzati nel COPY comando originale vengono utilizzati durante il caricamento dei dati. Amazon Redshift tiene traccia dei file caricati per verificare che vengano caricati una sola volta.
Nota
Per informazioni sul COPY comando, inclusi l'utilizzo, i parametri e le autorizzazioni, vedereCOPY.
Autorizzazione richiesta
Per eseguire il COPY comando di a COPYJOB, è necessario disporre del INSERT privilegio della tabella da caricare.
Il IAM ruolo specificato con il COPY comando deve disporre del permesso di accedere ai dati da caricare. Per ulteriori informazioni, consulta IAMautorizzazioni per, e COPY UNLOAD CREATE LIBRARY.
Sintassi
Crea un processo di copia. I parametri del COPY comando vengono salvati con il processo di copia.
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 COPY comando 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.
COPY JOB DROP job-name
Parametri
- copy-command
-
Un COPY comando che carica i dati da Amazon S3 ad Amazon Redshift. La clausola contiene COPY parametri che definiscono il bucket Amazon S3, la tabella IAM di destinazione, il ruolo e altri parametri utilizzati durante il caricamento dei dati. Sono supportati tutti i parametri di COPY comando per il caricamento di dati di Amazon S3 tranne:
-
COPYJOBnon inserisce file preesistenti nella cartella indicata dal comando. COPY Vengono importati solo i file creati dopo il timestamp di COPY JOB creazione.
Non è possibile specificare un COPY comando con le opzioni o. MAXERROR IGNOREALLERRORS
Non è possibile specificare un file manifesto. COPYJOBrichiede una posizione Amazon S3 designata per monitorare i file appena creati.
Non è possibile specificare un COPY comando con tipi di autorizzazione come Access e Secret keys. Sono supportati solo COPY i comandi che utilizzano il
IAM_ROLEparametro per l'autorizzazione. Per ulteriori informazioni, consulta Parametri di autorizzazione.COPYJOBnon supporta il IAM ruolo predefinito associato al cluster. È necessario specificare il
IAM_ROLEnel COPY comando.
Per ulteriori informazioni, consulta COPYda Amazon S3.
-
- job-name
-
Il nome del lavoro utilizzato per fare riferimento al COPY lavoro.
- [AUTOON |OFF]
-
Clausola che indica se i dati Amazon S3 vengono caricati automaticamente nelle tabelle Amazon Redshift.
Quando
ON, Amazon Redshift monitora il percorso Amazon S3 di origine per i file appena creati e, se trovato, viene eseguito un COPY comando con i COPY parametri nella definizione del processo. Questa è l'impostazione predefinita.Quando
OFF, Amazon Redshift non viene eseguito automaticamente. COPY JOB
Note per l'utilizzo
Le opzioni del COPY comando vengono convalidate solo in fase di esecuzione. Ad esempio, un'origine dati non valida IAM_ROLE o Amazon S3 genera errori di runtime all'avvio COPYJOB.
Se il cluster è in pausa, non COPY JOBS vengono eseguiti.
Per interrogare i file di COPY comando caricati e gli errori di caricamento, consultaSTL_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 file COPY JOB per caricare 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;
