

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Procédures stockées pour l’accès au stockage pour RDS for Db2
<a name="db2-sp-managing-storage-access"></a>

Les procédures stockées intégrées décrites dans cette rubrique gèrent l’accès au stockage pour les bases de données RDS for Db2 qui utilisent Amazon S3 pour la migration des données. Pour plus d’informations, consultez [Migration de données Db2 via Amazon S3 vers Amazon RDS for Db2](db2-migration-load-from-s3.md).

Reportez-vous aux procédures stockées intégrées suivantes pour obtenir des informations sur leur syntaxe, leurs paramètres, leurs notes d’utilisation et des exemples.

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

Catalogue un alias de stockage permettant d’accéder à un compartiment Amazon S3 contenant des fichiers de données Db2.

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

Les paramètres de sortie suivants sont obligatoires :

?  
Marqueur de paramètre qui génère un message d’erreur. Le type de données est `varchar`.

Les paramètres d’entrée suivants sont obligatoires :

*alias*  
Nom d’alias permettant d’accéder au stockage à distance dans un compartiment Amazon S3. Le type de données est `varchar`.

*s3\$1bucket\$1name*  
Nom du compartiment Amazon S3 dans lequel vos données résident. Le type de données est `varchar`.

*grantee\$1type*  
Type de bénéficiaire à recevoir l’autorisation. Le type de données est `varchar`. Valeurs valides : `USER`, `GROUP`.

*grantee*  
Utilisateur ou groupe devant recevoir l’autorisation. Le type de données est `varchar`. 

### Notes d’utilisation
<a name="db2-sp-catalog-storage-access-usage-notes"></a>

Amazon RDS inclut l’alias catalogué dans le rôle IAM que vous avez ajouté à votre instance de base de données RDS for Db2. Si vous supprimez le rôle IAM de votre instance de base de données, Amazon RDS supprime l’alias. Pour plus d’informations, consultez [Migration de données Db2 via Amazon S3 vers Amazon RDS for Db2](db2-migration-load-from-s3.md).

Pour plus d’informations sur la vérification du statut de catalogage de votre alias, consultez [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

L’exemple suivant enregistre un alias appelé `SAMPLE`. L’utilisateur `jorge_souza` a accès au compartiment Amazon S3 appelé `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>

Supprime un alias d’accès au stockage.

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

Les paramètres de sortie suivants sont obligatoires :

?  
Marqueur de paramètre qui génère un message d’erreur. Le type de données est `varchar`.

Le paramètre d’entrée suivant est obligatoire :

*alias*  
Nom de l’alias de stockage à supprimer. Le type de données est `varchar`.

### Notes d’utilisation
<a name="db2-sp-uncatalog-storage-access-usage-notes"></a>

Pour plus d’informations sur la vérification du statut de suppression de votre alias, consultez [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

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

L’exemple suivant supprime un alias appelé `SAMPLE`. Cet alias ne donne plus accès au compartiment Amazon S3 auquel il était associé.

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