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

AWS AppSync 的解析器映射模板参考 RDS

AWS AppSync RDS解析器映射模板允许开发人员向API适用于 Amazon Aurora Serverless 的数据发送SQL查询，并获取这些查询的结果。

请求映射模板

RDS请求映射模板相当简单：

{
    "version": "2018-05-29",
    "statements": [],
    "variableMap": {},
    "variableTypeHintMap": {}
}

这是解析后的RDS请求映射模板的JSON架构表示形式。

{
    "definitions": {},
    "$schema": "https://json-schema.org/draft-07/schema#",
    "$id": "https://example.com/root.json",
    "type": "object",
    "title": "The Root Schema",
    "required": [
        "version",
        "statements",
        "variableMap"
    ],
    "properties": {
        "version": {
            "$id": "#/properties/version",
            "type": "string",
            "title": "The Version Schema",
            "default": "",
            "examples": [
                "2018-05-29"
            ],
            "enum": [
                "2018-05-29"
            ],
            "pattern": "^(.*)$"
        },
        "statements": {
            "$id": "#/properties/statements",
            "type": "array",
            "title": "The Statements Schema",
            "items": {
                "$id": "#/properties/statements/items",
                "type": "string",
                "title": "The Items Schema",
                "default": "",
                "examples": [
                    "SELECT * from BOOKS"
                ],
                "pattern": "^(.*)$"
            }
        },
        "variableMap": {
            "$id": "#/properties/variableMap",
            "type": "object",
            "title": "The Variablemap Schema"
        },
        "variableTypeHintMap": {
            "$id": "#/properties/variableTypeHintMap",
            "type": "object",
            "title": "The variableTypeHintMap Schema"
        }
    }
}

以下是一个具有静态查询的请求映射模板示例：

{
    "version": "2018-05-29",
    "statements": [
        "select title, isbn13 from BOOKS where author = 'Mark Twain'"
    ]
}

版本

version 字段是所有请求映射模板通用的，用于定义模板使用的版本。version 字段为必填项。值 “2018-05-29” 是亚马逊RDS地图模板支持的唯一版本。

"version": "2018-05-29"

声明和 VariableMap

statements 数组是开发人员提供的查询的占位符。目前，每个请求映射模板最多支持两个查询。variableMap是一个可选字段，其中包含别名，可用于使SQL语句更短、更具可读性。例如，可以编写以下代码：

{
"version": "2018-05-29",
    "statements": [
        "insert into BOOKS VALUES (:AUTHOR, :TITLE, :ISBN13)",
        "select * from BOOKS WHERE isbn13 = :ISBN13"
    ],
    "variableMap": {
        ":AUTHOR": $util.toJson($ctx.args.newBook.author),
        ":TITLE": $util.toJson($ctx.args.newBook.title),
        ":ISBN13": $util.toJson($ctx.args.newBook.isbn13)
    }
}

AWS AppSync 将使用变量映射值来构造将发送到 Amazon Aurora 无服务器数据的SqlParameterizedAPI查询。这些SQL语句使用变量映射中提供的参数执行，从而消除了SQL注入的风险。

VariableTypeHintMap

variableTypeHintMap是一个可选字段，其中包含可用于发送SQL参数类型提示的别名类型。这些类型提示避免在语句中进行显式转换，从而使SQL语句更短。例如，可以编写以下代码：

{
    "version": "2018-05-29",
    "statements": [
        "insert into LOGINDATA VALUES (:ID, :TIME)",
        "select * from LOGINDATA WHERE id = :ID"
     ],
     "variableMap": {
        ":ID": $util.toJson($ctx.args.id),
        ":TIME": $util.toJson($ctx.args.time)
     },
     "variableTypeHintMap": {
        ":id": "UUID",
        ":time": "TIME"
     }
}

AWS AppSync 将使用变量映射值来构造发送到 Amazon Aurora 无服务器数据的API查询。它还使用variableTypeHintMap数据并将该类型的信息发送到RDS。RDS支持typeHints可以在这里找到。