# Procedimientos almacenados de acceso al almacenamiento de RDS para Db2
<a name="db2-sp-managing-storage-access"></a>

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](db2-migration-load-from-s3.md).

Consulte los siguientes procedimientos almacenados integrados para obtener información sobre su sintaxis, parámetros, notas de uso y ejemplos.

**Topics**
+ [rdsadmin.catalog\$1storage\$1access](#db2-sp-catalog-storage-access)
+ [rdsadmin.uncatalog\$1storage\$1access](#db2-sp-uncatalog-storage-access)

## rdsadmin.catalog\$1storage\$1access
<a name="db2-sp-catalog-storage-access"></a>

Cataloga un alias de almacenamiento para acceder a un bucket de Amazon S3 con archivos de datos de Db2.

### Sintaxis
<a name="db2-sp-catalog-storage-access-syntax"></a>

```
db2 "call rdsadmin.catalog_storage_access(
    ?,
    'alias',
    's3_bucket_name',
    'grantee_type',
    'grantee'
    )"
```

### Parámetros
<a name="db2-sp-catalog-storage-access-parameters"></a>

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\$1bucket\$1name*  
El nombre del bucket de Amazon S3 donde residen sus datos. El tipo de datos es `varchar`.

*grantee\$1type*  
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
<a name="db2-sp-catalog-storage-access-usage-notes"></a>

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](db2-migration-load-from-s3.md).

Para obtener más información sobre cómo comprobar el estado de catalogación de su alias, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

### Ejemplos
<a name="db2-sp-catalog-storage-access-examples"></a>

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\$1storage\$1access
<a name="db2-sp-uncatalog-storage-access"></a>

Elimina un alias de acceso al almacenamiento.

### Sintaxis
<a name="db2-sp-uncatalog-storage-access-syntax"></a>

```
db2 "call rdsadmin.uncatalog_storage_access(
    ?,
    'alias')"
```

### Parámetros
<a name="db2-sp-uncatalog-storage-access-parameters"></a>

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
<a name="db2-sp-uncatalog-storage-access-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de eliminación de un alias, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

### Ejemplos
<a name="db2-sp-uncatalog-storage-access-examples"></a>

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')"
```