本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
可以找到这里。