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.

# Utilisation d'Amazon OpenSearch Service avec Amazon Quick Sight
<a name="connecting-to-os"></a>

Vous trouverez ci-dessous comment vous connecter à vos données Amazon OpenSearch Service à l'aide d'Amazon Quick Sight.

## Création d'une nouvelle connexion à une source de données Quick Sight pour OpenSearch Service
<a name="create-connection-to-es"></a>

Vous trouverez ci-dessous comment vous connecter au OpenSearch service

Avant de continuer, Amazon Quick Sight doit être autorisé à se connecter à Amazon OpenSearch Service. Si les connexions ne sont pas activées, un message d’erreur s’affichera lorsque vous essaierez de vous connecter. Un administrateur de Quick Sight peut autoriser les connexions aux AWS ressources. 

**Pour autoriser Quick Sight à établir une connexion au OpenSearch Service**

1. Ouvrez le menu en cliquant sur l'icône de votre profil en haut à droite, puis choisissez **Gérer rapidement**. Si l'option **Manage Quick** ne s'affiche pas dans le menu de votre profil, demandez de l'aide à votre administrateur Amazon Quick.

1. Choisissez **Sécurité et autorisations**, **Ajouter ou supprimer**.

1. Activez l'option pour **OpenSearch**.

1. Choisissez **Mettre à jour**.

Une fois que le OpenSearch Service est accessible, vous créez une source de données afin que les utilisateurs puissent utiliser les domaines spécifiés.

**Pour vous connecter au OpenSearch service**

1. Commencez par créer un nouveau jeu de données. Choisissez **Data** dans le volet de navigation de gauche, puis choisissez **Create** and **New Dataset**.

1. Choisissez la carte de source de OpenSearch données **Amazon**.

1. Dans **Nom de la source de données**, entrez un nom descriptif pour votre connexion à la source de données du OpenSearch service, par exemple`OpenSearch Service ML Data`. Comme vous pouvez créer de nombreux ensembles de données à partir d'une connexion à OpenSearch Service, il est préférable de choisir un nom simple.

1. Pour **Type de connexion**, choisissez le réseau que vous souhaitez utiliser. Il peut s’agir d’un cloud privé virtuel (VPC) basé sur Amazon VPC ou d’un réseau public. La liste des VPCs contient les noms des connexions VPC, plutôt que VPC. IDs Ces noms sont définis par l'administrateur Quick. 

1. Pour **Domaine**, choisissez le domaine de OpenSearch service auquel vous souhaitez vous connecter. 

1. Choisissez **Valider la connexion** pour vérifier que vous pouvez vous connecter correctement au OpenSearch service.

1. Pour continuer, choisissez **Créer une source de données**.

1. Pour les **tableaux**, choisissez celui que vous souhaitez utiliser, puis sélectionnez **Sélectionner** pour continuer. 

1. Effectuez l’une des actions suivantes :
   + Pour importer vos données dans le moteur en mémoire Quick Sight (appeléSPICE), choisissez **Importer vers SPICE pour accélérer les analyses**. Pour plus d'informations sur la façon d'activer l'importation de OpenSearch données, consultez[Autoriser les connexions à Amazon Service OpenSearch](opensearch.md).
   + Pour permettre à Quick Sight d'exécuter une requête sur vos données à chaque fois que vous actualisez le jeu de données ou que vous utilisez l'analyse ou le tableau de bord, choisissez **Directly query your data**. 

     Pour activer l'actualisation automatique sur un tableau de bord publié qui utilise des données de OpenSearch service, le jeu de données de OpenSearch service doit utiliser une requête directe.

1. Choisissez **Modifier/apercevoir**, puis **Enregistrer** pour enregistrer votre jeu de données et le fermer.

## Gestion des autorisations pour les données OpenSearch de service
<a name="dataset-permissions-for-es"></a>

La procédure suivante décrit comment afficher, ajouter et révoquer des autorisations pour autoriser l'accès à la même source de données OpenSearch de service. Les personnes que vous ajoutez doivent être des utilisateurs actifs dans Quick Sight pour que vous puissiez les ajouter. 

**Modifier les autorisations sur une source de données**

1. Choisissez **Data** sur la gauche, puis faites défiler l'écran vers le bas pour trouver la carte de source de données correspondant à votre connexion Amazon OpenSearch Service. On pourrait utiliser l’exemple `US Amazon OpenSearch Service Data`.

1. Choisissez le jeu de OpenSearch données **Amazon**.

1. Sur la page de détails du jeu de données qui s’ouvre, sélectionnez l’onglet **Autorisations**.

   Une liste des autorisations actuelles s’affiche.

