Tutorial: introducción a Amazon OpenSearch sin servidor - Amazon OpenSearch Service
Paso 1: configurar permisosPaso 2: crear una colecciónPaso 3: cargar y buscar datosGestión de erroresPaso 4: eliminar la colecciónPasos a seguir a continuación

Tutorial: introducción a Amazon OpenSearch sin servidor

El tutorial muestra los pasos básicos para poner en marcha rápidamente una colección de búsqueda de Amazon OpenSearch sin servidor. Una colección de búsqueda le permite potenciar las aplicaciones de sus redes internas y las aplicaciones orientadas a Internet, como la búsqueda en 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 sin servidor y los demás temas de esta guía.

En este tutorial, deberá completar los siguientes pasos:

  1. Configurar permisos

  2. Crear una colección

  3. Cargar y buscar datos

  4. Eliminar la colección

    nota

    Recomendamos que usted utilice únicamente caracteres ASCII para su IndexName. Si no utiliza caracteres ASCII para IndexName, IndexName en las métricas de CloudWatch se convertirá a un formato codificado en URL para caracteres que no sean ASCII.

Paso 1: configurar permisos

Para completar este tutorial y utilizar OpenSearch sin servidor en general, debe tener los permisos de IAM correctos. En este tutorial, creará una colección, cargará y buscará datos y, a continuación, eliminará 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 de OpenSearch sin servidor, consulte Identity and Access Management en Amazon OpenSearch sin servidor

Paso 2: crear una colección

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

Para crear una colección de OpenSearch sin servidor

  1. Abra la consola de Amazon OpenSearch Service en https://console.aws.amazon.com/aos/home.

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

  3. Asigne un nombre a las películas de la colección.

  4. Para el tipo de colección, seleccione Buscar. Para obtener más información, consulte Choosing a collection type (Elección de un tipo de recopilación).

  5. En Seguridad, elija Creación estándar.

  6. En Cifrado, seleccione Utilizar Clave propiedad de AWS. Esta es la AWS KMS key que va a utilizar OpenSearch sin servidor para cifrar los datos.

  7. En Red, configure los ajustes de red para la colección.

    • Para el tipo de acceso, seleccione Público.

    • Para el tipo de recurso, elija tanto Habilitar el acceso a puntos de conexión de OpenSearch como Habilitar el acceso a OpenSearch Dashboards. Dado que cargará y buscará datos mediante OpenSearch Dashboards, deberá habilitar ambos.

  8. Seleccione Siguiente.

  9. En Configurar el acceso a los datos, defina los ajustes de acceso a la colección. Las políticas de acceso a los datos le permiten a los usuarios y a los roles acceder a los datos de una colección. En este tutorial, le brindaremos a un solo usuario los permisos necesarios para indexar y buscar datos en la colección de películas.

    Cree una sola regla que proporcione acceso a la colección películas. Asígnele a la regla el nombre Acceso a la colección de películas.

  10. Seleccione Agregar entidades principales, Usuarios y roles de IAM, y luego el usuario de IAM que utilizará para iniciar sesión en OpenSearch Dashboards e indexar datos. Seleccione Guardar.

  11. En Indexar permisos, seleccione todos los permisos.

  12. Seleccione Siguiente.

  13. En la configuración de la política de acceso, seleccione Crear una nueva política de acceso a datos y póngale el nombre películas a la política.

  14. Seleccione Siguiente.

  15. Revise la configuración de la colección y seleccione Enviar. Espere unos minutos hasta que el estado de la colección cambie a Active.

Paso 3: cargar y buscar datos

Puede cargar datos en una colección de OpenSearch sin servidor con Postman o cURL. Para ser breves, en estos ejemplos se utilizan las herramientas de desarrollo en la consola de OpenSearch 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. Seleccione la URL de OpenSearch Dashboards 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 seleccione Herramientas de desarrollo.

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

    PUT movies-index
    OpenSearch Dashboards console showing PUT request for movies-index with JSON response.

  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 OpenSearch Dashboards, debe configurar al menos un patrón de índice. OpenSearch utiiza 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 comenzar a buscar los datos, abra el panel de navegación izquierdo y elija Explorar o utilice la API de búsqueda dentro de Herramientas de desarrollo.

Gestión de errores

Al ejecutar operaciones de indexación y búsqueda, usted puede recibir las siguientes respuestas de error:

  • HTTP 507: indica que se produjo un error interno del servidor. Este error generalmente indica que sus unidades de cómputo de OpenSearch (OCU) están sobrecargadas por el volumen o la complejidad de sus solicitudes. Aunque OpenSearch sin servidor escala automáticamente para administrar la carga, puede haber una demora 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 usted alcanzó el límite máximo de la capacidad de unidades de cómputo de OpenSearch (OCU). Optimice su carga de trabajo para reducir el uso de OCU o solicite un aumento de cuota.

Paso 4: eliminar la colección

Dado que la colección de películas es para hacer pruebas, debe eliminarla cuando termine de experimentar.

Para eliminar una colección de OpenSearch sin servidor

  1. Vuelva a la consola de Amazon OpenSearch 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.

Pasos a seguir a continuación

Ahora que sabe cómo crear una colección e indexar datos, puede que desee probar algunos de los siguientes ejercicios: