Procedimientos almacenados de acceso al almacenamiento de RDS para Db2
Los procedimientos almacenados que se describen en este tema administran el acceso al almacenamiento para bases de datos de RDS para Db2 que utilizan Amazon S3 para la migración de datos. Para obtener más información, consulte Migración de datos de Db2 mediante Amazon S3 a Amazon RDS para Db2.
Consulte los siguientes procedimientos almacenados integrados para obtener información sobre su sintaxis, parámetros, notas de uso y ejemplos.
Procedimientos almacenados
rdsadmin.catalog_storage_access
Cataloga un alias de almacenamiento para acceder a un bucket de Amazon S3 con archivos de datos de Db2.
Sintaxis
db2 "call rdsadmin.catalog_storage_access( ?, 'alias', 's3_bucket_name', 'grantee_type', 'grantee' )"
Parámetros
El siguiente parámetro de salida es obligatorio:
- ?
-
Un marcador de parámetros que genera un mensaje de error. El tipo de datos es
varchar.
Se requieren los siguientes parámetros de entrada:
alias-
El alias para acceder al almacenamiento remoto en un bucket de Amazon S3. El tipo de datos es
varchar. s3_bucket_name-
El nombre del bucket de Amazon S3 donde residen sus datos. El tipo de datos es
varchar. grantee_type-
El tipo de beneficiario de la concesión que recibirá la autorización. El tipo de datos es
varchar. Valores válidos:USER,GROUP. grantee-
El usuario o el grupo que recibirá la autorización. El tipo de datos es
varchar.
Notas de uso
Amazon RDS incluye el alias catalogado en el rol de IAM que agregó a su instancia de base de datos de RDS para Db2. Si elimina el rol de IAM de la instancia de base de datos, Amazon RDS elimina el alias. Para obtener más información, consulte Migración de datos de Db2 mediante Amazon S3 a Amazon RDS para Db2.
Para obtener más información sobre cómo comprobar el estado de catalogación de su alias, consulte rdsadmin.get_task_status.
Ejemplos
En el siguiente ejemplo se registra un alias denominado SAMPLE. Al usuario jorge_souza se le concede acceso al bucket de Amazon S3 denominado amzn-s3-demo-bucket.
db2 "call rdsadmin.catalog_storage_access( ?, 'SAMPLE', 'amzn-s3-demo-bucket', 'USER', 'jorge_souza')"
rdsadmin.uncatalog_storage_access
Elimina un alias de acceso al almacenamiento.
Sintaxis
db2 "call rdsadmin.uncatalog_storage_access( ?, 'alias')"
Parámetros
El siguiente parámetro de salida es obligatorio:
- ?
-
Un marcador de parámetros que genera un mensaje de error. El tipo de datos es
varchar.
El siguiente parámetro de entrada es obligatorio:
alias-
El nombre del alias de almacenamiento que se va a eliminar. El tipo de datos es
varchar.
Notas de uso
Para obtener más información sobre cómo comprobar el estado de eliminación de un alias, consulte rdsadmin.get_task_status.
Ejemplos
En el siguiente ejemplo se elimina un alias denominado SAMPLE. Este alias ya no proporciona acceso al bucket de Amazon S3 al que estaba asociado.
db2 "call rdsadmin.uncatalog_storage_access( ?, 'SAMPLE')"
