COPYJOB(aperçu) - Amazon Redshift
Autorisation obligatoireSyntaxeParamètresNotes d’utilisationExemples

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

COPYJOB(aperçu)

Il s'agit de la documentation préliminaire d'autocopy (SQLCOPYJOB), qui est en version préliminaire. La documentation et la fonction sont toutes deux sujettes à modification. Nous vous recommandons d’utiliser cette fonction uniquement dans des environnements de test et non dans des environnements de production. L'avant-première publique se terminera le 31 octobre 2024. La version préliminaire des clusters sera automatiquement supprimée deux semaines après la fin de la prévisualisation. Pour voir les conditions générales, consultez Beta and Previews (Bêtas et aperçus) dans les Conditions de service AWS.

Pour plus d’informations sur l’utilisation de la compression en version préliminaire, consultez Chargement de tables avec ingestion continue de fichiers depuis Amazon S3 (version préliminaire).

Gère COPY les commandes qui chargent des données dans une table. La COPY JOB commande est une extension de la COPY commande et automatise le chargement des données à partir des compartiments Amazon S3. Lorsque vous créez une COPY tâche, Amazon Redshift détecte la création de nouveaux fichiers Amazon S3 dans un chemin spécifié, puis les charge automatiquement sans votre intervention. Les mêmes paramètres que ceux utilisés dans la COPY commande d'origine sont utilisés lors du chargement des données. Amazon Redshift assure le suivi des fichiers chargés afin de vérifier qu’ils ne sont chargés qu’une seule fois.

Note

Pour plus d'informations sur la COPY commande, notamment son utilisation, ses paramètres et ses autorisations, consultezCOPY.

Autorisation obligatoire

Pour exécuter la COPY commande d'un COPYJOB, vous devez avoir le INSERT privilège de charger la table.

Le IAM rôle spécifié par la COPY commande doit être autorisé à accéder aux données à charger. Pour de plus amples informations, veuillez consulter IAMautorisations pour COPYUNLOAD, et CREATE LIBRARY.

Syntaxe

Créez une tâche de copie. Les paramètres de la COPY commande sont enregistrés avec la tâche de copie.

COPY copy-command JOB CREATE job-name
[AUTO ON | OFF]

Modifiez la configuration d’une tâche de copie.

COPY JOB ALTER job-name
[AUTO ON | OFF]

Exécutez une tâche de copie. Les paramètres de COPY commande enregistrés sont utilisés.

COPY JOB RUN job-name

Répertoriez toutes les tâches de copie.

COPY JOB LIST

Afficher les détails d’une tâche de copie.

COPY JOB SHOW job-name

Supprimez une tâche de copie.

COPY JOB DROP job-name

Paramètres

copy-command

COPYCommande qui charge des données depuis Amazon S3 vers Amazon Redshift. La clause contient des COPY paramètres qui définissent le compartiment Amazon S3, la table cible, IAM le rôle et les autres paramètres utilisés lors du chargement des données. Tous les paramètres de COPY commande pour un chargement de données Amazon S3 sont pris en charge, à l'exception des suivants :

  • COPYJOBN'ingère pas les fichiers préexistants dans le dossier pointé par la COPY commande. Seuls les fichiers créés après l'horodatage de COPY JOB création sont ingérés.

  • Vous ne pouvez pas spécifier de COPY commande avec les IGNOREALLERRORS options MAXERROR ou.

  • Vous ne pouvez pas spécifier un fichier manifeste. COPYJOBnécessite un emplacement Amazon S3 désigné pour surveiller les fichiers nouvellement créés.

  • Vous ne pouvez pas spécifier une COPY commande avec des types d'autorisation tels que les clés d'accès et les clés secrètes. Seules COPY les commandes qui utilisent le IAM_ROLE paramètre pour l'autorisation sont prises en charge. Pour de plus amples informations, veuillez consulter Paramètres d’autorisation.

  • COPYJOBne prend pas en charge le IAM rôle par défaut associé au cluster. Vous devez le spécifier IAM_ROLE dans la COPY commande.

Pour de plus amples informations, veuillez consulter COPYdepuis Amazon S3.

job-name

Le nom de la tâche utilisée pour faire référence à la COPY tâche.

[AUTOSUR |OFF]

Clause indiquant si les données Amazon S3 sont automatiquement chargées dans les tables Amazon Redshift.

  • Lorsque ON Amazon Redshift surveille le chemin source Amazon S3 pour les fichiers nouvellement créés, et s'il est trouvé, une COPY commande est exécutée avec les COPY paramètres de la définition de tâche. Il s’agit de l’option par défaut.

  • Lorsque OFF Amazon Redshift ne l'exécute pas automatiquement. COPY JOB

Notes d’utilisation

Les options de la COPY commande ne sont validées qu'au moment de l'exécution. Par exemple, une source de données non valide IAM_ROLE ou une source de données Amazon S3 entraîne des erreurs d'exécution au COPY JOB démarrage.

Si le cluster est suspendu, COPY JOBS ils ne sont pas exécutés.

Pour interroger les fichiers de COPY commandes chargés et les erreurs de chargementSTL_LOAD_COMMITS, voirSTL_LOAD_ERRORS,STL_LOADERROR_DETAIL. Pour de plus amples informations, veuillez consulter Vérification que les données ont été chargées correctement.

Exemples

L'exemple suivant montre la création d'un COPY JOB pour charger des données depuis un compartiment 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;