Creación de GraphQL APIs con introspección de RDS

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.

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.

Su utilidad de introspección de AWS AppSync puede descubrir modelos a partir de tablas de bases de datos y proponer tipos de GraphQL. El asistente de creación de API de la AWS AppSync consola puede generar instantáneamente una API a partir de una base de datos Aurora MySQL o PostgreSQL. Crea automáticamente tipos y JavaScript resolutores para leer y escribir datos.

AWS AppSync proporciona una integración directa con las bases de datos de Amazon Aurora a través de la API de datos de Amazon RDS. En lugar de requerir una conexión de base de datos persistente, la API de datos de Amazon RDS ofrece un punto de enlace HTTP seguro al que AWS AppSync se conecta para ejecutarse SQL declaraciones. Puede utilizarlo para crear una API de base de datos relacional para sus cargas de trabajo de MySQL y PostgreSQL en Aurora.

Crear una API para su base de datos relacional AWS AppSync tiene varias ventajas:

AWS AppSync facilita la creación APIs a partir de bases de datos relacionales existentes. Su utilidad de introspección puede descubrir modelos a partir de tablas de bases de datos y proponer tipos de GraphQL. El asistente Creación de API de la consola de AWS AppSync puede generar una API al instante a partir de una base de datos Aurora MySQL o PostgreSQL. Crea automáticamente tipos y JavaScript resolutores para leer y escribir datos.

AWS AppSync proporciona JavaScript utilidades integradas para simplificar la escritura de sentencias SQL en los resolutores. Puede utilizar las plantillas AWS AppSync de sql etiquetas para sentencias estáticas con valores dinámicos o las utilidades del rds módulo para crear sentencias mediante programación. Para obtener más información, consulte los orígenes de datos Referencia a la función de solucionador para RDS y los módulos integrados.

Uso de la característica de introspección (consola)

Para ver un tutorial detallado y una guía de introducción, consulte Tutorial: Aurora PostgreSQL sin servidor con API de datos.

La AWS AppSync consola le permite crear una API AWS AppSync GraphQL a partir de su base de datos Aurora existente configurada con la API de datos en solo unos minutos. Esto genera rápidamente un esquema operativo basado en la configuración de la base de datos. Puede usar la API tal cual o desarrollarla para añadir características.

Uso de la característica de introspección (API)

Puede usar la API de introspección StartDataSourceIntrospection para descubrir modelos en su base de datos mediante programación. Para obtener más información sobre el comando, consulte el uso de la API StartDataSourceIntrospection.

Para usarloStartDataSourceIntrospection, proporcione el nombre de recurso de Amazon (ARN), el nombre de la base de datos y AWS Secrets Manager el ARN secreto del clúster Aurora. El comando inicia el proceso de introspección. Puede recuperar los resultados con el comando GetDataSourceIntrospection. Puede especificar si el comando debe devolver la cadena de lenguaje de definición de almacenamiento (SDL) de los modelos descubiertos. Esto resulta útil para generar una definición de esquema de SDL directamente a partir de los modelos descubiertos.

Por ejemplo, si tiene la siguiente instrucción de lenguaje de definición de datos (DDL) para una tabla Todos sencilla:

create table if not exists public.todos  
(  
id serial constraint todos_pk primary key,  
description text,  
due timestamp,  
"createdAt" timestamp default now()  
);

Comience la introspección con lo siguiente.

aws appsync start-data-source-introspection \ 
  --rds-data-api-config resourceArn=<cluster-arn>,secretArn=<secret-arn>,databaseName=database

A continuación, utilice el comando GetDataSourceIntrospection para recuperar el resultado.

aws appsync get-data-source-introspection \
  --introspection-id a1234567-8910-abcd-efgh-identifier \
  --include-models-sdl

Esto devuelve el resultado siguiente.

{
    "introspectionId": "a1234567-8910-abcd-efgh-identifier",
    "introspectionStatus": "SUCCESS",
    "introspectionStatusDetail": null,
    "introspectionResult": {
        "models": [
            {
                "name": "todos",
                "fields": [
                    {
                        "name": "description",
                        "type": {
                            "kind": "Scalar",
                            "name": "String",
                            "type": null,
                            "values": null
                        },
                        "length": 0
                    },
                    {
                        "name": "due",
                        "type": {
                            "kind": "Scalar",
                            "name": "AWSDateTime",
                            "type": null,
                            "values": null
                        },
                        "length": 0
                    },
                    {
                        "name": "id",
                        "type": {
                            "kind": "NonNull",
                            "name": null,
                            "type": {
                                "kind": "Scalar",
                                "name": "Int",
                                "type": null,
                                "values": null
                            },
                            "values": null
                        },
                        "length": 0
                    },
                    {
                        "name": "createdAt",
                        "type": {
                            "kind": "Scalar",
                            "name": "AWSDateTime",
                            "type": null,
                            "values": null
                        },
                        "length": 0
                    }
                ],
                "primaryKey": {
                    "name": "PRIMARY_KEY",
                    "fields": [
                        "id"
                    ]
                },
                "indexes": [],
                "sdl": "type todos\n{\ndescription: String\n\ndue: AWSDateTime\n\nid: Int!\n\ncreatedAt: AW
SDateTime\n}\n"
            }
        ],
        "nextToken": null
    }
}