Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création de GraphQL APIs grâce à l'introspection RDS

AWS AppSync l'utilitaire d'introspection permet de découvrir des modèles à partir de tables de base de données et de proposer des types GraphQL. L'APIassistant de création de la AWS AppSync console peut générer instantanément de l'ADN API à partir d'une SQL base de données Aurora My SQL ou Postgre. Il crée automatiquement des types et des JavaScript résolveurs pour lire et écrire des données.

AWS AppSync fournit une intégration directe aux bases de données Amazon Aurora via Amazon RDS DataAPI. Plutôt que de nécessiter une connexion permanente à la base de données, Amazon RDS Data API propose un point de HTTP terminaison sécurisé qui AWS AppSync se connecte pour exécuter SQL déclarations. Vous pouvez l'utiliser pour créer une base de données relationnelle API pour vos charges de SQL travail My SQL et Postgre sur Aurora.

La création d'un API pour votre base de données relationnelle AWS AppSync présente plusieurs avantages :

AWS AppSync facilite la création APIs à partir de bases de données relationnelles existantes. Son utilitaire d'introspection permet de découvrir des modèles à partir de tables de base de données et de proposer des types GraphQL. L'APIassistant de création de la AWS AppSync console peut générer instantanément de l'ADN API à partir d'une SQL base de données Aurora My SQL ou Postgre. Il crée automatiquement des types et des JavaScript résolveurs pour lire et écrire des données.

AWS AppSync fournit des JavaScript utilitaires intégrés pour simplifier l'écriture d'SQLinstructions dans les résolveurs. Vous pouvez utiliser les modèles AWS AppSync de sql balises pour les instructions statiques avec des valeurs dynamiques, ou les utilitaires du rds module pour créer des instructions par programmation. Consultez la référence des fonctions de résolution pour les sources de RDS données et les modules intégrés pour en savoir plus.

Utilisation de la fonction d'introspection (console)

Pour un didacticiel détaillé et un guide de démarrage, voir Tutoriel : Aurora Postgre SQL Serverless with Data. API

La AWS AppSync console vous permet de créer un AWS AppSync GraphQL à API partir de votre base de données Aurora existante configurée avec les données API en quelques minutes seulement. Cela génère rapidement un schéma opérationnel basé sur la configuration de votre base de données. Vous pouvez l'utiliser API tel quel ou le développer pour ajouter des fonctionnalités.

Utilisation de la fonction d'introspection () API

Vous pouvez utiliser l'StartDataSourceIntrospectionintrospection API pour découvrir des modèles dans votre base de données par programmation. Pour plus de détails sur la commande, reportez-vous à la section Utilisation du StartDataSourceIntrospectionAPI.

Pour l'utiliserStartDataSourceIntrospection, indiquez le nom de ressource Amazon (ARN), le nom de la base de données et le code AWS Secrets Manager secret de votre cluster AuroraARN. La commande lance le processus d'introspection. Vous pouvez récupérer les résultats à l'aide de la GetDataSourceIntrospection commande. Vous pouvez spécifier si la commande doit renvoyer la chaîne Storage Definition Language (SDL) pour les modèles découverts. Cela est utile pour générer une définition de SDL schéma directement à partir des modèles découverts.

Par exemple, si vous avez l'instruction Data definition language (DDL) suivante pour une Todos table simple :

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

Vous commencez l'introspection par ce qui suit.

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

Ensuite, utilisez la GetDataSourceIntrospection commande pour récupérer le résultat.

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

Cela renvoie le résultat suivant.

{
    "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
    }
}