Referencia de funciones - Amazon Relational Database Service
aws_s3.table_import_from_s3aws_commons.create_s3_uriaws_commons.create_aws_credentials

Referencia de funciones

aws_s3.table_import_from_s3

Importa datos de Amazon S3 en una tabla Amazon RDS. La extensión aws_s3 proporciona la función aws_s3.table_import_from_s3. El valor de devolución es texto.

Sintaxis

Los parámetros obligatorios son table_name, column_list y options. Estos identifican la tabla de la base de datos y especifican cómo se copian los datos en la tabla.

Asimismo, puede utilizar los siguientes parámetros:

  • El parámetro s3_info especifica el archivo Amazon S3 que se va a importar. Cuando utilice este parámetro, se proporciona acceso a Amazon S3 mediante un rol de IAM para la instancia de base de datos de PostgreSQL.

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

  • El parámetro credentials especifica las credenciales para acceder a Amazon S3. Cuando utilice este parámetro, no utilice un rol de 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
)

Parámetros

table_name

Cadena de texto obligatoria que contiene el nombre de la tabla de la base de datos de PostgreSQL a la que importar los datos.

column_list

Cadena de texto obligatoria que contiene una lista opcional de las columnas de la tabla de la base de datos de PostgreSQL en la que se copiarán los datos. Si la cadena está vacía, se utilizan todas las columnas de la tabla. Para ver un ejemplo, consulte Importación de un archivo de Amazon S3 que utiliza un delimitador personalizado.

options

Cadena de texto obligatoria que contiene argumentos para el comando COPY de PostgreSQL. Estos argumentos especifican cómo se copian los datos en la tabla PostgreSQL. Para obtener más detalles, consulte la documentación de COPY de PostgreSQL.

s3_info

Tipo compuesto aws_commons._s3_uri_1 que contiene la siguiente información sobre el objeto de S3:

  • bucket: el nombre del bucket de Amazon S3 que contiene el archivo.

  • file_path –: la ruta de Amazon S3 del archivo.

  • region: la región de AWS en la que se encuentra el archivo. Para ver una lista de los nombres de regiones de AWS y los valores asociados, consulte Regiones, zonas de disponibilidad y Local Zones.

credenciales

Tipo compuesto aws_commons._aws_credentials_1 que contiene las siguientes credenciales para usar en la operación de importación:

  • Clave de acceso

  • Clave secreta

  • Token de sesión

Para obtener información sobre la creación de una estructura compuesta aws_commons._aws_credentials_1, consulte aws_commons.create_aws_credentials.

Sintaxis alternativa

Como ayuda en las pruebas, puede utilizar un conjunto de parámetros expandido en lugar de los parámetros s3_info y credentials. A continuación, se incluyen variaciones de sintaxis adicionales para la función:aws_s3.table_import_from_s3

  • En lugar de utilizar el parámetro s3_info para identificar un archivo de Amazon S3, utilice la combinación de los parámetros bucket, file_path y region. Con esta forma de la función, se facilita acceso a Amazon S3 mediante un rol de IAM en la instancia de base de datos de PostgreSQL.

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

  • En lugar de utilizar el parámetro credentials para especificar el acceso a Amazon S3, utilice la combinación de parámetros access_key, session_key y 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 
)

Parámetros alternativos

bucket

Cadena de texto que incluye el nombre del bucket de Amazon S3 que contiene el archivo.

file_path

Cadena de texto que contiene la ruta de Amazon S3 del archivo.

region

Una cadena de texto que identifique la ubicación de Región de AWS del archivo. Para ver una lista de los nombres de Región de AWS y los valores asociados, consulte Regiones, zonas de disponibilidad y Local Zones.

access_key

Cadena de texto que contiene la clave de acceso que se va a utilizar para la operación de importación. El valor predeterminado es NULL.

secret_key

Cadena de texto que contiene la clave secreta que se va a usar para la operación de importación. El valor predeterminado es NULL.

session_token

(Opcional) Cadena de texto que contiene la clave de la sesión que se va a utilizar para la operación de importación. El valor predeterminado es NULL.

aws_commons.create_s3_uri

Crea una estructura aws_commons._s3_uri_1 para contener la información de archivos de Amazon S3. Utilice los resultados de la función aws_commons.create_s3_uri en el parámetro s3_info de la función aws_s3.table_import_from_s3.

Sintaxis

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

Parámetros

bucket

Cadena de texto obligatoria que contiene el nombre del bucket de Amazon S3 del archivo.

file_path

Cadena de texto requerida que contiene la ruta de Amazon S3 del archivo.

region

Cadena de texto obligatoria que contiene la Región de AWS en la que se encuentra el archivo. Para ver una lista de los nombres de Región de AWS y los valores asociados, consulte Regiones, zonas de disponibilidad y Local Zones.

aws_commons.create_aws_credentials

Establece una clave de acceso y una clave secreta en una estructura aws_commons._aws_credentials_1. Utilice los resultados de la función aws_commons.create_aws_credentials en el parámetro credentials de la función aws_s3.table_import_from_s3.

Sintaxis

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

Parámetros

access_key

Cadena de texto obligatoria que contiene la clave de acceso que se va a utilizar para importar un archivo de Amazon S3. El valor predeterminado es NULL.

secret_key

Cadena de texto obligatoria que contiene la clave secreta que se va a utilizar para importar un archivo de Amazon S3. El valor predeterminado es NULL.

session_token

Cadena de texto opcional que contiene el token de la sesión que se va a utilizar para importar un archivo de Amazon S3. El valor predeterminado es NULL. Si facilita un session_token opcional, puede usar credenciales temporales.