Lanzamiento de un esquema en la consola de AWS AppSync - AWS AppSync GraphQL

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.

Lanzamiento de un esquema en la consola de AWS AppSync

En este ejemplo, creará una API Todo que permitirá a los usuarios crear elementos Todo como recordatorios de tareas diarias, como terminar un trabajo o pasar a recoger la compra. Esta API muestra cómo utilizar las operaciones de GraphQL cuando el estado persiste en una tabla de DynamoDB.

A nivel teórico, hay tres pasos principales para crear su primera API de GraphQL. Debe definir el esquema (tipos y campos), asociar los orígenes de datos a los campos y, a continuación, escribir el solucionador que gestiona la lógica empresarial. Sin embargo, la experiencia con la consola sugiere que es mejor cambiar este orden. Empezaremos por definir cómo queremos que nuestro origen de datos interactúe con nuestro esquema y, más adelante, definiremos el esquema y el solucionador.

Para crear su API de GraphQL
  1. Inicie sesión en la Consola de administración de AWS y abra la consola de AppSync.

  2. En el Panel, elija Crear API.

  3. Mantenga seleccionada la API de GraphQL y elija Diseñar desde cero. A continuación, elija Siguiente.

  4. En el Nombre de la API, cambie el nombre rellenado previamente a Todo API. Después, seleccione Siguiente.

    nota

    Hay más opciones presentes aquí, pero no las usaremos en este ejemplo.

  5. En la sección Especificar recursos de GraphQL, haga lo siguiente:

    1. Seleccione Crear tipo respaldado por una tabla de DynamoDB ahora.

      nota

      Esto significa que vamos a crear una nueva tabla de DynamoDB para asociarla como origen de datos.

    2. En el campo Nombre del modelo, escriba Todo.

      nota

      Nuestro primer requisito es definir nuestro esquema. Este Nombre del modelo será el nombre del tipo, de modo que lo que realmente está haciendo es crear un type llamado Todo que existirá en el esquema:

      type Todo {}
    3. En Campos, haga lo siguiente:

      1. Cree un campo llamado id, con el tipo ID y el valor obligatorio establecido en Yes.

        nota

        Estos son los campos que existirán dentro del ámbito de su tipo Todo. Aquí, el nombre de su campo se llamará id con un tipo de ID!:

        type Todo { id: ID! }

        AWS AppSync admite varios valores escalares para distintos casos de uso.

      2. Con Agregar nuevo campo, cree cuatro campos adicionales con los valores Name definidos como name, when, where y description. Sus valores Type serán String, y los valores Array y Required se establecerán en No. Tendrá un aspecto similar al siguiente:

        Model information form showing fields for a Todo model with ID, name, when, where, and description.
        nota

        El tipo completo y sus campos tendrán un aspecto similar al siguiente:

        type Todo { id: ID! name: String when: String where: String description: String }

        Como vamos a crear un esquema con este modelo predefinido, también se rellenará con varias mutaciones reutilizables basadas en el tipo (por ejemplo, create, delete y update) para ayudarle a rellenar el origen de datos fácilmente.

    4. En Configurar la tabla del modelo, introduzca un nombre de tabla, como TodoAPITable. Establezca la clave principal en id.

      nota

      Básicamente, estamos creando una nueva tabla de DynamoDB llamada TodoAPITable que se asociará a la API como nuestro origen de datos principal. Nuestra clave principal se establece en el campo obligatorio id que definimos anteriormente. Tenga en cuenta que esta nueva tabla está en blanco y no contiene nada excepto la clave de partición.

    5. Elija Siguiente.

  6. Revise los cambios y seleccione Crear API. Espere un momento a que el servicio AWS AppSync termine de crear su API.

Ha creado correctamente una API de GraphQL con su esquema y su origen de datos de DynamoDB. Para resumir los pasos anteriores, hemos creado una API de GraphQL completamente nueva. Hemos definido el nombre de la API y, a continuación, hemos agregado nuestra definición de esquema agregando nuestro primer tipo. Hemos definido el tipo y sus campos y, a continuación, hemos optado por asociar un origen de datos a uno de los campos creando una nueva tabla de DynamoDB sin datos.