1. Pour ajouter des autorisations, choisissez **Ajouter des utilisateurs et des groupes**, puis procédez de la façon suivante :

   1. Ajoutez des utilisateurs ou des groupes pour leur permettre d’utiliser le même jeu de données.

   1. Lorsque vous avez terminé d’ajouter toutes les personnes que vous souhaitez ajouter, choisissez les **autorisations** que vous désirez appliquer.

1. (Facultatif) Pour modifier les autorisations, vous pouvez choisir **Visualiseur** ou **Propriétaire**. 
   + Choisissez **Visualiseur** pour autoriser l’accès en lecture.
   + Choisissez **Propriétaire** pour autoriser cet utilisateur à modifier, partager ou supprimer cet ensemble de données Quick Sight. 

1. (Facultatif) Pour révoquer les autorisations, choisissez **Révoquer l’accès**. Une fois que vous avez révoqué l’accès d’un utilisateur, celui-ci ne peut pas créer de nouveaux jeux de données à partir de cette source de données. Cependant, leurs jeux de données existants ont toujours accès à cette source de données.

1. Lorsque vous avez terminé, choisissez **Fermer**.

## Ajouter un nouveau jeu de données Quick Sight pour OpenSearch Service
<a name="create-dataset-using-es"></a>

Une fois que vous avez une connexion à une source de données existante pour OpenSearch Service, vous pouvez créer des ensembles de données OpenSearch Service à utiliser pour l'analyse. 

**Pour créer un ensemble de données à l'aide OpenSearch de Service**

1. Sur la page d'accueil, choisissez **Data**, **Create**, **New dataset**.

1. Faites défiler la page vers le bas jusqu'à la carte de source de données correspondant à votre connexion au OpenSearch service. Si vous avez de nombreuses sources de données, vous pouvez utiliser la barre de recherche en haut de la page pour trouver un correspondance partielle avec votre source de données.

1. Choisissez la carte de source de OpenSearch données **Amazon**, puis choisissez **Create data set**.

1. Pour **Tables**, choisissez l'index de OpenSearch service que vous souhaitez utiliser.

1. Choisissez **Modifier/apercevoir**.

1. Choisissez **Enregistrer** pour enregistrer et fermer le jeu de données. 

## Ajouter des données de OpenSearch service à une analyse
<a name="open-analysis-add-dataset-for-es"></a>

Une fois qu'un jeu OpenSearch de données de services est disponible, vous pouvez l'ajouter à une analyse Quick Sight. Avant de commencer, assurez-vous que vous disposez d'un ensemble de données existant contenant les données de OpenSearch service que vous souhaitez utiliser.

**Pour ajouter des données de OpenSearch service à une analyse**

1. Choisissez **Analyses** sur la gauche.

1. Effectuez l’une des actions suivantes :
   + Pour créer une nouvelle analyse, choisissez **Nouvelle analyse** en haut à droite. 
   + Pour compléter une analyse existante, ouvrez l’analyse que vous désirez modifier. 
     + Choisissez l’icône de crayon en haut à gauche.
     + Choisissez **Ajouter un jeu de données**.

1. Choisissez le jeu OpenSearch de données de service que vous souhaitez ajouter. 

   Pour plus d'informations sur l'utilisation OpenSearch de Service dans les visualisations, consultez[Limitations relatives à l'utilisation OpenSearch du service](#limitations-for-es). 

1. Pour plus d’informations, consultez [Utilisation des analyses](https://docs.aws.amazon.com/quicksight/latest/user/working-with-analyses.html).

## Limitations relatives à l'utilisation OpenSearch du service
<a name="limitations-for-es"></a>

Les limites suivantes s'appliquent à l'utilisation des ensembles OpenSearch de données de service :
+ OpenSearch Les ensembles de données de service prennent en charge un sous-ensemble de types visuels, d'options de tri et d'options de filtrage.
+ Pour activer l'actualisation automatique sur un tableau de bord publié qui utilise des données de OpenSearch service, le jeu de données de OpenSearch service doit utiliser une requête directe.
+ Les opérations de sous-requêtes multiples ne sont pas prises en charge. Pour éviter les erreurs lors de la visualisation, n’ajoutez pas plusieurs champs à un champ, utilisez un ou deux champs par visualisation et évitez de d’utiliser le sélecteur de champs **Couleur**.
+ Le SQL personnalisé n’est pas pris en charge.
+ Les jointures entre jeux de données et les jointures automatiques ne sont pas prises en charge.
+ Les champs calculés ne sont pas pris en charge. 
+ Les champs de texte ne sont pas pris en charge. 
+ La catégorie « autre » n’est pas prise en charge. Si vous utilisez un jeu de données de OpenSearch service avec une visualisation qui prend en charge la catégorie « autre », désactivez la catégorie « autre » en utilisant le menu du visuel.