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.

Uso de solucionadores de canalizaciones en AWS AppSync

AWS AppSync proporciona una forma sencilla de conectar un campo GraphQL a una única fuente de datos mediante resolutores unitarios. Sin embargo, ejecutar una sola operación podría no ser suficiente. Los solucionadores de canalización ofrecen la posibilidad de ejecutar operaciones en serie con respecto a los orígenes de datos. Cree funciones en su cuenta API y adjúntelas a un solucionador de canalizaciones. Cada resultado de ejecución de la función se canaliza a la siguiente hasta que no quede ninguna función que ejecutar. Con los solucionadores de canalizaciones, ahora puedes crear flujos de trabajo más complejos directamente en AWS AppSync ellos. En este tutorial, se crea una aplicación sencilla de visualización de imágenes, en la que los usuarios pueden publicar y ver imágenes publicadas por sus amigos.

Configuración en un clic

Si quieres configurar automáticamente el punto final de GraphQL AWS AppSync con todos los resolutores configurados y los AWS recursos necesarios, puedes usar la siguiente plantilla: AWS CloudFormation

Esta pila crea los siguientes recursos en su cuenta:

Al final del proceso de creación de la AWS CloudFormation pila, recibirá un correo electrónico para cada uno de los tres usuarios de Amazon Cognito que se crearon. Cada correo electrónico contiene una contraseña temporal que se utiliza para iniciar sesión en la consola como usuario de Amazon Cognito. AWS AppSync Guarde las contraseñas para el resto del tutorial.

Configuración manual

Si prefiere realizar un step-by-step proceso manualmente a través de la AWS AppSync consola, siga el proceso de configuración que se indica a continuación.

Configuración de sus AWS AppSync recursos no relacionados

APISe comunica con dos tablas de DynamoDB: una tabla de imágenes que almacena imágenes y una tabla de amigos que almacena las relaciones entre los usuarios. APIEstá configurado para usar el grupo de usuarios de Amazon Cognito como tipo de autenticación. La siguiente AWS CloudFormation pila configura estos recursos en la cuenta.

Al final del proceso de creación de la AWS CloudFormation pila, recibirá un correo electrónico para cada uno de los tres usuarios de Amazon Cognito que se crearon. Cada correo electrónico contiene una contraseña temporal que se utiliza para iniciar sesión en la consola como usuario de Amazon Cognito. AWS AppSync Guarde las contraseñas para el resto del tutorial.

Creando tu GraphQL API

Para crear GraphQL API en: AWS AppSync

La AWS AppSync consola crea un nuevo GraphQL API para usted mediante el modo de autenticación de API claves. Puedes usar la consola para configurar el resto de GraphQL API y ejecutar consultas en él durante el resto de este tutorial.

Configuración de GraphQL API

Debe configurarlo AWS AppSync API con el grupo de usuarios de Amazon Cognito que acaba de crear.

Ahora API está configurado para usar el grupo de usuarios de Amazon Cognito como tipo de autorización.

Configuración de orígenes de datos para las tablas de DynamoDB

Una vez creadas las tablas de DynamoDB, vaya a su AWS AppSync API GraphQL en la consola y seleccione la pestaña Fuentes de datos. Ahora, va a crear una fuente de datos AWS AppSync para cada una de las tablas de DynamoDB que acaba de crear.

Repita el mismo proceso para la tabla de amigos, el nombre de la tabla de DynamoDB debería AppSyncTutorialser -Friends si no cambió ResourceNamePrefixel parámetro en el momento de crear la pila. CloudFormation

Creación del esquema de GraphQL

Ahora que los orígenes de datos están conectados a las tablas de DynamoDB, vamos a crear un esquema de GraphQL. En el editor de esquemas de la AWS AppSync consola, asegúrese de que el esquema coincide con el siguiente esquema:

schema {
    query: Query
    mutation: Mutation
}

type Mutation {
    createPicture(input: CreatePictureInput!): Picture!
    @aws_auth(cognito_groups: ["Admins"])
    createFriendship(id: ID!, target: ID!): Boolean
    @aws_auth(cognito_groups: ["Admins"])
}

