Amazon Redshift unterstützt ab Patch 198 nicht mehr die Erstellung neuer Python-UDFs. Bestehende Python-UDFs werden bis zum 30. Juni 2026 weiterhin funktionieren. Weitere Informationen finden Sie im [Blog-Posting](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/).
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.
# COPY
| |
| --- |
| Client-side Die Verschlüsselung für COPY- und UNLOAD-Befehle steht Neukunden ab dem 30. April 2025 nicht mehr zur Verfügung. Wenn Sie in den 12 Monaten vor dem 30. April 2025 die clientseitige Verschlüsselung für die Befehle COPY und UNLOAD verwendet haben, können Sie die clientseitige Verschlüsselung für die Befehle COPY oder UNLOAD bis zum 30. April 2026 weiter verwenden. Nach dem 30. April 2026 können Sie die clientseitige Verschlüsselung für COPY und UNLOAD nicht mehr verwenden. Wir empfehlen, so schnell wie möglich zur serverseitigen Verschlüsselung für COPY und UNLOAD zu wechseln. Wenn Sie die serverseitige Verschlüsselung für COPY und UNLOAD bereits verwenden, ändert sich nichts und Sie können sie weiterhin verwenden, ohne Ihre Abfragen zu ändern. Weitere Informationen zur Verschlüsselung für COPY und UNLOAD finden Sie unten im Abschnitt zum Parameter ENCRYPTED. |
Lädt Daten aus Datendateien oder aus einer Amazon-DynamoDB-Tabelle in eine Tabelle. Die Dateien können sich in einem Amazon-Simple-Storage-Service(Amazon S3)-Bucket, einem Amazon-EMR-Cluster oder auf einem Remote-Host befinden, auf den über eine Secure-Shell(SSH)-Verbindung zugegriffen wird.
**Anmerkung**
Externe Tabellen von Amazon Redshift Spectrum sind schreibgeschützt. Sie können keinen COPY-Vorgang zu einer externen Tabelle ausführen.
Der COPY-Befehl fügt die Eingabedaten als zusätzliche Zeilen an die Tabelle an.
Die maximale Größe einer einzelnen Eingabezeile aus einer beliebigen Quelle beträgt 4 MB.
**Topics**
+ [Erforderliche Berechtigungen](#r_COPY-permissions)
+ [COPY-Syntax](#r_COPY-syntax)
+ [Erforderliche Parameter](#r_COPY-syntax-required-parameters)
+ [Optionale Parameter](#r_COPY-syntax-overview-optional-parameters)
+ [Nutzungshinweise und zusätzliche Ressourcen für den Befehl COPY](#r_COPY-using-the-copy-command)
+ [Befehlsbeispiele](#r_COPY-using-the-copy-command-examples)
+ [COPY JOB](r_COPY-JOB.md)
+ [Mit SCHABLONE KOPIEREN](r_COPY-WITH-TEMPLATE.md)
+ [COPY-Parameterreferenz](r_COPY-parameters.md)
+ [Nutzungshinweise](r_COPY_usage_notes.md)
+ [Beispiele für COPY](r_COPY_command_examples.md)
## Erforderliche Berechtigungen
Um den COPY-Befehl verwenden zu können, benötigen Sie das [INSERT](r_GRANT.md#grant-insert)-Recht für die Amazon-Redshift-Tabelle.
## COPY-Syntax
```
COPY table-name
[ column-list ]
FROM data_source
authorization
[ [ FORMAT ] [ AS ] data_format ]
[ parameter [ argument ] [, ... ] ]
```
Sie können COPY-Operationen mit nur drei Parametern ausführen: Tabellenname, Datenquelle und Autorisierung für den Zugriff auf die Daten.
Amazon Redshift erweitert die Funktionalität des COPY-Befehls, damit Sie Daten in verschiedenen Datenformaten aus mehreren Datenquellen laden, den Zugriff auf das Laden von Daten steuern, Datentransformierungen verwalten und die Ladeoperation verwalten können.
In den folgenden Abschnitten werden die erforderlichen Parameter für den COPY-Befehl vorgestellt und die optionalen Parameter nach Funktion gruppiert. Dazu werden die einzelnen Parameter beschrieben und es wird erläutert, wie die verschiedenen Optionen zusammenwirken. Sie können auch anhand der alphabetischen Liste der Parameter direkt zur Parameterbeschreibung wechseln.
## Erforderliche Parameter
Der COPY-Befehl erfordert drei Elemente:
+ [Table Name](#r_COPY-syntax-overview-table-name)
+ [Data Source](#r_COPY-syntax-overview-data-source)
+ [Authorization](#r_COPY-syntax-overview-credentials)
Der einfachste COPY-Befehl verwendet das folgende Format.
```
COPY table-name
FROM data-source
authorization;
```
Im folgenden Beispiel wird eine Tabelle namens CATDEMO erstellt. Anschließend wird die Tabelle mit Stichprobendaten aus einer Datendatei in Amazon S3 namens geladen `category_pipe.txt`.
```
create table catdemo(catid smallint, catgroup varchar(10), catname varchar(10), catdesc varchar(50));
```
Im folgenden Beispiel ist die Datenquelle für den COPY-Befehl eine Datendatei namens `category_pipe.txt` im Ordner `tickit` eines Amazon-S3-Buckets namens `redshift-downloads`. Der COPY-Befehl ist autorisiert, über eine AWS Identity and Access Management (IAM-) Rolle auf den Amazon S3 S3-Bucket zuzugreifen. Wenn Ihr Cluster bereits eine IAM-Rolle mit Berechtigung für den Zugriff auf Amazon S3 besitzt, können Sie den Amazon-Ressourcennamen (ARN) Ihrer Rolle im folgenden COPY-Befehl einsetzen und diesen ausführen.
```
copy catdemo
from 's3://redshift-downloads/tickit/category_pipe.txt'
iam_role 'arn:aws:iam::{{}}:role/{{}}'
region 'us-east-1';
```
Vollständige Anweisungen zur Verwendung von COPY-Befehlen zum Laden von Beispieldaten, einschließlich Anweisungen zum Laden von Daten aus anderen AWS Regionen, finden Sie unter [Beispieldaten aus Amazon S3 laden](https://docs.aws.amazon.com/redshift/latest/gsg/rs-gsg-create-sample-db.html) im Amazon Redshift Getting Started Guide.
*table-name*
Der Name der Zieltabelle für den COPY-Befehl. Die Tabelle muss in der Datenbank bereits vorhanden sein. Die Tabelle kann temporär oder persistent sein. Der COPY-Befehl fügt die neuen Eingabedaten den vorhandenen Zeilen in der Tabelle an.
FROM *data-source*
Der Speicherort der Quelldaten, die in die Zieltabelle geladen werden sollen. Bei manchen Datenquellen kann eine Manifestdatei angegeben werden.
Das am häufigsten verwendete Daten-Repository sind Amazon-S3-Buckets. Außerdem können Sie Daten aus Datendateien laden, die sich in einem Amazon-EMR-Cluster, einer Amazon-EC2-Instance oder auf einem Remote-Host befinden, auf den Ihr Cluster über eine SSH-Verbindung zugreifen kann. Sie können Daten auch direkt aus einer DynamoDB-Tabelle laden.
+ [COPY aus Amazon S3](copy-parameters-data-source-s3.md)
+ [COPY aus Amazon EMR](copy-parameters-data-source-emr.md)
+ [COPY von Remote-Hosts (SSH)](copy-parameters-data-source-ssh.md)
+ [COPY aus Amazon DynamoDB](copy-parameters-data-source-dynamodb.md)
Autorisierung
Eine Klausel, die die Methode angibt, die Ihr Cluster für die Authentifizierung und Autorisierung für den Zugriff auf andere AWS Ressourcen verwendet. Der COPY-Befehl benötigt eine Autorisierung, um auf Daten in einer anderen AWS Ressource zuzugreifen, einschließlich in Amazon S3, Amazon EMR, Amazon DynamoDB und Amazon EC2. Sie können diese Autorisierung bereitstellen, indem Sie eine IAM-Rolle referenzieren, die Ihrem Cluster angefügt ist, oder indem Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel für einen IAM-Benutzer bereitstellen.
+ [Autorisierungsparameter](copy-parameters-authorization.md)
+ [Role-based Zugriffskontrolle](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based)
+ [Key-based Zugriffskontrolle](copy-usage_notes-access-permissions.md#copy-usage_notes-access-key-based)
## Optionale Parameter
Sie können optional angeben, wie COPY den Spalten in der Zieltabelle Felddaten zuweist, Quelldatenattribute definieren, damit der COPY-Befehl die Quelldaten korrekt lesen und analysieren kann, und festlegen, welche Operation der COPY-Befehl während des Ladevorgangs ausführt.
+ [Optionen für das Mapping von Spalten](copy-parameters-column-mapping.md)
+ [Datenformatparameter](#r_COPY-syntax-overview-data-format)
+ [Datenkonvertierungsparameter](#r_COPY-syntax-overview-data-conversion)
+ [Datenladeoperationen](#r_COPY-syntax-overview-data-load)
### Mapping von Spalten
Standardmäßig fügt COPY Feldwerte in derselben Reihenfolge in die Spalten der Zieltabelle ein, die die Felder in den Datendateien haben. Wenn die standardmäßige Spaltenreihenfolge nicht funktionieren wird, können Sie eine Spaltenliste angeben oder JSONPath-Ausdrücke verwenden, um den Zielspalten Quelldatenfelder zuzuweisen.
+ [Column List](copy-parameters-column-mapping.md#copy-column-list)
+ [JSONPaths File](copy-parameters-column-mapping.md#copy-column-mapping-jsonpaths)
### Datenformatparameter
Sie können Daten aus Textdateien in einem Format mit fester Breite, in einem Format mit Trennzeichen, in einem durch Komma getrennten Format (CSV) oder im JSON-Format laden. Sie können Daten auch aus Avro-Dateien laden.
Standardmäßig erwartet der COPY-Befehl, dass sich die Quelldaten in durch Zeichen getrennten Textdateien befinden. UTF-8 Das Standardtrennzeichen ist der senkrechte Strich (\|). Wenn sich die Quelldaten in einem anderen Format befinden, verwenden Sie die folgenden Parameter, um das Datenformat anzugeben.
+ [FORMAT](copy-parameters-data-format.md#copy-format)
+ [CSV](copy-parameters-data-format.md#copy-csv)
+ [DELIMITER](copy-parameters-data-format.md#copy-delimiter)
+ [FIXEDWIDTH](copy-parameters-data-format.md#copy-fixedwidth)
+ [SHAPEFILE](copy-parameters-data-format.md#copy-shapefile)
+ [AVRO](copy-parameters-data-format.md#copy-avro)
+ [JSON format for COPY](copy-parameters-data-format.md#copy-json)
+ [ENCRYPTED](copy-parameters-data-source-s3.md#copy-encrypted)
+ [BZIP2](copy-parameters-file-compression.md#copy-bzip2)
+ [GZIP](copy-parameters-file-compression.md#copy-gzip)
+ [LZOP](copy-parameters-file-compression.md#copy-lzop)
+ [PARQUET](copy-parameters-data-format.md#copy-parquet)
+ [ORC](copy-parameters-data-format.md#copy-orc)
+ [ZSTD](copy-parameters-file-compression.md#copy-zstd)
### Datenkonvertierungsparameter
Wenn COPY die Tabelle lädt, versucht der Befehl implizit, die Zeichenfolgen in den Quelldaten in den Datentyp der Zielspalte zu konvertieren. Wenn Sie eine Konvertierung angeben müssen, die sich vom Standardverhalten unterscheidet, oder wenn die Standardkonvertierung zu Fehlern führt, können Sie Datenkonvertierungen verwalten, indem Sie die folgenden Parameter angeben.
+ [ACCEPTANYDATE](copy-parameters-data-conversion.md#copy-acceptanydate)
+ [ACCEPTINVCHARS](copy-parameters-data-conversion.md#copy-acceptinvchars)
+ [BLANKSASNULL](copy-parameters-data-conversion.md#copy-blanksasnull)
+ [DATEFORMAT](copy-parameters-data-conversion.md#copy-dateformat)
+ [EMPTYASNULL](copy-parameters-data-conversion.md#copy-emptyasnull)
+ [ENCODING](copy-parameters-data-conversion.md#copy-encoding)
+ [ESCAPE](copy-parameters-data-conversion.md#copy-escape)
+ [EXPLICIT_IDS](copy-parameters-data-conversion.md#copy-explicit-ids)
+ [FILLRECORD](copy-parameters-data-conversion.md#copy-fillrecord)
+ [IGNOREBLANKLINES](copy-parameters-data-conversion.md#copy-ignoreblanklines)
+ [IGNOREHEADER](copy-parameters-data-conversion.md#copy-ignoreheader)
+ [NULL AS](copy-parameters-data-conversion.md#copy-null-as)
+ [REMOVEQUOTES](copy-parameters-data-conversion.md#copy-removequotes)
+ [ROUNDEC](copy-parameters-data-conversion.md#copy-roundec)
+ [TIMEFORMAT](copy-parameters-data-conversion.md#copy-timeformat)
+ [TRIMBLANKS](copy-parameters-data-conversion.md#copy-trimblanks)
+ [TRUNCATECOLUMNS](copy-parameters-data-conversion.md#copy-truncatecolumns)
### Datenladeoperationen
Verwalten Sie das Standardverhalten der Ladeoperation, um Fehler zu beheben oder die Ladezeiten zu reduzieren, indem Sie die folgenden Parameter angeben.
+ [COMPROWS](copy-parameters-data-load.md#copy-comprows)
+ [COMPUPDATE](copy-parameters-data-load.md#copy-compupdate)
+ [IGNOREALLERRORS](copy-parameters-data-load.md#copy-ignoreallerrors)
+ [MAXERROR](copy-parameters-data-load.md#copy-maxerror)
+ [NOLOAD](copy-parameters-data-load.md#copy-noload)
+ [STATUPDATE](copy-parameters-data-load.md#copy-statupdate)
## Nutzungshinweise und zusätzliche Ressourcen für den Befehl COPY
Weitere Informationen zur Verwendung des COPY-Befehls finden Sie in den folgenden Themen:
+ [Nutzungshinweise](r_COPY_usage_notes.md)
+ [Tutorial: So laden Sie Daten aus Amazon S3](tutorial-loading-data.md)
+ [Bewährte Methoden für Amazon Redshift zum Laden von Daten](c_loading-data-best-practices.md)
+ [Laden von Tabellen mit dem Befehl COPY](t_Loading_tables_with_the_COPY_command.md)
+ [So laden Sie Daten aus Amazon S3](t_Loading-data-from-S3.md)
+ [So laden Sie Daten aus Amazon EMR:](loading-data-from-emr.md)
+ [Laden von Daten aus Remote-Hosts](loading-data-from-remote-hosts.md)
+ [Laden von Daten aus einer Amazon-DynamoDB-Tabelle](t_Loading-data-from-dynamodb.md)
+ [Fehlerbehebung bei Datenladevorgängen](t_Troubleshooting_load_errors.md)
## Befehlsbeispiele
Weitere Beispiele, die zeigen, wie aus verschiedenen Quellen, in unterschiedlichen Formaten und mit unterschiedlichen COPY-Optionen KOPIERT wird, finden Sie unter [Beispiele für COPY](r_COPY_command_examples.md).