Funktionsreferenz - Amazon Relational Database Service
aws_s3.table_import_from_s3aws_commons.create_s3_uriaws_commons.create_aws_credentials

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.

Funktionsreferenz

aws_s3.table_import_from_s3

Importiert Amazon S3-Daten in eine Amazon RDS-Tabelle. Die Erweiterung aws_s3 stellt die Funktion aws_s3.table_import_from_s3 bereit. Der Rückgabewert ist Text.

Syntax

Die erforderlichen Parameter sind table_name, column_list und options. Diese Parameter identifizieren die Datenbanktabelle und geben an, wie die Daten in die Tabelle kopiert werden.

Sie können auch die folgenden Parameter verwenden:

  • Die zu importierende Amazon S3-Datei wird mit dem Parameter s3_info übergeben. Wenn Sie diesen Parameter verwenden, wird der Zugriff auf Amazon S3 von einer IAM-Rolle für die PostgreSQL DB--Instance bereitgestellt.

    aws_s3.table_import_from_s3 (
   table_name text, 
   column_list text, 
   options text, 
   s3_info aws_commons._s3_uri_1
)

  • Die Anmeldeinformationen für den Zugriff auf Amazon S3 werden mit dem Parameter credentials übergeben. Mit diesem Parameter verwenden Sie keine IAM-Rolle.

    aws_s3.table_import_from_s3 (
   table_name text, 
   column_list text, 
   options text, 
   s3_info aws_commons._s3_uri_1,
   credentials aws_commons._aws_credentials_1
)

Parameter

table_name

Eine erforderliche Textzeichenfolge mit dem Namen der PostgreSQL-Datenbanktabelle, in die die Daten importiert werden sollen.

column_list

Eine erforderliche Textzeichenfolge mit einer optionalen Liste der Tabellenspalten der PostgreSQL-Datenbank, in die die Daten kopiert werden sollen. Wenn die Zeichenfolge leer ist, werden alle Spalten der Tabelle verwendet. Ein Beispiel finden Sie unter Importieren einer Amazon S3-Datei, die ein benutzerdefiniertes Trennzeichen verwendet.

options

Eine erforderliche Textzeichenfolge mit Argumenten für den PostgreSQL COPY-Befehl. Diese Parameter legen fest, wie die Daten in die PostgreSQL-Tabelle kopiert werden. Weitere Informationen finden Sie in der PostgreSQL COPY-Dokumentation.

s3_info

Ein zusammengesetzter aws_commons._s3_uri_1-Typ mit den folgenden Informationen zum S3-Objekt:

  • bucket – Der Name des Amazon S3-Buckets, der die Datei enthält.

  • file_path – Der Amazon S3-Dateiname einschließlich des Pfads der Datei.

  • regionDie AWS-Region, in der sich die Datei befindet. Eine Liste der AWS-Regionsnamen und der zugehörigen Werte finden Sie unter Regionen, Availability Zones und Local Zones.

Anmeldedaten

Ein zusammengesetzter aws_commons._aws_credentials_1-Typ mit den folgenden Anmeldeinformationen, die für den Importvorgang verwendet werden sollen:

  • Zugriffsschlüssel

  • Geheimschlüssel

  • Sitzungs-Token

Hinweise zum Erstellen einer zusammengesetzten aws_commons._aws_credentials_1-Struktur finden Sie unter aws_commons.create_aws_credentials.

Alternative Syntax

Zum Testen können Sie statt der Parameter s3_info und credentials eine erweiterte Gruppe von Parametern verwenden. Nachfolgend sind weitere Syntaxvariationen für die Funktion aws_s3.table_import_from_s3 aufgeführt:

  • Statt den Parameter s3_info zum Identifizieren einer Amazon S3-Datei zu verwenden, nutzen Sie die Kombination aus den Parametern bucket, file_path und region. Mit dieser Form der Funktion wird der Zugriff auf Amazon S3 mit einer IAM-Rolle für die PostgreSQL-DB-Instance bereitgestellt.

    aws_s3.table_import_from_s3 (
   table_name text, 
   column_list text, 
   options text, 
   bucket text, 
   file_path text, 
   region text 
)

  • Statt den Parameter credentials zum Angeben einer Amazon S3-Datei zu verwenden, nutzen Sie die Kombination aus den Parametern access_key, session_key und session_token.

    aws_s3.table_import_from_s3 (
   table_name text, 
   column_list text, 
   options text, 
   bucket text, 
   file_path text, 
   region text, 
   access_key text, 
   secret_key text, 
   session_token text 
)

Alternative Parameter

bucket

Eine Textzeichenfolge mit den Namen des Amazon S3-Buckets, der die Datei enthält.

file_path

Eine Textzeichenfolge, die den Amazon S3-Dateinamen einschließlich des Pfades der Datei enthält.

Region

Eine Textzeichenfolge, die den AWS-Region-Speicherort der Datei kennzeichnet. Eine Liste der AWS-Region-Namen und der zugehörigen Werte finden Sie unter Regionen, Availability Zones und Local Zones.

access_key

Eine Textzeichenfolge mit dem Zugriffsschlüssel, der für den Importvorgang verwendet werden soll. Der Standardwert ist „NULL“.

secret_key

Eine Textzeichenfolge mit dem Geheimschlüssel, der für den Importvorgang verwendet werden soll. Der Standardwert ist „NULL“.

session_token

(Optional) Eine Textzeichenfolge mit dem Sitzungsschlüssel, der für den Importvorgang verwendet werden soll. Der Standardwert ist „NULL“.

aws_commons.create_s3_uri

Erstellt eine aws_commons._s3_uri_1-Struktur für die Amazon S3-Dateiinformationen. Die Ergebnisse der Funktion aws_commons.create_s3_uri werden im Parameter s3_info der Funktion aws_s3.table_import_from_s3 verwendet.

Syntax

aws_commons.create_s3_uri(
   bucket text,
   file_path text,
   region text
)

Parameter

bucket

Eine erforderliche Textzeichenfolge mit dem Namen des Amazon S3-Buckets für die Datei.

file_path

Eine erforderliche Textzeichenfolge, die den Amazon S3-Dateinamen einschließlich des Pfads der Datei enthält.

Region

Eine erforderliche Textzeichenfolge mit der AWS-Region, in der sich die Datei befindet. Eine Liste der AWS-Region-Namen und der zugehörigen Werte finden Sie unter Regionen, Availability Zones und Local Zones.

aws_commons.create_aws_credentials

Legt einen Zugriffs- und einen Geheimschlüssel in einer aws_commons._aws_credentials_1-Struktur fest. Die Ergebnisse der Funktion aws_commons.create_aws_credentials werden im Parameter credentials der Funktion aws_s3.table_import_from_s3 verwendet.

Syntax

aws_commons.create_aws_credentials(
   access_key text,
   secret_key text,
   session_token text
)

Parameter

access_key

Eine erforderliche Textzeichenfolge mit dem Zugriffsschlüssel, der zum Importieren einer Amazon S3-Datei verwendet werden soll. Der Standardwert ist „NULL“.

secret_key

Eine erforderliche Textzeichenfolge mit dem Geheimschlüssel, der zum Importieren einer Amazon S3-Datei verwendet werden soll. Der Standardwert ist „NULL“.

session_token

Eine erforderliche Textzeichenfolge mit dem Sitzungs-Token, der zum Importieren einer Amazon S3-Datei verwendet werden soll. Der Standardwert ist „NULL“. Wenn Sie ein optionales session_token angeben, können Sie temporäre Anmeldeinformationen verwenden.