type Query {
    getPicturesByOwner(id: ID!): [Picture]
    @aws_auth(cognito_groups: ["Admins", "Viewers"])
}

type Picture {
    id: ID!
    owner: ID!
    src: String
}

input CreatePictureInput {
    owner: ID!
    src: String!
}

Elija Save Schema (Guardar esquema) para guardar el esquema.

Algunos de los campos de esquema se han comentado con la directiva @aws_auth. Como la configuración de acciones API predeterminada está establecida en DENY, API rechaza a todos los usuarios que no sean miembros de los grupos mencionados en la directiva @aws_auth. Para obtener más información sobre cómo proteger su seguridadAPI, puede leer la página de seguridad. En este caso, solo los usuarios administradores tienen acceso a la mutación. createPicturey Mutación. createFriendshipcampos, mientras que los usuarios que son miembros de los grupos de administradores o de espectadores pueden acceder a la consulta. getPicturesByCampo propietario. Todos los demás usuarios no tienen acceso.

Configuración de solucionadores

Ahora que tiene un esquema GraphQL válido y dos orígenes de datos, puede asociar los solucionadores a los campos de GraphQL en el esquema. APIOfrece las siguientes capacidades:

Mutación. createPicture

En el editor de esquemas de la AWS AppSync consola, en el lado derecho, selecciona Attach Resolver forcreatePicture(input: CreatePictureInput!): Picture!. Elija la fuente de datos de PicturesDynamoDBTableDynamoDB. En la sección Plantilla de mapeo de solicitudes, añada la siguiente plantilla:

#set($id = $util.autoId())

{
    "version" : "2018-05-29",

    "operation" : "PutItem",

    "key" : {
        "id" : $util.dynamodb.toDynamoDBJson($id),
        "owner": $util.dynamodb.toDynamoDBJson($ctx.args.input.owner)
    },

    "attributeValues" : $util.dynamodb.toMapValuesJson($ctx.args.input)
}

En la sección Plantilla de mapeo de respuestas, añada la siguiente plantilla:

#if($ctx.error)
    $util.error($ctx.error.message, $ctx.error.type)
#end
$util.toJson($ctx.result)

La funcionalidad de creación de imagen está lista. Está guardando una imagen en la tabla Imágenes, utilizando un UUID as id de la imagen generado aleatoriamente y utilizando el nombre de usuario de Cognito como propietario de la imagen.

Mutación. createFriendship

En el editor de esquemas de la AWS AppSync consola, en el lado derecho, selecciona Attach Resolver forcreateFriendship(id: ID!, target: ID!): Boolean. Elija la fuente de datos de FriendsDynamoDBTableDynamoDB. En la sección Plantilla de mapeo de solicitudes, añada la siguiente plantilla:

#set($userToFriendFriendship = { "userId" : "$ctx.args.id", "friendId": "$ctx.args.target" })
#set($friendToUserFriendship = { "userId" : "$ctx.args.target", "friendId": "$ctx.args.id" })
#set($friendsItems = [$util.dynamodb.toMapValues($userToFriendFriendship), $util.dynamodb.toMapValues($friendToUserFriendship)])

{
    "version" : "2018-05-29",
    "operation" : "BatchPutItem",
    "tables" : {
        ## Replace 'AppSyncTutorial-' default below with the ResourceNamePrefix you provided in the CloudFormation template
        "AppSyncTutorial-Friends": $util.toJson($friendsItems)
    }
}

Importante: En la plantilla de BatchPutItemsolicitud, debe estar presente el nombre exacto de la tabla de DynamoDB. El nombre predeterminado de la tabla es -FriendsAppSyncTutorial. Si utilizas un nombre de tabla incorrecto, aparecerá un error cuando AppSync intentes asumir el rol proporcionado.

Para simplificar este tutorial, proceda como si la solicitud de amistad hubiera sido aprobada y guarde la entrada sobre la relación directamente en la AppSyncTutorialFriendstabla.

