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.
Antes de añadir datos a nuestra tabla de DynamoDB, debemos revisar las características básicas de la experiencia de AWS AppSync la consola. La pestaña de AWS AppSync consola situada en la parte izquierda de la página permite a los usuarios navegar fácilmente hasta cualquiera de los principales componentes u opciones de configuración, que incluyen: AWS AppSync
Diseñador del esquema
Seleccione Esquema para ver el esquema que acaba de crear. Si revisa el contenido del esquema, verá que ya incluye un gran número de operaciones auxiliares para agilizar el proceso de desarrollo. En el editor de esquemas, si se desplaza por el código, llegará finalmente al modelo que definió en la sección anterior:
type Todo {
id: ID!
name: String
when: String
where: String
description: String
}Su modelo ha pasado a ser el tipo en el que se ha basado la creación de todo el esquema. Empezaremos a agregar datos a nuestro origen de datos mediante mutaciones que se han generado automáticamente a partir de este tipo.
Estos son algunos consejos y datos adicionales sobre el editor de esquemas:
-
El editor de código tiene funcionalidades de análisis y de comprobación de errores que puede utilizar al escribir sus propias aplicaciones.
-
En la parte derecha de la consola se muestran los tipos de GraphQL que se han creado y los solucionadores en diferentes tipos de nivel superior, como, por ejemplo, las consultas.
-
Al añadir nuevos tipos a un esquema (por ejemplo,
type User {...}), puede hacer que AWS AppSync aprovisione los recursos de DynamoDB por usted. Entre estos se incluyen la clave principal, la clave de clasificación y el diseño del índice adecuados que coincidan mejor con su patrón de acceso a los datos de GraphQL. Si elige Create Resources (Crear recursos) en la parte superior y elige uno de estos tipos definidos por el usuario en el menú, puede elegir diferentes opciones de campo en el diseño de esquema. Hablaremos de esto en la sección de diseño de un esquema.
Configuración del solucionador
En el diseñador de esquemas, la sección Solucionadores contiene todos los tipos y campos del esquema. Si se desplaza por la lista de campos, verá que puede adjuntar solucionadores a determinados campos si selecciona Asociar. Esto abrirá un editor de código en el que podrá escribir el código de resolución. AWS AppSync admite tanto VTL como JavaScript tiempos de ejecución, que se pueden cambiar en la parte superior de la página seleccionando Acciones y, a continuación, Actualizar tiempo de ejecución. En la parte inferior de la página, también puede crear funciones que ejecutarán varias operaciones en secuencia. Sin embargo, los solucionadores son un tema avanzado y no lo trataremos en esta sección.
Origen de datos
Seleccione Orígenes de datos para ver su tabla de DynamoDB. Al elegir la opción Resource (si está disponible), puede ver la configuración de su origen de datos. En nuestro ejemplo, esto lleva a la consola DynamoDB. Desde allí, puede editar sus datos. También puede editar directamente algunos de los datos seleccionando el origen de datos y, a continuación, seleccionando Editar. Si alguna vez necesita eliminar el origen de datos, puede elegir el origen de datos y, a continuación, seleccionar Eliminar. Por último, puede crear nuevos orígenes de datos. Para ello, seleccione Crear origen de datos y, a continuación, configure el nombre y el tipo. Tenga en cuenta que esta opción sirve para vincular el AWS AppSync servicio a un recurso existente. Aún debe crear el recurso en su cuenta mediante el servicio correspondiente antes de AWS AppSync reconocerlo.
Consultas
Seleccione Consultas para ver sus consultas y mutaciones. Cuando creamos nuestra API GraphQL con nuestro modelo, generamos AWS AppSync automáticamente algunas mutaciones y consultas auxiliares con fines de prueba. En el editor de consultas, en el lado izquierdo se encuentra el Explorador. Esta es una lista que muestra todas sus mutaciones y consultas. Aquí puede activar fácilmente las operaciones y los campos que desea utilizar haciendo clic en los valores de sus nombres. Esto hará que el código aparezca automáticamente en la parte central del editor. Aquí puede editar sus mutaciones y consultas modificando los valores. En la parte inferior del editor, tiene el editor de Variables de consulta, que le permite introducir los valores de los campos para las variables de entrada de sus operaciones. Al seleccionar Ejecutar en la parte superior del editor, aparecerá una lista desplegable para seleccionar la consulta o mutación que se va a ejecutar. El resultado de esta ejecución aparecerá en el lado derecho de la página. Al volver a la sección Explorador de la parte superior, puede elegir una operación (Consulta, Mutación o Suscripción) y, a continuación, elegir el símbolo + para agregar una nueva instancia de esa operación en particular. En la parte superior de la página, habrá otra lista desplegable que contiene el modo de autorización para la ejecución de sus consultas. Sin embargo, no abordaremos esa característica en esta sección (para obtener más información, consulte Seguridad).
Configuración
Seleccione Ajustes para ver algunas opciones de configuración de su API de GraphQL. Aquí puede habilitar algunas opciones, como el registro, el rastreo y la funcionalidad de firewall de aplicaciones web. También puede agregar nuevos modos de autorización para proteger sus datos de filtraciones no deseadas al público en general. Sin embargo, estas opciones son más avanzadas y no las abordaremos en esta sección.
nota
Nota: El modo de autorización predeterminado, API_KEY, utiliza una clave de API para probar la aplicación. Esta es la autorización básica que se otorga a todos los APIs GraphQL recién creados. Es aconsejable utilizar un método de producción diferente. Para ilustrar el ejemplo que nos ocupa, solo usaremos la clave de API. Para obtener más información acerca de los modos de autorización, consulte Seguridad.
