# 用于 RDS for Db2 的存储访问的存储过程
<a name="db2-sp-managing-storage-access"></a>

本主题中介绍的内置存储过程可管理对使用 Amazon S3 来迁移数据的 RDS for Db2 数据库的存储访问权限。有关更多信息，请参阅 [通过 Amazon S3 将 Db2 数据迁移到 Amazon RDS for Db2](db2-migration-load-from-s3.md)。

请参阅以下内置存储过程，了解其语法、参数、用法说明和示例。

**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>

对存储别名进行编目，用于访问包含 Db2 数据文件的 Amazon S3 存储桶。

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

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

### 参数
<a name="db2-sp-catalog-storage-access-parameters"></a>

以下输出参数是必需参数：

?  
输出错误消息的参数标记。数据类型为 `varchar`。

以下输入参数是必需参数：

*alias*  
用于访问 Amazon S3 存储桶中的远程存储的别名。数据类型为 `varchar`。

*s3\$1bucket\$1name*  
数据所在的 Amazon S3 存储桶的名称。数据类型为 `varchar`。

*grantee\$1type*  
要接收授权的被授权者的类型。数据类型为 `varchar`。有效值：`USER`、`GROUP`。

*grantee*  
要接收授权的用户或组。数据类型为 `varchar`。

### 使用说明
<a name="db2-sp-catalog-storage-access-usage-notes"></a>

Amazon RDS 在 IAM 角色中包含您添加到 RDS for Db2 数据库实例的已编目别名。如果您从数据库实例中移除 IAM 角色，则 Amazon RDS 会删除该别名。有关更多信息，请参阅 [通过 Amazon S3 将 Db2 数据迁移到 Amazon RDS for Db2](db2-migration-load-from-s3.md)。

有关检查对别名编目的状态的信息，请参阅 [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status)。

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

以下示例注册一个名为 `SAMPLE` 的别名。用户 `jorge_souza` 被授予访问名为 `amzn-s3-demo-bucket` 的 Amazon S3 存储桶的权限。

```
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>

移除存储访问权限别名。

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

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

### 参数
<a name="db2-sp-uncatalog-storage-access-parameters"></a>

以下输出参数是必需参数：

?  
输出错误消息的参数标记。数据类型为 `varchar`。

以下输入参数是必需参数：

*alias*  
要删除的存储别名的名称。数据类型为 `varchar`。

### 使用说明
<a name="db2-sp-uncatalog-storage-access-usage-notes"></a>

有关检查移除别名的状态的信息，请参阅 [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status)。

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

以下示例移除一个名为 `SAMPLE` 的别名。此别名不再提供对与其关联的 Amazon S3 存储桶的访问权限。

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