本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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\_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>

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

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

以下是必要輸出參數：

?  
輸出錯誤訊息的參數標記。資料類型為 `varchar`。

以下是必要輸入參數：

{{alias}}  
用於存取 Amazon S3 儲存貯體中遠端儲存體的別名。資料類型為 `varchar`。

{{s3\_bucket\_name}}  
存放資料的 Amazon S3 儲存貯體之名稱。資料類型為 `varchar`。

{{grantee\_type}}  
要接收授權的承授者之類型。資料類型為 `varchar`。有效值：`USER`、`GROUP`。

{{grantee}}  
要接收授權的使用者或群組。資料類型為 `varchar`。

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

Amazon RDS 會在您新增至 RDS for Db2 資料庫執行個體的 IAM 角色中包含目錄化別名。如果您從資料庫執行個體中移除 IAM 角色，則 Amazon RDS 會刪除別名。如需詳細資訊，請參閱[透過 Amazon S3 將 Db2 資料遷移至 Amazon RDS for Db2](db2-migration-load-from-s3.md)。

如需檢查編目別名狀態的詳細資訊，請參閱 [rdsadmin.get\_task\_status](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\_storage\_access
<a name="db2-sp-uncatalog-storage-access"></a>

移除儲存體存取別名。

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

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

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

以下是必要輸出參數：

?  
輸出錯誤訊息的參數標記。資料類型為 `varchar`。

以下是必要輸入參數：

{{alias}}  
要移除的儲存體別名之名稱。資料類型為 `varchar`。

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

如需檢查移除別名狀態的相關資訊，請參閱 [rdsadmin.get\_task\_status](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')"
```