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.
Introducción: Cómo crear su primera API de GraphQL en AWS AppSync
Puede usar la consola de AWS AppSync para configurar y lanzar una API de GraphQL. Las API de GraphQL suelen requerir tres componentes:
-
Esquema de GraphQL: tu esquema de GraphQL es la base para crear la API. Define los tipos y campos que puede solicitar al ejecutar una operación. Para rellenar el esquema con datos, debe conectar los orígenes de datos a la API de GraphQL. En esta guía rápida, crearemos un esquema utilizando un modelo predefinido.
-
Orígenes de datos: son los recursos que contienen los datos para rellenar tu API de GraphQL. Puede ser una tabla de DynamoDB, una función de Lambda, etc. AWS AppSync admite diversos orígenes de fuentes de datos para crear API de GraphQL robustas y escalables. Los orígenes de datos están vinculados a los campos del esquema. Siempre que se realiza una solicitud en un campo, los datos del origen rellenan el campo. Este mecanismo lo controla el solucionador. En esta guía rápida, crearemos un origen de datos utilizando un modelo predefinido junto con el esquema.
-
Solucionadores: los solucionadores se ocupan de vincular el campo del esquema al origen de datos. Recuperan los datos del origen y, a continuación, devuelven el resultado en función de lo que haya definido el campo AWS. AppSync es compatible tanto con JavaScript como con VTL para escribir solucionadores para las API de GraphQL. En esta guía rápida, los solucionadores se generarán automáticamente en función del esquema y el origen de datos. No vamos a tratar este tema en profundidad en esta sección.
AWS AppSync admite la creación y la configuración de todos los componentes de GraphQL. Al abrir la consola, puede usar los siguientes métodos para crear su API:
-
Diseñar una API de GraphQL personalizada generándola mediante un modelo predefinido y configurando una nueva tabla de DynamoDB (origen de datos) para respaldarla.
-
Diseñar una API de GraphQL con un esquema en blanco y sin orígenes de datos ni solucionadores.
-
Usar una tabla de DynamoDB para importar datos y generar los tipos y campos de su esquema.
-
Usar las capacidades de WebSocket de AWS AppSync y la arquitectura Pub/Sub para desarrollar API en tiempo real.
-
Usar las API de GraphQL (API de origen) existentes para vincularlas a una API fusionada.
nota
Es aconsejable consultar la sección Diseñar un esquema antes de trabajar con herramientas más avanzadas. En estas guías se explican ejemplos más sencillos que puede utilizar como base teórica para crear aplicaciones más complejas en AWS AppSync.
AWS AppSync también admite varias opciones que no son de consola para crear API de GraphQL. Entre ellos se incluyen:
-
AWS Amplify
AWS SAM
-
CloudFormation
-
El CDK.
En el siguiente ejemplo, se muestra cómo crear los componentes básicos de una API de GraphQL mediante modelos predefinidos y DynamoDB.