# RDS for Db2 のストレージアクセスのストアドプロシージャ
<a name="db2-sp-managing-storage-access"></a>

このトピックで説明した組み込みのストアドプロシージャでは、Amazon S3 を使用してデータを移行する RDS for Db2 データベースのストレージアクセスを管理します。詳細については、「[Amazon S3 から Amazon RDS for Db2 への 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}}'
    )"
```

### パラメータ
<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 DB インスタンスに追加した IAM ロールにカタログ化されたエイリアスが含まれます。DB インスタンスから IAM ロールを削除すると、Amazon RDS はエイリアスを削除します。詳細については、「[Amazon S3 から Amazon RDS for Db2 への 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}}')"
```

### パラメータ
<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')"
```