Efectivamente, está almacenando dos elementos para cada amistad, ya que la relación es bidireccional. Para obtener más información sobre las prácticas recomendadas de Amazon DynamoDB para many-to-many representar relaciones, consulte Prácticas recomendadas de DynamoDB.

En la sección Plantilla de mapeo de respuestas, añada la siguiente plantilla:

#if($ctx.error)
    $util.error($ctx.error.message, $ctx.error.type)
#end
true

Nota: Asegúrese de que su plantilla de solicitud contiene el nombre de la tabla correcto. El nombre predeterminado es AppSyncTutorial-Friends, pero el nombre de la tabla podría ser diferente si cambiara el parámetro. CloudFormation ResourceNamePrefix

Consulta. getPicturesByDueño

Ahora que tiene amistades e imágenes, debe proporcionar la capacidad a los usuarios de ver las imágenes de sus amigos. Para cumplir este requisito, debe comprobar primero que el solicitante es amigo con el propietario y, por último, consultar las imágenes.

Dado que esta funcionalidad requiere dos operaciones de origen de datos, va a crear dos funciones. La primera función isFriend, comprueba si el solicitante y el propietario son amigos. La segunda función, getPicturesByPropietario, recupera las imágenes solicitadas con un identificador de propietario. Veamos el siguiente flujo de ejecución para el solucionador propuesto en la consulta. getPicturesByCampo propietario:

Primero, vamos a crear las funciones.

isFriend Función

Resultado: has creado la isFriendfunción.

getPicturesByFunción propietaria

Resultado: ha creado la función getPicturesByPropietario. Ahora que se han creado las funciones, adjunta un solucionador de canalizaciones a la consulta. getPicturesByCampo propietario.

En el editor de esquemas de la AWS AppSync consola, en el lado derecho, selecciona Attach Resolver forQuery.getPicturesByOwner(id: ID!): [Picture]. En la página siguiente, elija el enlace Convert to pipeline resolver (Convertir a solucionador de canalización) que aparece debajo de la lista desplegable del origen de datos. Use lo siguiente para la plantilla de mapeo de antes:

#set($result = { "owner": $ctx.args.id, "callerId": $ctx.identity.username })
$util.toJson($result)

En la sección after mapping template (plantilla de mapeo de después), use lo siguiente:

#foreach($picture in $ctx.result.items)
    ## prepend "src://" to picture.src property
    #set($picture['src'] = "src://${picture['src']}")
#end
$util.toJson($ctx.result.items)

Elija Create Resolver (Crear solucionador). Acaba de asociar su primer solucionador de canalización. En la misma página, añada las dos funciones que ha creado anteriormente. En la sección de funciones, elija Añadir una función y, a continuación, elija o escriba el nombre de la primera función, isFriend. Añada la segunda función siguiendo el mismo proceso para la función getPicturesByPropietario. Asegúrese de que la isFriendfunción aparezca en primer lugar de la lista, seguida de la función getPicturesByPropietario. Puede utilizar las flechas hacia arriba y abajo para cambiar el orden de ejecución de las funciones de la canalización.

Ahora que se ha creado el solucionador de canalizaciones y has adjuntado las funciones, vamos a probar el API GraphQL recién creado.

Probando tu GraphQL API

En primer lugar, debe rellenar las imágenes y amistades ejecutando algunas mutaciones mediante el usuario administrador que ha creado. En el lado izquierdo de la AWS AppSync consola, selecciona la pestaña Consultas.

createPicture Mutación

Vamos a enviar algunas createPicturemutaciones para completar la tabla de imágenes. Ejecute la siguiente consulta de GraphQL dentro de la consola:

mutation {
  createPicture(input:{
    owner: "nadia"
    src: "nadia.jpg"
  }) {
    id
    owner
    src
  }
}

La respuesta debe tener un aspecto similar al siguiente:

{
  "data": {
    "createPicture": {
      "id": "c6fedbbe-57ad-4da3-860a-ffe8d039882a",
      "owner": "nadia",
      "src": "nadia.jpg"
    }
  }
}

Agreguemos algunas imágenes más:

