Débuter avec AmazonOpenSearchService

Ce tutoriel vous montre comment utiliser AmazonOpenSearchService permettant de créer et de configurer un domaine de test. UnOpenSearchLe domaine de service est synonyme deOpenSearchcluster. Les domaines sont des clusters qui contiennent les paramètres, les types d'instances, le nombre d'instances et les ressources de stockage que vous spécifiez.

Ce didacticiel vous explique les étapes de base pour obtenir unOpenSearchLe domaine de service est rapidement opérationnel. Pour des informations plus détaillées, consultez Création et gestion de domaines Amazon OpenSearch Service et les autres rubriques de ce guide. Pour plus d'informations sur la migration versOpenSearchService assuré par une société autogéréeOpenSearchcluster, voirTutoriel : Migration vers AmazonOpenSearchService.

Vous pouvez suivre les étapes de ce didacticiel en utilisantOpenSearchConsole de service, laAWS CLI, ou leAWSSDK. Pour plus d'informations sur l'installation et la configuration de l'interface AWS CLI, consultez le Guide de l'utilisateur de l'AWS Command Line Interface.

Étape 1 : créer un AmazonOpenSearchDomaine du service

Important

Il s'agit d'un didacticiel concis pour configurer untestAmazonOpenSearchDomaine du service. N'utilisez pas ce processus pour créer des domaines de production. Pour une version complète du même processus, consultez Création et gestion de domaines Amazon OpenSearch Service.

UnOpenSearchLe domaine de service est synonyme deOpenSearchcluster. Les domaines sont des clusters qui contiennent les paramètres, les types d'instances, le nombre d'instances et les ressources de stockage que vous spécifiez. Vous pouvez créer unOpenSearchDomaine de service à l'aide de la console, duAWS CLI, ou leAWSSDK.

Pour créer unOpenSearchDomaine de service utilisant la console

1. Accédez à https://aws.amazon.com et choisissez Se connecter à la console.

2. SousAnalytique, choisissezAmazonOpenSearchService.

3. Choisissez Create domain (Créer un domaine).

4. Donnez un nom au domaine. Les exemples de ce tutoriel utilisent le nom movies.

5. Pour la méthode de création du domaine, choisissezCréation standard.

   Note

   Pour configurer rapidement un domaine de production selon les meilleures pratiques, vous pouvez choisirCréation facile. Pour les besoins du développement et des tests de ce didacticiel, nous allons utiliserCréation standard.

6. Pour les modèles, choisissezDéveloppement/test.

7. Pour l'option de déploiement, choisissezDomaine avec serveur de secours.

8. Pour Version, choisissez la dernière version.

9. Pour l'instant, ignorez leNœuds de données,Stockage de données à chaud et à froid,Nœuds maîtres dédiés,Configuration des instantanés, etPoint de terminaison personnalisésections.

10. Par souci de simplicité dans le cadre de ce tutoriel, utilisez un domaine d'accès public. Sous Network (Réseau), choisissez Public Access (Accès public).

11. Dans les paramètres de contrôle d'accès affinés, conservezActivez un contrôle d'accès affinécase à cocher sélectionnée. SélectionnezCréer un utilisateur principalet fournissez un nom d'utilisateur et un mot de passe.

12. Pour le moment, ignorez les sections Authentification SAML et Authentification Amazon Cognito.

