Paso 1: crear un dominio Paso 2: cargar datos para realizar la indexación Paso 3: buscar documentos Paso 4: eliminar un dominio

Introducción a Amazon OpenSearch Service

En este tutorial se muestra cómo utilizar Amazon OpenSearch Service para crear y configurar un dominio de prueba. Un dominio de OpenSearch Service es sinónimo de clúster de OpenSearch. Los dominios son clústeres con la configuración, los tipos de instancia, los recuentos de instancias y los recursos de almacenamiento que especifique.

El tutorial muestra los pasos básicos para poner en marcha un dominio de OpenSearch Service rápidamente. Para obtener información detallada, consulte Creación y administración de dominios OpenSearch de Amazon Service y los demás temas de esta guía. Para obtener información sobre la migración a ‎‎‏‏OpenSearch Service desde un clúster autoadministrado de OpenSearch, consulte Tutorial: Migración a Amazon OpenSearch Service.

Puede completar los pasos en este tutorial usando la consola de OpenSearch Service, la AWS CLI o el SDK de AWS. Para obtener información sobre cómo instalar y configurar la AWS CLI, consulte la Guía del usuario de AWS Command Line Interface.

Paso 1: crear un dominio de Amazon OpenSearch Service

importante

Este es un tutorial conciso para configurar una prueba de dominio de Amazon OpenSearch Service. No utilice este proceso para crear dominios de producción. Para ver una versión completa del mismo proceso, consulte Creación y administración de dominios OpenSearch de Amazon Service.

Un dominio de OpenSearch Service es sinónimo de clúster de OpenSearch. Los dominios son clústeres con la configuración, los tipos de instancia, los recuentos de instancias y los recursos de almacenamiento que especifique. Puede crear un dominio de OpenSearch Service con la consola, la AWS CLI o los SDK de AWS.

Para crear un dominio de OpenSearch Service con la consola

Visite https://aws.amazon.com y elija Iniciar sesión en la consola.
En Análisis, elija Amazon OpenSearch Service.
Elija Crear un dominio.
Proporcione un nombre para el dominio. Los ejemplos de este tutorial utilizan el nombre Películas.
Elija Creación estándar para el método de creación del dominio.

nota
Para configurar rápidamente un dominio de producción con las prácticas recomendadas, puede elegir Creación sencilla. Para el desarrollo y las pruebas de este tutorial, utilizaremos la Creación estándar.
Para las plantillas, elija Desarrollo/pruebas.
Para la opción de implementación, elija Dominio con modo de espera.
En Versión, elija la versión más reciente.
Por ahora, ignore las secciones de Nodos de datos, Almacenamiento de datos en caliente y en frío, Nodos maestros dedicados, Configuración de instantáneas y Puntos de conexión personalizados.
Para simplificar este tutorial, utilice un dominio de acceso público. En Red, elija Acceso público.
En la configuración de control de acceso detallado, mantenga seleccionada la casilla Habilitar el control de acceso detallado. Seleccione Crear usuario maestro e ingrese un nombre de usuario y una contraseña.
Por el momento, ignore las secciones Autenticación SAML y Autenticación de Amazon Cognito.
Para la Política de acceso, elija Utilizar únicamente control de acceso detallado. En este tutorial, el control de acceso detallado controla la autenticación, no la política de acceso al dominio.
Omita el resto de la configuración y elija Crear. Los dominios nuevos suelen tardar entre 15 y 30 minutos en inicializarse, pero pueden tardar más en función de la configuración. Una vez inicializado su dominio, selecciónelo para abrir su panel de configuración. Tome nota del punto de conexión del dominio en Información general (por ejemplo, https://search-my-domain.us-east-1.es.amazonaws.com), que deberá usar en el siguiente paso.

Siguiente: cargar datos en un dominio de OpenSearch Service para realizar la indexación

Paso 2: cargar los datos en Amazon OpenSearch Service para realizar la indexación

importante

Este es un tutorial conciso para cargar una pequeña cantidad de datos de prueba en Amazon OpenSearch Service. Para obtener más información sobre cómo cargar datos en un dominio de producción, consulte Indexación de datos en Amazon Service OpenSearch .

Puede cargar datos en un dominio de OpenSearch Service mediante la línea de comandos o la mayoría de los lenguajes de programación.

El siguiente ejemplo requiere utilizar curl, (un cliente HTTP común), para que el proceso sea más cómodo y rápido. Los clientes como curl no pueden realizar la firma de solicitudes necesaria si sus políticas de acceso especifican roles o usuarios de IAM. Para realizar correctamente este proceso, debe utilizar un control de acceso detallado con un nombre de usuario primario y una contraseña, como los configuró en el Paso 1.

Puede instalar curl en Windows y utilizarlo desde el símbolo del sistema, pero recomendamos utilizar una herramienta como Cygwin o Windows Subsystem for Linux. La distribución de macOS y la mayoría de las distribuciones de Linux vienen con curl preinstalado.

Opción 1: cargar un solo documento

Ejecute el siguiente comando para agregar un único documento al dominio Películas:


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'

En el comando, proporcione el nombre de usuario y la contraseña que creó en el Paso 1.

Para obtener una explicación detallada de este comando y cómo realizar solicitudes firmadas a OpenSearch Service, consulte Indexación de datos en Amazon Service OpenSearch .

Opción 2: cargar varios documentos

Para cargar un archivo JSON que contiene varios documentos en un dominio de OpenSearch Service

Cree un archivo local denominado bulk_movies.json. Pegue el siguiente contenido en el archivo y agregue una línea nueva al final:


{ "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"}

Ejecute el siguiente comando en el directorio local en el que está almacenado el archivo para cargarlo en el dominio Películas:


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

Para obtener más información acerca del formato de archivo masivo, consulte Indexación de datos en Amazon Service OpenSearch .

Siguiente: buscar documentos

Paso 3: buscar documentos en Amazon OpenSearch Service

Para buscar documentos en un dominio de Amazon OpenSearch Service, utilice la API de búsqueda de OpenSearch. También puede utilizar OpenSearch Dashboards para buscar documentos en el dominio.

Para buscar documentos desde la línea de comandos

Ejecute el siguiente comando para buscar el dominio Películas para la palabra mars:


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

Si utilizó datos masivos en la página anterior, intente buscar rebel en su lugar.

Verá una respuesta parecida a la siguiente:


{
  "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!"
        }
      }
    ]
  }
}

