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.

# Intégrer Amazon S3 Tables à AWS services d'analyse
<a name="s3-tables-integrating-aws"></a>

Cette rubrique décrit les prérequis et les procédures nécessaires pour intégrer vos compartiments de tables Amazon S3 aux services AWS d'analyse. Pour un aperçu du fonctionnement de l’intégration, consultez [Présentation de l’intégration de S3 Tables](s3-tables-integration-overview.md).

**Note**  
Cette intégration utilise le AWS Glue Data Catalog et peut entraîner des coûts de AWS Glue demande et de stockage. Pour plus d’informations, consultez [AWS Glue Tarification](https://aws.amazon.com/glue/pricing/).  
Des tarifs supplémentaires s'appliquent pour l'exécution de requêtes sur des tables S3. Pour plus d’informations, consultez les informations de tarification du moteur de requêtes que vous utilisez.

## Conditions préalables à l’intégration
<a name="table-integration-prerequisites"></a>

Les conditions préalables suivantes sont requises pour intégrer des compartiments de tables aux services d' AWS analyse :
+ [Créez un compartiment de tables.](s3-tables-buckets-create.md)
+ Ajoutez les AWS Glue autorisations suivantes à votre principal Gestion des identités et des accès AWS (IAM) :
  + `glue:CreateCatalog`qui est nécessaire pour créer un catalogue `s3tablescatalog` fédéré dans le catalogue de données
  + `glue:PassConnection`accorde au principal appelant le droit de déléguer la création de la `aws:s3tables` connexion au service Amazon S3.
+ [Effectuez la mise à jour vers la dernière version de AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html#getting-started-install-instructions).

**Important**  
Lorsque vous créez des tables, assurez-vous d’utiliser toutes les lettres minuscules dans les noms et les définitions de tables. Par exemple, assurez-vous que les noms des tables et des colonnes sont tous en minuscules. Si le nom ou la définition de votre table contient des majuscules, cela signifie que la table n'est pas prise en charge par AWS Lake Formation ou par AWS Glue Data Catalog. Dans ce cas, votre tableau ne sera pas visible par les services d' AWS analyse tels qu'Amazon Athena, même si vos compartiments de tableaux sont intégrés aux services AWS d'analyse.   
Si la définition de votre table contient des majuscules, le message d'erreur suivant s'affiche lorsque vous exécutez une `SELECT` requête dans Athena :  « GENERIC\_INTERNAL\_ERROR : échec de la demande d'obtention de la table : com.amazonaws.services.glue.model. ValidationException: Ressource de fédération non prise en charge - Noms de table ou de colonne non valides. » 

## Intégrer des seaux de table avec AWS services d'analyse
<a name="table-integration-procedures"></a>

Vous pouvez intégrer des compartiments de tables au catalogue de données et aux services AWS d'analyse à l'aide des contrôles d'accès IAM par défaut, ou éventuellement utiliser les contrôles d'accès Lake Formation.

Lorsque vous effectuez une intégration à l'aide de contrôles d'accès IAM, vous avez besoin de privilèges IAM pour accéder aux compartiments de tables et aux tables Amazon S3, aux objets du catalogue de données et au moteur de requête que vous utilisez. Si vous choisissez d'intégrer à l'aide de Lake Formation, les contrôles d'accès IAM et les autorisations Lake Formation déterminent l'accès aux ressources du catalogue de données. Consultez le guide [*AWS Lake Formation du développeur *](https://docs.aws.amazon.com/lake-formation/latest/dg/create-s3-tables-catalog.html) pour en savoir plus sur l'intégration de Lake Formation.

Les sections suivantes décrivent comment utiliser la console de gestion Amazon S3 ou AWS CLI configurer l'intégration avec les contrôles d'accès IAM.

### Utilisation de la console S3
<a name="integrate-console"></a>

1. Ouvrez la console Amazon S3 à l'adresse [ https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, choisissez **Compartiments de tables**.

1. Choisissez **Créer un compartiment de tables**.

   La page **Créer un compartiment de tables** s’ouvre.

1. Saisissez un **Nom du compartiment de table** et veillez à ce que la case **Activer l’intégration** soit cochée.

1. Choisissez **Créer un compartiment de tables**. Amazon S3 essaiera d’intégrer automatiquement vos compartiments de tables dans cette région.

### Utilisation de AWS CLI
<a name="integrate-cli"></a>

**Pour intégrer des compartiments de tables aux contrôles d'accès IAM à l'aide du AWS CLI**

Les étapes suivantes montrent comment utiliser le AWS CLI pour intégrer des compartiments de tables. Pour utiliser ces étapes, remplacez les `{{user input placeholders}}` par vos propres informations.

1. Créez un compartiment de tables.

   ```
   aws s3tables create-table-bucket \
   --region {{us-east-1}} \
   --name {{amzn-s3-demo-table-bucket}}
   ```

1. Créez un fichier `catalog.json` contenant le catalogue qui suit :

   ```
   {
      "Name": "s3tablescatalog",
      "CatalogInput": {
         "FederatedCatalog": {
             "Identifier": "arn:aws:s3tables:{{us-east-1}}:{{111122223333}}:bucket/*",
             "ConnectionName": "aws:s3tables"
          },
          "CreateDatabaseDefaultPermissions":[
          {
                   "Principal": {
                       "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS"
                   },
                   "Permissions": ["ALL"]
               }
          ],
          "CreateTableDefaultPermissions":[
          {
                   "Principal": {
                       "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS"
                   },
                   "Permissions": ["ALL"]
               }
          ],
          "AllowFullTableExternalDataAccess": "True"
      }
   }
   ```

   Créez le catalogue `s3tablescatalog` à l’aide de la ligne de commande suivante. La création de ce catalogue permet de le remplir AWS Glue Data Catalog avec des objets correspondant à des compartiments de tables, à des espaces de noms et à des tables.

   ```
   aws glue create-catalog \
   --region {{us-east-1}} \
   --cli-input-json file://{{catalog.json}}
   ```

1. Vérifiez que le `s3tablescatalog` catalogue a été ajouté à AWS Glue l'aide de la commande suivante :

   ```
   aws glue get-catalog --catalog-id s3tablescatalog
   ```

### Migration vers le processus d’intégration mis à jour
<a name="migrate-integrate-console"></a>

Le processus d'intégration des services d' AWS analyse a été mis à jour pour utiliser les autorisations IAM par défaut. Si vous avez déjà configuré l'intégration, vous pouvez continuer à utiliser votre intégration actuelle. Toutefois, si vous souhaitez modifier votre intégration existante pour utiliser les autorisations IAM à la place, consultez le Guide [*AWS Lake Formation *](https://docs.aws.amazon.com/lake-formation/latest/dg/create-s3-tables-catalog.html) du développeur. Vous pouvez également rétablir l'intégration pour supprimer votre configuration existante AWS Glue Data Catalog AWS Lake Formation et relancer l'intégration. Cela supprimera toutes les autorisations existantes de Lake Formation et les autorisations d'accès associées au`s3tablescatalog`.

1. Ouvrez la AWS Lake Formation console à l'[https://console.aws.amazon.com/lakeformation/](https://console.aws.amazon.com/lakeformation/)adresse et connectez-vous en tant qu'administrateur du lac de données. Pour plus d’informations sur la manière de créer un administrateur de lac de données, consultez [Création d’un administrateur de lac de données](https://docs.aws.amazon.com/lake-formation/latest/dg/initial-lf-config.html#create-data-lake-admin) dans le *Guide du développeur AWS Lake Formation *.

1. Supprimez le catalogue `s3tablescatalog` en procédant comme suit : 
   + Dans le volet de navigation de gauche, choisissez **Catalogues**. 
   + Sélectionnez le bouton d’option situé à côté du catalogue `s3tablescatalog` dans la liste **Catalogues**. Dans le menu **Actions**, sélectionnez **Delete (Supprimer)**.

1. Désenregistrez l’emplacement des données du catalogue `s3tablescatalog` en procédant comme suit :
   + Dans le volet de navigation de gauche, accédez à la section **Administration**, puis choisissez **Emplacements de lac de données**. 
   + Choisissez le bouton d’option en regard de l’emplacement du lac de données `s3tablescatalog`, par exemple `s3://tables:{{region}}:{{account-id}}:bucket/*`. 
   + Dans le menu **Actions**, choisissez **Supprimer**. 
   + Dans la boîte de dialogue de confirmation qui s’affiche, choisissez **Supprimer**. 

1. Maintenant que vous avez supprimé l'emplacement de votre `s3tablescatalog` catalogue et de votre lac de données, vous pouvez suivre les étapes pour [ intégrer vos compartiments de tables aux services AWS d'analyse ](#table-integration-procedures) en utilisant le processus d'intégration mis à jour. 

**Note**  
Si vous souhaitez utiliser des tables SSE-KMS chiffrées dans des services AWS d'analyse intégrés, le rôle que vous utilisez doit être autorisé à utiliser votre AWS KMS clé pour les opérations de chiffrement. Pour de plus amples informations, veuillez consulter [Octroi aux principaux administrateurs IAM des autorisations leur permettant de travailler avec des tables chiffrées en mode intégré AWS services d'analyse](s3-tables-kms-permissions.md#tables-kms-integration-permissions).

**Étapes suivantes**
+ [Création d’un espace de noms](s3-tables-namespace-create.md).
+ [Création d’une table](s3-tables-create.md).