COPYJOB(Vorschau) - Amazon Redshift
Erforderliche BerechtigungSyntaxParameterNutzungshinweiseBeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

COPYJOB(Vorschau)

Dies ist eine Vorabversion von autocopy (SQLCOPYJOB), die sich in der Vorabversion befindet. Sowohl die Dokumentation als auch die Funktion können sich ändern. Wir empfehlen, diese Funktion nur in Test- und nicht in Produktionsumgebungen zu verwenden. Die öffentliche Vorversion endet am 31. Oktober 2024. Vorschau-Cluster werden zwei Wochen nach dem Ende der Vorschauversion automatisch entfernt. Weitere Informationen zu den Bedingungen für Vorschauversionen finden Sie unter Betas und Vorversionen in den AWS -Servicebedingungen.

Weitere Informationen zur Verwendung dieses Befehls in der Vorschau finden Sie unter Laden von Tabellen mit kontinuierlicher Dateiaufnahme aus Amazon S3 (Vorschau).

Verwaltet COPY Befehle, die Daten in eine Tabelle laden. Der COPY JOB Befehl ist eine Erweiterung des COPY Befehls und automatisiert das Laden von Daten aus Amazon S3 S3-Buckets. Wenn Sie einen COPY Job erstellen, erkennt Amazon Redshift, wenn neue Amazon S3 S3-Dateien in einem angegebenen Pfad erstellt werden, und lädt sie dann automatisch, ohne dass Sie eingreifen müssen. Beim Laden der Daten werden dieselben Parameter verwendet, die im ursprünglichen COPY Befehl verwendet wurden. Amazon Redshift verfolgt die geladenen Dateien, um sicherzustellen, dass sie nur einmal geladen werden.

Anmerkung

Informationen zum COPY Befehl, einschließlich Verwendung, Parametern und Berechtigungen, finden Sie unterCOPY.

Erforderliche Berechtigung

Um den COPY Befehl von a ausführen zu können COPYJOB, müssen Sie das INSERT Recht haben, die Tabelle zu laden.

Die mit dem COPY Befehl angegebene IAM Rolle muss berechtigt sein, auf die zu ladenden Daten zuzugreifen. Weitere Informationen finden Sie unter IAMBerechtigungen für COPYUNLOAD, und CREATE LIBRARY.

Syntax

Erstellen eines Kopierauftrags. Die Parameter des COPY Befehls werden zusammen mit dem Kopierauftrag gespeichert.

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

Ändern der Konfiguration eines Kopierauftrags.

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

Ausführen eines Kopierauftrags. Die gespeicherten COPY Befehlsparameter werden verwendet.

COPY JOB RUN job-name

Auflisten aller Kopieraufträge.

COPY JOB LIST

Anzeigen der Details zu dem Kopierauftrag.

COPY JOB SHOW job-name

Löschen eines Kopierauftrags.

COPY JOB DROP job-name

Parameter

copy-command

Ein COPY Befehl, der Daten von Amazon S3 nach Amazon Redshift lädt. Die Klausel enthält COPY Parameter, die den Amazon S3 S3-Bucket, die Zieltabelle, die IAM Rolle und andere Parameter definieren, die beim Laden von Daten verwendet werden. Alle COPY Befehlsparameter für das Laden von Amazon S3 S3-Daten werden unterstützt, außer:

  • Der COPY JOB nimmt keine bereits vorhandenen Dateien in dem Ordner auf, auf den der Befehl verweist. COPY Es werden nur Dateien aufgenommen, die nach dem COPY JOB Erstellungszeitstempel erstellt wurden.

  • Sie können keinen COPY Befehl mit den Optionen MAXERROR oder IGNOREALLERRORS angeben.

  • Sie können keine Manifestdatei angeben. COPYJOBerfordert einen bestimmten Amazon S3 S3-Standort, um nach neu erstellten Dateien zu suchen.

  • Sie können keinen COPY Befehl mit Autorisierungstypen wie Zugriffs- und Geheimschlüsseln angeben. Es COPY werden nur Befehle unterstützt, die den IAM_ROLE Parameter für die Autorisierung verwenden. Weitere Informationen finden Sie unter Autorisierungsparameter.

  • Die unterstützt COPY JOB nicht die dem Cluster zugeordnete IAM Standardrolle. Sie müssen das IAM_ROLE im COPY Befehl angeben.

Weitere Informationen finden Sie unter COPYvon Amazon S3.

job-name

Der Name des Jobs, der als Verweis auf den COPY Job verwendet wird.

[AUTOAN |OFF]

Klausel, die angibt, ob Amazon-S3-Daten automatisch in Amazon-Redshift-Tabellen geladen werden.

  • WennON, überwacht Amazon Redshift den Amazon S3 S3-Quellpfad auf neu erstellte Dateien, und wenn sie gefunden werden, wird ein COPY Befehl mit den COPY Parametern in der Auftragsdefinition ausgeführt. Dies ist die Standardeinstellung.

  • WannOFF, Amazon Redshift führt das nicht COPY JOB automatisch aus.

Nutzungshinweise

Die Optionen des COPY Befehls werden erst zur Laufzeit validiert. Beispielsweise führt eine ungültige IAM_ROLE oder eine Amazon S3 S3-Datenquelle zu Laufzeitfehlern beim COPY JOB Start.

Wenn der Cluster angehalten ist, COPY JOBS werden sie nicht ausgeführt.

Informationen zum Abfragen COPY geladener Befehlsdateien und Ladefehler finden Sie unter,STL_LOAD_COMMITS,STL_LOAD_ERRORS. STL_LOADERROR_DETAIL Weitere Informationen finden Sie unter Überprüfung, ob die Daten korrekt geladen wurden.

Beispiele

Das folgende Beispiel zeigt die Erstellung eines COPYJOB, um Daten aus einem Amazon S3 S3-Bucket zu laden. 

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;