RDS 的解析器映射模板参考 - Amazon AppSync
请求映射模板版本声明和VariableMapVariableTypeHintMap
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

RDS 的解析器映射模板参考

警告

我们正在慢慢取消对 VTL 的文档支持，转而使用 APPSYNC_JS。请考虑使用 APPSYNC_JS 运行时及其指南这里。

的Amazon AppSyncRDS 解析器映射模板允许开发人员向适用于 Amazon Aurora Serverless 的数据 API 发送 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'"
    ]
}

版本

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

"version": "2018-05-29"

声明和VariableMap

语句数组是开发者提供的查询的占位符。目前，每个请求映射模板最多支持两个查询。的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)
    }
}

Amazon AppSync将使用变量映射值来构造SqlParameterized将发送到亚马逊 Aurora 无服务器数据 API 的查询。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"
     }
}

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