Références de fonctions - Amazon Relational Database Service
aws_s3.table_import_from_s3aws_commons.create_s3_uriaws_commons.create_aws_credentials

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 vers une table Amazon RDS. 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 rôle IAM pour le l'instance de base de données PostgreSQL.

    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 pas de rôle IAM.

    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 base de données PostgreSQL dans laquelle importer les données.

column_list

Chaîne de texte obligatoire contenant la liste facultative des colonnes de la table de base de données PostgreSQL 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 commande COPY de PostgreSQL. Ces arguments spécifient la façon dont les données sont copiées dans la table PostgreSQL. Pour plus d'informations, consultez la documentation sur la commande COPY de PostgreSQL.

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 – Région AWS dans laquelle se trouve le fichier. Pour obtenir la liste des noms de régions AWS et les valeurs associées, consultez Ré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. Sous cette forme, l'accès à Amazon S3 est fourni par un rôle IAM sur l'instance de base de données PostgreSQL.

    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 l'emplacement de la Région AWS du fichier. Pour obtenir la liste des noms de Région AWS et les valeurs associées, consultez Ré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 est NULL.

secret_key

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

session_token

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

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

Chaîne de texte obligatoire contenant la Région AWS dans laquelle se trouve le fichier. Pour obtenir la liste des noms de Région AWS et les valeurs associées, consultez Ré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 est NULL.

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 est NULL.

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 est NULL. Si vous saisissez le paramètre session_token facultatif, vous pouvez utiliser les informations d'identification temporaires.