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 S3-Daten in eine . 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 durch eine IAM Rolle für die SQL 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. Wenn Sie diesen Parameter verwenden, 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, die den Namen der SQL Postgre-Datenbanktabelle enthält, in die die Daten importiert werden sollen.

column_list

Eine erforderliche Textzeichenfolge, die eine optionale Liste der Spalten der SQL Postgre-Datenbanktabelle enthält, 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 Postgre-Befehl. SQL COPY Diese Argumente geben an, wie die Daten in die SQL Postgre-Tabelle kopiert werden sollen. Weitere Informationen finden Sie in der Postgre-Dokumentation. SQL COPY

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.

  • region— Das AWS Region, in der sich die Datei befindet. Für eine Liste von AWS Regionsnamen und zugehörige Werte finden Sie unterRegionen, 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. Bei dieser Form der Funktion wird der Zugriff auf Amazon S3 über eine IAM Rolle in der SQL Postgre-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 identifiziert AWS-Region Speicherort der Datei. Für eine Liste von AWS-Region Namen und zugehörige Werte finden Sie unterRegionen, Availability Zones und Local Zones.

access_key

Eine Textzeichenfolge mit dem Zugriffsschlüssel, der für den Importvorgang verwendet werden soll. Die Standardeinstellung istNULL.

secret_key

Eine Textzeichenfolge mit dem Geheimschlüssel, der für den Importvorgang verwendet werden soll. Die Standardeinstellung istNULL.

session_token

(Optional) Eine Textzeichenfolge mit dem Sitzungsschlüssel, der für den Importvorgang verwendet werden soll. Die Standardeinstellung istNULL.

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, die Folgendes enthält AWS-Region in dem sich die Datei befindet. Für eine Liste von AWS-Region Namen und zugehörige Werte finden Sie unterRegionen, 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. Die Standardeinstellung istNULL.

secret_key

Eine erforderliche Textzeichenfolge mit dem Geheimschlüssel, der zum Importieren einer Amazon S3-Datei verwendet werden soll. Die Standardeinstellung istNULL.

session_token

Eine erforderliche Textzeichenfolge mit dem Sitzungs-Token, der zum Importieren einer Amazon S3-Datei verwendet werden soll. Die Standardeinstellung istNULL. Wenn Sie ein optionales session_token angeben, können Sie temporäre Anmeldeinformationen verwenden.