mutation {
  createPicture(input:{
    owner: "shaggy"
    src: "shaggy.jpg"
  }) {
    id
    owner
    src
  }
}

mutation {
  createPicture(input:{
    owner: "rex"
    src: "rex.jpg"
  }) {
    id
    owner
    src
  }
}

Ha agregado tres imágenes usando a nadia como usuario administrador.

createFriendship Mutación

Vamos a añadir una entrada de amistad. Ejecute las siguientes mutaciones en la consola.

Nota: Debe permanecer con la sesión iniciada como usuario administrador (el valor predeterminado es nadia).

mutation {
  createFriendship(id: "nadia", target: "shaggy")
}

La respuesta debe tener un aspecto similar al siguiente:

{
  "data": {
    "createFriendship": true
  }
}

nadia y shaggy son amigos. rex no es amigo de nadie.

getPicturesByConsulta de propietario

En este paso, inicie sesión como el usuario nadia con los grupos de usuarios de Cognito, con las credenciales configuradas al principio de este tutorial. Como nadia, recupere las imágenes propiedad de shaggy.

query {
    getPicturesByOwner(id: "shaggy") {
        id
        owner
        src
    }
}

Dado que nadia y shaggy son amigos, la consulta debe devolver la imagen correspondiente.

{
  "data": {
    "getPicturesByOwner": [
      {
        "id": "05a16fba-cc29-41ee-a8d5-4e791f4f1079",
        "owner": "shaggy",
        "src": "src://shaggy.jpg"
      }
    ]
  }
}

Del mismo modo, si nadia intenta recuperar sus propias imágenes, también se ejecuta satisfactoriamente. El solucionador de canalizaciones se ha optimizado para evitar ejecutar la isFriend GetItem operación en ese caso. Pruebe la siguiente consulta:

query {
    getPicturesByOwner(id: "nadia") {
        id
        owner
        src
    }
}

Si habilitas el registro en tu API (en el panel de configuración), estableces el nivel de depuración en y vuelves a ALLejecutar la misma consulta, se devolverán los registros de la ejecución del campo. Al observar los registros, puede determinar si la isFriendfunción regresó anticipadamente en la etapa de solicitud de plantilla de mapeo:

{
  "errors": [],
  "mappingTemplateType": "Request Mapping",
  "path": "[getPicturesByOwner]",
  "resolverArn": "arn:aws:appsync:us-west-2:XXXX:apis/XXXX/types/Query/fields/getPicturesByOwner",
  "functionArn": "arn:aws:appsync:us-west-2:XXXX:apis/XXXX/functions/o2f42p2jrfdl3dw7s6xub2csdfs",
  "functionName": "isFriend",
  "earlyReturnedValue": {
    "owner": "nadia",
    "callerId": "nadia"
  },
  "context": {
    "arguments": {
      "id": "nadia"
    },
    "prev": {
      "result": {
        "owner": "nadia",
        "callerId": "nadia"
      }
    },
    "stash": {},
    "outErrors": []
  },
  "fieldInError": false
}

La earlyReturnedValueclave representa los datos devueltos por la directiva #return.

Por último, aunque rex es miembro del UserPool Grupo Cognito de los espectadores y, dado que Rex no es amigo de nadie, no podrá acceder a ninguna de las imágenes propiedad de Shaggy o Nadia. Si iniciar sesión como rex en la consola y ejecuta la siguiente consulta:

query {
    getPicturesByOwner(id: "nadia") {
        id
        owner
        src
    }
}

Obtiene el siguiente error de no autorizado:

{
  "data": {
    "getPicturesByOwner": null
  },
  "errors": [
    {
      "path": [
        "getPicturesByOwner"
      ],
      "data": null,
      "errorType": "Unauthorized",
      "errorInfo": null,
      "locations": [
        {
          "line": 2,
          "column": 9,
          "sourceName": null
        }
      ],
      "message": "Not Authorized to access getPicturesByOwner on type Query"
    }
  ]
}

Ha implementado con éxito la autorización compleja con los solucionadores de canalización.