13. Pour Access policy (Stratégie d'accès), choisissez Only use fine-grained access control (Utiliser uniquement le contrôle précis des accès). Dans ce didacticiel, le contrôle précis des accès gère l'authentification, pas la stratégie d'accès au domaine.

14. Ignorez les autres paramètres et choisissez Create (Créer). L'initialisation des nouveaux domaines prend généralement 15 à 30 minutes, mais cela peut prendre plus de temps en fonction de la configuration. Après l'initialisation de votre domaine, sélectionnez-le pour ouvrir son panneau de configuration. Notez le point de terminaison du domaine sous General information (Informations générales) (par exemple, https://search-my-domain.us-east-1.es.amazonaws.com), que vous utiliserez à l'étape suivante.

Suivant:Charger des données vers unOpenSearchDomaine de service pour l'indexation

Étape 2 : Chargez les données sur AmazonOpenSearchService d'indexation

Important

Il s'agit d'un didacticiel concis pour le téléchargement d'une petite quantité de données de test sur AmazonOpenSearchUn service. Pour plus d'informations sur le chargement de données dans un domaine de production, consultez Indexation des données dans Amazon Service OpenSearch .

Vous pouvez télécharger des données versOpenSearchDomaine de service utilisant la ligne de commande ou la plupart des langages de programmation.

Par commodité, les exemples de demande suivants utilisent curl (client HTTP courant). Les clients comme curl ne peuvent pas effectuer la signature de demande qui est exigée si vos stratégies d'accès spécifient des rôles ou utilisateurs IAM. Pour mener à bien ce processus, vous devez utiliser un contrôle d'accès précis avec un nom d'utilisateur et un mot de passe principaux tels que ceux que vous avez configurés dansÉtape 1.

Vous pouvez installer curl sous Windows et l'utiliser à partir de l'invite de commande. Toutefois, nous recommandons l'utilisation d'un outil comme Cygwin ou Windows Subsystem for Linux. curl est déjà préinstallé sur macOS et sur la plupart des distributions Linux.

Option 1 : Charger un seul document

Exécutez la commande suivante pour ajouter un document unique au domaine movies :

curl -XPUT -u 'master-user:master-user-password' 'domain-endpoint/movies/_doc/1' -d '{"director": "Burton, Tim", "genre": ["Comedy","Sci-Fi"], "year": 1996, "actor": ["Jack Nicholson","Pierce Brosnan","Sarah Jessica Parker"], "title": "Mars Attacks!"}' -H 'Content-Type: application/json'

Dans la commande, saisissez le nom d'utilisateur et le mot de passe que vous avez créés dansÉtape 1.

Pour une explication détaillée de cette commande et de la procédure à suivre pour envoyer des requêtes signées àOpenSearchService, voirIndexation des données dans Amazon Service OpenSearch .

Option 2 : Charger plusieurs documents

Pour charger un fichier JSON contenant plusieurs documents vers unOpenSearchDomaine du service

1. Créez un fichier local nommé bulk_movies.json. Collez le contenu suivant dans le fichier et ajoutez une nouvelle ligne de fin :

   { "index" : { "_index": "movies", "_id" : "2" } }
   {"director": "Frankenheimer, John", "genre": ["Drama", "Mystery", "Thriller", "Crime"], "year": 1962, "actor": ["Lansbury, Angela", "Sinatra, Frank", "Leigh, Janet", "Harvey, Laurence", "Silva, Henry", "Frees, Paul", "Gregory, James", "Bissell, Whit", "McGiver, John", "Parrish, Leslie", "Edwards, James", "Flowers, Bess", "Dhiegh, Khigh", "Payne, Julie", "Kleeb, Helen", "Gray, Joe", "Nalder, Reggie", "Stevens, Bert", "Masters, Michael", "Lowell, Tom"], "title": "The Manchurian Candidate"}
   { "index" : { "_index": "movies", "_id" : "3" } }
   {"director": "Baird, Stuart", "genre": ["Action", "Crime", "Thriller"], "year": 1998, "actor": ["Downey Jr., Robert", "Jones, Tommy Lee", "Snipes, Wesley", "Pantoliano, Joe", "Jacob, Ir\u00e8ne", "Nelligan, Kate", "Roebuck, Daniel", "Malahide, Patrick", "Richardson, LaTanya", "Wood, Tom", "Kosik, Thomas", "Stellate, Nick", "Minkoff, Robert", "Brown, Spitfire", "Foster, Reese", "Spielbauer, Bruce", "Mukherji, Kevin", "Cray, Ed", "Fordham, David", "Jett, Charlie"], "title": "U.S. Marshals"}
   { "index" : { "_index": "movies", "_id" : "4" } }
   {"director": "Ray, Nicholas", "genre": ["Drama", "Romance"], "year": 1955, "actor": ["Hopper, Dennis", "Wood, Natalie", "Dean, James", "Mineo, Sal", "Backus, Jim", "Platt, Edward", "Ray, Nicholas", "Hopper, William", "Allen, Corey", "Birch, Paul", "Hudson, Rochelle", "Doran, Ann", "Hicks, Chuck", "Leigh, Nelson", "Williams, Robert", "Wessel, Dick", "Bryar, Paul", "Sessions, Almira", "McMahon, David", "Peters Jr., House"], "title": "Rebel Without a Cause"}
   

2. Exécutez la commande suivante dans le répertoire local où le fichier est stocké pour le charger dans le domaine movies :

   curl -XPOST -u 'master-user:master-user-password' 'domain-endpoint/_bulk' --data-binary @bulk_movies.json -H 'Content-Type: application/json'

Pour plus d'informations sur le format de fichier en bloc, consultez Indexation des données dans Amazon Service OpenSearch .

À suivre : Rechercher des documents

Étape 3 : Rechercher des documents sur AmazonOpenSearchService

Pour rechercher des documents dans un AmazonOpenSearchDomaine de service, utilisez leOpenSearchAPI de recherche. Vous pouvez également utiliserOpenSearchTableaux de bordpour rechercher des documents dans le domaine.

Rechercher des documents via la ligne de commande

Exécutez la commande suivante pour rechercher le mot mars dans le domaine movies :

curl -XGET -u 'master-user:master-user-password' 'domain-endpoint/movies/_search?q=mars&pretty=true'

Si vous avez utilisé les données en bloc sur la page précédente, essayez de rechercher rebelle à la place.

La réponse devrait être similaire à ce qui suit :

{
  "took" : 5,
  "timed_out" : false,
  "_shards" : {
    "total" : 5,
    "successful" : 5,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : {
      "value" : 1,
      "relation" : "eq"
    },
    "max_score" : 0.2876821,
    "hits" : [
      {
        "_index" : "movies",
        "_type" : "_doc",
        "_id" : "1",
        "_score" : 0.2876821,
        "_source" : {
          "director" : "Burton, Tim",
          "genre" : [
            "Comedy",
            "Sci-Fi"
          ],
          "year" : 1996,
          "actor" : [
            "Jack Nicholson",
            "Pierce Brosnan",
            "Sarah Jessica Parker"
          ],
          "title" : "Mars Attacks!"
        }
      }
    ]
  }
}

Rechercher des documents à l'aide deOpenSearchTableaux de bord

OpenSearchDashboards est un outil de visualisation open source populaire conçu pour fonctionner avecOpenSearch. Ils fournissent une interface utilisateur utile pour la recherche et la surveillance de vos indices.

Pour rechercher des documents à partir d'unOpenSearchDomaine de service utilisant des tableaux de bord

1. Accédez auOpenSearchURL des tableaux de bord pour votre domaine. Vous pouvez trouver l'URL sur le tableau de bord du domaine dansOpenSearchConsole de service. Le format de l'URL est le suivant :

   domain-endpoint/_dashboards/

2. Connectez-vous à l'aide de votre nom d'utilisateur et de votre mot de passe principaux.

3. Pour utiliser Dashboards, vous devez créer au moins un modèle d'index. Dashboards utilise ces modèles pour identifier les index que vous voulez analyser. Ouvrez le panneau de navigation de gauche, choisissez Stack Management (Gestion des piles), choisissez Index Patterns (Modèles d'index), puis choisissez Create index pattern (Créer un modèle d'index). Dans le cadre de ce tutoriel, saisissez movies.

4. Choisissez Next step (Étape suivante), puis Create index pattern (Créer un modèle d'index). Une fois le modèle créé, vous pouvez consulter les différents champs du document, comme actor et director.

5. Retournez à la page Index Patterns (Modèles d'index) et vérifiez que movies est défini comme modèle par défaut. Si ce n'est pas le cas, sélectionnez le modèle et choisissez l'icône en forme d'étoile pour en faire le modèle par défaut.

6. Pour commencer à rechercher vos données, ouvrez à nouveau le panneau de navigation de gauche et choisissez Discover (Découvrir).

7. Sur la barre de recherche, saisissez mars si vous avez chargé un seul document, ou rebelle si vous avez chargé plusieurs documents, puis appuyez sur Entrée. Vous pouvez essayer de rechercher d'autres termes, tels que des noms d'acteurs ou de réalisateurs.

À suivre : Supprimer un domaine

Étape 4 : Supprimer un AmazonOpenSearchDomaine du service

Étant donné que le domaine movies est utilisé dans ce tutoriel à des fins de test, veillez à le supprimer lorsque vous aurez fini de l'utiliser afin de ne pas payer de frais.

Pour supprimer unOpenSearchDomaine de service depuis la console

1. Connectez-vous auAmazonOpenSearchServiceconsole.

2. Sous Domains (Domaines), sélectionnez le domaine movies.

3. Choisissez Delete (Supprimer) et confirmez la suppression.

Étapes suivantes

Maintenant que vous savez comment créer un domaine et indexer des données, n'hésitez pas à essayer les exercices suivants :

• Découvrez des options de création de domaine plus avancées. Pour plus d'informations, veuillez consulter Création et gestion de domaines Amazon OpenSearch Service.

• Apprenez à gérer les index de votre domaine. Pour plus d'informations, veuillez consulter Gestion des index dans Amazon Service OpenSearch .

• Essayez l'un des didacticiels pour travailler avec AmazonOpenSearchUn service. Pour plus d'informations, veuillez consulter Didacticiels sur Amazon OpenSearch Service.