教程:结合使用 GraphQL 解析程序 - AWS AppSync
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

教程:结合使用 GraphQL 解析程序

GraphQL 架构中的解析程序和字段具有 1:1 的关系,具有很高的灵活性。由于数据源是独立于架构在解析程序上配置的,因此您可以通过不同的数据源解析和操控 GraphQL 类型,同时在架构上混合和匹配数据源以最好地满足您的需要。

以下示例场景显示您可以如何在架构中混合和匹配数据源,但在执行此类操作之前,您应熟悉前面各部分所述的为 AWS Lambda、Amazon DynamoDB 和 Amazon Elasticsearch Service 设置数据源和解析程序的过程。

示例架构

下面的架构拥有 Post 类型(定义了 3 个 Query 操作和 3 个 Mutation 操作):

type Post { id: ID! author: String! title: String content: String url: String ups: Int downs: Int version: Int! } type Query { allPost: [Post] getPost(id: ID!): Post searchPosts: [Post] } type Mutation { addPost( id: ID!, author: String!, title: String, content: String, url: String ): Post updatePost( id: ID!, author: String!, title: String, content: String, url: String, ups: Int!, downs: Int!, expectedVersion: Int! ): Post deletePost(id: ID!): Post }

在本示例中,您共有 6 个可附加的解析程序。一种可能的方法是让所有这些解析程序都来自一个名为 Posts 的 Amazon DynamoDB 表,其中 AllPosts 运行扫描,而 searchPosts 运行查询,如 DynamoDB 解析程序映射模板参考中所述。但是,有些替代方案可满足您的业务需求,例如让这些 GraphQL 查询从 Lambda 或 Amazon ES 中进行解析。

通过解析程序更改数据

您可能需要针对某些发生变化的属性,从数据库(如 DynamoDB 或 Amazon Aurora)向客户端返回结果。这可能是由于数据类型的格式设置所致(例如,客户端上的时间戳差异),或者是为了处理向后兼容性问题。为了在下面的示例中进行说明,我们显示一个 AWS Lambda 函数,此函数控制对于博客文章的顶和踩操作:也即,每次调用 GraphQL 解析程序时,都会向它们分配随机的数字。

'use strict'; const doc = require('dynamodb-doc'); const dynamo = new doc.DynamoDB(); exports.handler = (event, context, callback) => { const payload = { TableName: 'Posts', Limit: 50, Select: 'ALL_ATTRIBUTES', }; dynamo.scan(payload, (err, data) => { const result = { data: data.Items.map(item =>{ item.ups = parseInt(Math.random() * (50 - 10) + 10, 10); item.downs = parseInt(Math.random() * (20 - 0) + 0, 10); return item; }) }; callback(err, result.data); }); };

这是一个完全有效的 Lambda 函数,可以附加到 GraphQL 架构中的 AllPosts 字段,以便返回所有结果的任何查询都可以对顶/踩操作获得随机数字。

DynamoDB 和 Amazon ES

对于某些应用程序,您可能会对 DynamoDB 文档执行更改或简单的查找查询,并让后台进程将文档传输到 Amazon ES。然后,您可以直接将 searchPosts 解析程序附加到 Amazon ES 数据源,并使用 GraphQL 查询(从源自 DynamoDB 的数据)返回搜索结果。当向您的应用程序添加高级搜索操作(例如,关键字、模糊字词匹配甚至地理空间查找)时,上述功能极其强大。从 DynamoDB 中传输数据可以通过 ETL 进程来执行,或者您可以使用 Lambda 从 DynamoDB 中进行流式传输。为此,您可以在您的 AWS 账户中使用位于美国西部 2(俄勒冈)区域的 AWS CloudFormation 堆栈,启动完整的示例:

本示例中的架构将让您使用 DynamoDB 解析程序添加文章,如下所示:

mutation add { putPost(author:"Nadia" title:"My first post" content:"This is some test content" url:"https://aws.amazon.com/appsync/" ){ id title } }

这会向 DynamoDB 写入数据,随后它通过 Lambda 将数据流式传输到 Amazon Elasticsearch Service,在此您可以按不同字段搜索所有文章。例如,由于数据在 Amazon Elasticsearch Service 中,您可以搜索具有自由格式文本(甚至带有空格)的作者或内容字段,如下所示:

query searchName{ searchAuthor(name:" Nadia "){ id title content } } query searchContent{ searchContent(text:"test"){ id title content } }

由于数据直接写入到 DynamoDB,因此您仍然可以使用 allPosts{...}singlePost{...} 查询针对表执行高效的列表或项目查找操作。此堆栈将以下示例代码用于 DynamoDB 流:

注意:此代码仅用于举例说明。

var AWS = require('aws-sdk'); var path = require('path'); var stream = require('stream'); var esDomain = { endpoint: 'https://elasticsearch-domain-name.REGION.es.amazonaws.com', region: 'REGION', index: 'id', doctype: 'post' }; var endpoint = new AWS.Endpoint(esDomain.endpoint) var creds = new AWS.EnvironmentCredentials('AWS'); function postDocumentToES(doc, context) { var req = new AWS.HttpRequest(endpoint); req.method = 'POST'; req.path = '/_bulk'; req.region = esDomain.region; req.body = doc; req.headers['presigned-expires'] = false; req.headers['Host'] = endpoint.host; // Sign the request (Sigv4) var signer = new AWS.Signers.V4(req, 'es'); signer.addAuthorization(creds, new Date()); // Post document to ES var send = new AWS.NodeHttpClient(); send.handleRequest(req, null, function (httpResp) { var body = ''; httpResp.on('data', function (chunk) { body += chunk; }); httpResp.on('end', function (chunk) { console.log('Successful', body); context.succeed(); }); }, function (err) { console.log('Error: ' + err); context.fail(); }); } exports.handler = (event, context, callback) => { console.log("event => " + JSON.stringify(event)); var posts = ''; for (var i = 0; i < event.Records.length; i++) { var eventName = event.Records[i].eventName; var actionType = ''; var image; var noDoc = false; switch (eventName) { case 'INSERT': actionType = 'create'; image = event.Records[i].dynamodb.NewImage; break; case 'MODIFY': actionType = 'update'; image = event.Records[i].dynamodb.NewImage; break; case 'REMOVE': actionType = 'delete'; image = event.Records[i].dynamodb.OldImage; noDoc = true; break; } if (typeof image !== "undefined") { var postData = {}; for (var key in image) { if (image.hasOwnProperty(key)) { if (key === 'postId') { postData['id'] = image[key].S; } else { var val = image[key]; if (val.hasOwnProperty('S')) { postData[key] = val.S; } else if (val.hasOwnProperty('N')) { postData[key] = val.N; } } } } var action = {}; action[actionType] = {}; action[actionType]._index = 'id'; action[actionType]._type = 'post'; action[actionType]._id = postData['id']; posts += [ JSON.stringify(action), ].concat(noDoc?[]:[JSON.stringify(postData)]).join('\n') + '\n'; } } console.log('posts:',posts); postDocumentToES(posts, context); };

然后,您可以使用 DynamoDB 流将此代码附加到主键为 id 的 DynamoDB 表,对 DynamoDB 的源代码所做的任何更改都将流式传输到您的 Amazon ES 域。有关配置上述功能的更多信息,请参阅 DynamoDB 流文档