Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

RDS 自省

Amazon AppSync 使从现有关系数据库构建 API 变得容易。它的自省实用程序可以从数据库表中发现模型并建议 GraphQL 类型。Amazon AppSync 控制台的“创建 API”向导可以立即从 Aurora MySQL 或 PostgreSQL 数据库生成 API。它会自动创建用于读取和写入数据的类型和 JavaScript 解析器。

Amazon AppSync 通过 Amazon RDS 数据 API 提供与 Amazon Aurora 数据库的直接集成。Amazon RDS 数据 API 不要求永久数据库连接，而是提供了一个安全 HTTP 端点，Amazon AppSync 连接到该端点以运行 SQL 语句。您可以利用这一点在 Aurora 上为您的 MySQL 和 PostgreSQL 工作负载创建关系数据库 API。

使用 Amazon AppSync 为关系数据库构建 API 有几个优点：

Amazon AppSync 使从现有关系数据库构建 API 变得容易。它的自省实用程序可以从数据库表中发现模型并建议 GraphQL 类型。Amazon AppSync 控制台的创建 API 向导可以立即从 Aurora MySQL 或 PostgreSQL 数据库生成 API。它会自动创建用于读取和写入数据的类型和 JavaScript 解析器。

Amazon AppSync 提供了集成的 JavaScript 实用程序，以简化在解析器中编写 SQL 语句。您可以将 Amazon AppSync 的 sql 标签模板用于具有动态值的静态语句，也可以使用 rds 模块实用程序以编程方式构建语句。有关更多信息，请参阅 RDS 的解析器函数参考数据来源和内置模块。

使用自省特征（控制台）

有关详细教程和入门指南，请参阅教程：带数据 API 的 Aurora PostgreSQL Serverless。

Amazon AppSync 控制台可让您在短短几分钟内从配置了数据 API 的现有 Aurora 数据库创建 Amazon AppSync GraphQL API。这会根据您的数据库配置快速生成操作架构。您可以按原样使用 API，也可以在它的基础之上构建来添加特征。

使用自省特征 (API)

您可以使用 StartDataSourceIntrospection 自省 API 以编程方式发现数据库中的模型。有关该命令的更多详细信息，请参阅“使用 StartDataSourceIntrospection API”。

要使用 StartDataSourceIntrospection，请提供您的 Aurora 集群 Amazon 资源名称 (ARN)、数据库名称和 Amazon Secrets Manager 密钥 ARN。该命令启动自省过程。您可以使用 GetDataSourceIntrospection 命令检索结果。您可以指定该命令是否应返回已发现模型的存储定义语言 (SDL) 字符串。这对于直接从已发现的模型生成 SDL 架构定义非常有用。

例如，如果您对简单 Todos 表使用以下数据定义语言 (DDL) 语句：

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

您从以下内容开始自省。

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

接下来，使用 GetDataSourceIntrospection 命令检索结果。

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

这会返回以下结果。

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