Buscar documentos mediante OpenSearch Dashboards

OpenSearch Dashboards es una popular herramienta de visualización de código abierto diseñada para funcionar con OpenSearch. Proporciona una interfaz de usuario útil para que pueda buscar y monitorear índices.

Para buscar documentos de un dominio de OpenSearch Service mediante Dashboards

Desplácese hasta la URL de OpenSearch Dashboards para su dominio. Puede encontrar la URL en el panel del dominio en la consola de OpenSearch Service. La URL tiene este formato:
```
domain-endpoint/_dashboards/
```
Inicie sesión con su nombre de usuario principal y contraseña.
Para utilizar Dashboards, debe crear al menos un patrón de índice. Dashboards utiliza estos patrones para identificar los índices que desea analizar. Abra el panel de navegación de la izquierda, elija Gestión de pilas, elija Patrones de índice y luego elija Crear patrón de índice. Para este tutorial, escriba Películas.
Elija Siguiente paso y, a continuación, elija Crear patrón de índice. Una vez creado el patrón, puede ver los diversos campos de documento, comoactor y director.
Regrese a la pestaña Patrones de índice y asegúrese de que movies se establezca como valor predeterminado. Si no lo es, seleccione el patrón y elija el icono de estrella para convertirlo en el predeterminado.
Para comenzar a buscar los datos, abra el panel de navegación izquierdo y elija Descubrir.
En la barra de búsqueda, escriba mars, si cargó un solo documento, o rebel, si cargó varios documentos y, a continuación, presione Enter. Puede buscar otros términos, como nombres de actores o directores.

Siguiente: eliminar un dominio

Paso 4: eliminar un dominio de Amazon OpenSearch Service

Dado que el dominio Películas de este tutorial es para hacer pruebas, debe eliminarlo cuando termine de experimentar para evitar incurrir en gastos.

Para eliminar un dominio de OpenSearch Service de la consola

Inicie sesión en la consola de Amazon OpenSearch Service.
En Dominios, seleccione el dominio películas.
Elija Eliminar y confirme la eliminación.

Pasos siguientes

Ahora que sabe cómo crear un dominio e indexar datos, puede probar algunos de los siguientes ejercicios:

Conozca más opciones avanzadas para crear un dominio. Para más información, consulte Creación y administración de dominios OpenSearch de Amazon Service.
Descubra cómo administrar los índices de un dominio. Para más información, consulte Administración de índices en Amazon OpenSearch Service.
Pruebe uno de los tutoriales para trabajar con Amazon OpenSearch Service. Para más información, consulte Tutoriales de Amazon OpenSearch Service.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Configuración

OpenSearch Ingestión de Amazon

Introducción a Amazon OpenSearch Service

Paso 1: crear un dominio de Amazon OpenSearch Service

importante

Para crear un dominio de OpenSearch Service con la consola

nota

Paso 2: cargar los datos en Amazon OpenSearch Service para realizar la indexación

importante

Opción 1: cargar un solo documento

Opción 2: cargar varios documentos

Para cargar un archivo JSON que contiene varios documentos en un dominio de OpenSearch Service

Paso 3: buscar documentos en Amazon OpenSearch Service

Para buscar documentos desde la línea de comandos

Buscar documentos mediante OpenSearch Dashboards

Para buscar documentos de un dominio de OpenSearch Service mediante Dashboards

Paso 4: eliminar un dominio de Amazon OpenSearch Service

Para eliminar un dominio de OpenSearch Service de la consola

Pasos siguientes