View a markdown version of this page

Tutorial: Introducción a Amazon OpenSearch Serverless - OpenSearch Servicio Amazon

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Tutorial: Introducción a Amazon OpenSearch Serverless

En este tutorial se muestran los pasos básicos para poner en marcha rápidamente una colección de búsquedas de Amazon OpenSearch Serverless. Con una colección de búsquedas, puede potenciar las aplicaciones de sus redes internas y las aplicaciones con acceso a Internet, como la búsqueda de sitios web de comercio electrónico y la búsqueda de contenido.

Para obtener información sobre cómo utilizar una colección de búsqueda vectorial, consulte. Trabajo con colecciones de búsqueda vectorial Para obtener información detallada sobre el uso de colecciones, consulte Administración de colecciones de Amazon OpenSearch Serverless y los demás temas de esta guía.

En este tutorial, debe completar los siguientes pasos:

  1. Configurar permisos

  2. Crear una colección

  3. Cargar y buscar datos

  4. Eliminar la colección

    nota

    Utilice únicamente caracteres ASCII para su. IndexName Si no utiliza caracteres ASCIIIndexName, las CloudWatch métricas de entrada se convierten a un formato codificado IndexName en URL para los caracteres que no son ASCII.

Paso 1: configurar permisos

Para completar este tutorial y utilizar OpenSearch Serverless en general, debe tener los permisos de IAM correctos. En este tutorial, crea una colección, carga y busca datos y, a continuación, elimina la colección.

Su usuario o rol debe tener adjunta una política basada en la identidad con los siguientes permisos mínimos:

JSON
{ "Version":"2012-10-17", "Statement": [ { "Action": [ "aoss:CreateCollection", "aoss:ListCollections", "aoss:BatchGetCollection", "aoss:DeleteCollection", "aoss:CreateAccessPolicy", "aoss:ListAccessPolicies", "aoss:UpdateAccessPolicy", "aoss:CreateSecurityPolicy", "aoss:GetSecurityPolicy", "aoss:UpdateSecurityPolicy", "iam:ListUsers", "iam:ListRoles" ], "Effect": "Allow", "Resource": "*" } ] }

Para obtener más información sobre los permisos de IAM OpenSearch sin servidor, consulte. Identity and Access Management para Amazon OpenSearch Serverless

Paso 2: crear una colección

Una colección es un grupo de OpenSearch índices que funcionan juntos para respaldar una carga de trabajo o un caso de uso específicos.

Para crear una colección OpenSearch sin servidor
  1. Abre la consola OpenSearch de Amazon Service en https://console.aws.amazon.com/aos/home.

  2. En el panel de navegación izquierdo, selecciona Colecciones.

  3. Seleccione Crear colección.

  4. En Nombre, escriba movies.

  5. En Tipo de colección, selecciona Buscar. Para obtener más información, consulte Choosing a collection type (Elección de un tipo de recopilación).

  6. Para el método de creación de colecciones, elija Express Create.

  7. Revise la configuración predeterminada. Estos incluyen el grupo de recopilación, la configuración de la aplicación de OpenSearch interfaz de usuario, el cifrado con una Clave propiedad de AWS, el acceso a la red pública y la política de acceso a los datos generada automáticamente.

  8. Seleccione Crear colección.

  9. Espere a que el estado de la recopilación cambie aActive. Esto podría tardar varios minutos.

sugerencia

En este tutorial se utiliza el método NextGen Express Create. También puede acceder a Express Create desde el botón de creación rápida del banner de información de la página de destino para agilizar el proceso. Para tener más control sobre la configuración de cifrado, red y acceso a los datos, utilice Standard Create. Para usar el asistente de creación de colecciones clásicas, selecciona Cambiar a la versión clásica. Para obtener más información, consulte Creación de colecciones.

Paso 3: cargar y buscar datos

Puedes cargar datos a una colección OpenSearch sin servidor mediante Postman o cURL. Para simplificar, en estos ejemplos se utilizan las herramientas de desarrollo de la OpenSearch consola de Dashboards.

Para indexar y buscar datos en la colección de películas
  1. Seleccione Colecciones en el panel de navegación de la izquierda y elija la colección de películas para abrir su página de detalles.

  2. Elija la URL de los OpenSearch paneles de control para la colección. La URL toma el formato https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}.

  3. En OpenSearch Dashboards, abra el panel de navegación izquierdo y elija Dev Tools.

  4. Para crear un índice único llamado índice de películas, envíe la siguiente solicitud:

    PUT movies-index
    OpenSearch La consola de paneles muestra la solicitud PUT a movies-index con el estado de respuesta 200.
  5. Para indexar un solo documento en índice de películas, envíe la siguiente solicitud:

    PUT movies-index/_doc/1 { "title": "Shawshank Redemption", "genre": "Drama", "year": 1994 }
  6. Para buscar datos en los OpenSearch paneles de control, debe configurar al menos un patrón de índice. OpenSearch utiliza estos patrones para identificar los índices que desea analizar. Abra el menú principal del panel, seleccione Administración de pilas. Luego, seleccione Patrones de índices y, a continuación, seleccione Crear patrón de índice. Para este tutorial, escriba Películas.

  7. seleccione Siguiente paso y, a continuación, seleccione Crear patrón de índice. Una vez creado el patrón, puede ver los diversos campos de documento, como title y genre.

  8. Para empezar a buscar sus datos, abra de nuevo el panel de navegación izquierdo y elija Discover, o utilice la API de búsqueda de Dev Tools.

Gestión de errores

Cuando ejecutas operaciones de indexación y búsqueda, es posible que obtengas las siguientes respuestas de error:

  • HTTP 507: indica que se produjo un error interno del servidor. Este error generalmente indica que las unidades de OpenSearch cómputo (OCU) están sobrecargadas por el volumen o la complejidad de las solicitudes. Si bien OpenSearch Serverless escala automáticamente para gestionar la carga, puede producirse un retraso en la implementación de recursos adicionales.

    Para mitigar este error, implemente una política de reintentos con retroceso exponencial. Este enfoque reduce temporalmente la tasa de solicitudes para administrar la carga de manera eficaz. Para obtener más detalles, consulte Comportamiento de reintentos en la Guía de referencia de SDK y herramientas de AWS .

  • HTTP 402— Indica que ha alcanzado el límite máximo de capacidad de la unidad de OpenSearch cómputo (OCU). Optimice su carga de trabajo para reducir el uso de OCU o solicite un aumento de cuota.

Paso 4: eliminar la colección

Como la colección de películas es para fines de prueba, elimínala cuando termines de experimentar.

Para eliminar una colección OpenSearch sin servidor
  1. Vuelve a la consola OpenSearch de Amazon Service.

  2. Seleccione Colecciones en el panel de navegación de la izquierda y elija la colección de películas.

  3. Seleccione Eliminar y confirme la eliminación.

Siguientes pasos

Ahora que sabe cómo crear una recopilación e indexar datos, puede probar lo siguiente: