Références de fonctions - Amazon Relational Database Service

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.

Références de fonctions

aws_s3.table_import_from_s3

Importe les données Amazon S3 dans une RDS table SQL Amazon . L'extension aws_s3 fournit la fonction aws_s3.table_import_from_s3. La valeur renvoyée est du texte.

Syntaxe

Les paramètres requis sont table_name, column_list et options. Ils identifient la table de base de données et spécifient la façon dont les données sont copiées dans la table.

Vous pouvez également utiliser les paramètres suivants :

  • Le paramètre s3_info spécifie le fichier Amazon S3 à importer. Lorsque vous utilisez ce paramètre, l'accès à Amazon S3 est fourni par un IAM rôle pour l'instance de SQL de base de données Postgre.

    aws_s3.table_import_from_s3 ( table_name text, column_list text, options text, s3_info aws_commons._s3_uri_1 )
  • Le paramètre credentials spécifie les informations d'identification permettant d'accéder à Amazon S3. Lorsque vous utilisez ce paramètre, vous n'utilisez aucun IAM rôle.

    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 )

Paramètres

table_name

Chaîne de texte obligatoire contenant le nom de la table de SQL base de données Postgre dans laquelle les données doivent être importées.

column_list

Chaîne de texte obligatoire contenant une liste facultative des colonnes de la table de SQL base de données Postgre dans lesquelles copier les données. Si la chaîne est vide, toutes les colonnes de la table sont utilisées. Pour obtenir un exemple, veuillez consulter Importation d'un fichier Amazon S3 qui utilise un délimiteur personnalisé.

options

Chaîne de texte obligatoire contenant les arguments de la SQL COPY commande Postgre. Ces arguments indiquent comment les données doivent être copiées dans la SQL table Postgre. Pour plus de détails, consultez la SQLCOPYdocumentation Postgre.

s3_info

Type composite aws_commons._s3_uri_1 contenant les informations suivantes sur l'objet S3 :

  • bucket – Nom du compartiment Amazon S3 contenant le fichier.

  • file_path – Nom du fichier Amazon S3, avec le chemin d'accès à celui-ci.

  • region— Le AWS Région dans laquelle se trouve le fichier. Pour une liste des AWS Noms de régions et valeurs associées, voirRégions, zones de disponibilité et zones locales.

credentials

Type composite aws_commons._aws_credentials_1 contenant les informations d'identification suivantes à utiliser pour l'opération d'importation :

  • Clé d'accès

  • Clé secrète

  • Jeton de session

Pour plus d'informations sur la création d'une structure composite aws_commons._aws_credentials_1, veuillez consulter aws_commons.create_aws_credentials.

Syntaxe alternative

Pour faciliter le test, vous pouvez utiliser un ensemble étendu de paramètres au lieu des paramètres s3_info et credentials. Plusieurs variations de syntaxe supplémentaires pour la fonction aws_s3.table_import_from_s3 sont fournies ci-dessous.

  • Au lieu d'utiliser le paramètre s3_info pour identifier un fichier Amazon S3, utilisez la combinaison des paramètres bucket, file_path et region. Avec cette forme de fonction, l'accès à Amazon S3 est fourni par un IAM rôle sur l'SQLinstance de base de données Postgre.

    aws_s3.table_import_from_s3 ( table_name text, column_list text, options text, bucket text, file_path text, region text )
  • Au lieu d'utiliser le paramètre credentials pour spécifier l'accès à Amazon S3, utilisez la combinaison des paramètres access_key, session_key et 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 )

Autres paramètres

bucket

Chaîne de texte comportant le nom du compartiment Amazon S3 qui contient le fichier.

file_path

Chaîne de texte contenant le nom du fichier Amazon S3, avec le chemin d'accès à celui-ci.

region

Une chaîne de texte identifiant le Région AWS emplacement du fichier. Pour une liste des Région AWS noms et valeurs associées, voirRégions, zones de disponibilité et zones locales.

access_key

Chaîne de texte contenant la clé d'accès à utiliser pour l'opération d'importation. La valeur par défaut estNULL.

secret_key

Chaîne de texte contenant la clé secrète à utiliser pour l'opération d'importation. La valeur par défaut estNULL.

session_token

(Facultatif) Chaîne de texte contenant la clé de session à utiliser pour l'opération d'importation. La valeur par défaut estNULL.

aws_commons.create_s3_uri

Crée une structure aws_commons._s3_uri_1 pour contenir les informations relatives au fichier Amazon S3. Utilisez les résultats de la fonction aws_commons.create_s3_uri dans le paramètre s3_info de la fonction aws_s3.table_import_from_s3.

Syntaxe

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

Paramètres

bucket

Chaîne de texte obligatoire contenant le nom du compartiment Amazon S3 pour le fichier.

file_path

Chaîne de texte obligatoire contenant le nom du fichier Amazon S3, avec le chemin d'accès à celui-ci.

region

Une chaîne de texte obligatoire contenant Région AWS dans lequel se trouve le fichier. Pour une liste des Région AWS noms et valeurs associées, voirRégions, zones de disponibilité et zones locales.

aws_commons.create_aws_credentials

Définit une clé d'accès et une clé secrète dans une structure aws_commons._aws_credentials_1. Utilisez les résultats de la fonction aws_commons.create_aws_credentials dans le paramètre credentials de la fonction aws_s3.table_import_from_s3.

Syntaxe

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

Paramètres

access_key

Chaîne de texte obligatoire contenant la clé d'accès à utiliser pour l'importation d'un fichier Amazon S3. La valeur par défaut estNULL.

secret_key

Chaîne de texte obligatoire contenant la clé secrète à utiliser pour l'importation d'un fichier Amazon S3. La valeur par défaut estNULL.

session_token

Chaîne de texte facultative contenant le jeton de session à utiliser pour l'importation d'un fichier Amazon S3. La valeur par défaut estNULL. Si vous saisissez le paramètre session_token facultatif, vous pouvez utiliser les informations d'identification temporaires.