# Procedimentos armazenados para acesso ao armazenamento do RDS para Db2
<a name="db2-sp-managing-storage-access"></a>

Os procedimentos integrados armazenados descritos neste tópico gerenciam o acesso ao armazenamento para bancos de dados do RDS para Db2 que usam o Amazon S3 para migrar dados. Para ter mais informações, consulte [Migrar dados do Db2 por meio do Amazon S3 para o Amazon RDS para Db2](db2-migration-load-from-s3.md).

Consulte os seguintes procedimentos integrados armazenados para obter informações sobre sintaxe, parâmetros, notas de uso e exemplos.

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

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

Cataloga um alias de armazenamento para acessar um bucket do Amazon S3 com arquivos de dados do Db2.

### Sintaxe
<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>

O seguinte parâmetro de saída é obrigatório:

?  
Um marcador de parâmetro que gera uma mensagem de erro. O tipo de dados é `varchar`.

Os seguintes parâmetros de entrada são obrigatórios:

{{alias}}  
O alias para acessar o armazenamento remoto em um bucket do Amazon S3. O tipo de dados é `varchar`.

{{s3\_bucket\_name}}  
O nome do bucket do Amazon S3 onde residem os dados. O tipo de dados é `varchar`.

{{grantee\_type}}  
O tipo do favorecido a receber autorização. O tipo de dados é `varchar`. Valores válidos: `USER`, `GROUP`.

{{grantee}}  
O usuário ou o grupo para receber autorização. O tipo de dados é `varchar`. 

### Observações de uso
<a name="db2-sp-catalog-storage-access-usage-notes"></a>

O Amazon RDS inclui o alias catalogado no perfil do IAM que você adicionou à instância de banco de dados do RDS para Db2. Se você remover o perfil do IAM da instância de banco de dados, o Amazon RDS excluirá o alias. Para ter mais informações, consulte [Migrar dados do Db2 por meio do Amazon S3 para o Amazon RDS para Db2](db2-migration-load-from-s3.md).

Para ter informações sobre como conferir o status da catalogação do alias, consulte [rdsadmin.get\_task\_status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

O exemplo a seguir registra um alias chamado `SAMPLE`. O usuário `jorge_souza` recebe acesso ao bucket do Amazon S3 chamado `amzn-s3-demo-bucket`.

```
db2 "call rdsadmin.catalog_storage_access(
    ?,
    'SAMPLE', 
    'amzn-s3-demo-bucket', 
    'USER', 
    'jorge_souza')"
```

## rdsadmin.uncatalog\_storage\_access
<a name="db2-sp-uncatalog-storage-access"></a>

Remove um alias de acesso ao armazenamento.

### Sintaxe
<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>

O seguinte parâmetro de saída é obrigatório:

?  
Um marcador de parâmetro que gera uma mensagem de erro. O tipo de dados é `varchar`.

O seguinte parâmetro de entrada é obrigatório:

{{alias}}  
O nome do alias de armazenamento a ser removido. O tipo de dados é `varchar`.

### Observações de uso
<a name="db2-sp-uncatalog-storage-access-usage-notes"></a>

Para ter informações sobre como conferir o status de remoção do alias, consulte [rdsadmin.get\_task\_status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

O exemplo a seguir remove um alias chamado `SAMPLE`. Esse alias não concede mais acesso ao bucket do Amazon S3 ao qual estava associado.

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