本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
入門:在 API中建立第一個 GraphQL AWS AppSync
您可以使用 AWS AppSync 主控台來設定和啟動 GraphQL API。GraphQL APIs通常需要三個元件:
-
GraphQL 結構描述 - 您的 GraphQL 結構描述是 的藍圖API。它定義了執行操作時您可以請求的類型和欄位。若要將資料填入結構描述,您必須將資料來源連接至 GraphQL API。在本快速入門指南中,我們將使用預先定義的模型建立結構描述。
-
資料來源 - 這些資源包含用於填入 GraphQL 的資料API。這可以是 DynamoDB 資料表、Lambda 函數等。 AWS AppSync 支援許多資料來源,以建置強大且可擴展的 GraphQLAPIs。資料來源會連結至結構描述中的欄位。每當在 欄位上執行請求時,來源的資料都會填入 欄位。此機制由解析器控制。在本快速入門指南中,我們將使用預先定義的模型以及結構描述來建立資料來源。
-
解析程式 - 解析程式負責將結構描述欄位連結至資料來源。它們會從來源擷取資料,然後根據 欄位定義傳回結果。 AWS AppSync 支援 JavaScript 和 VTL,以便寫入 GraphQL 的解析器APIs。在本快速入門指南中,解析程式會根據結構描述和資料來源自動產生。在本節中,我們不會深入探討這一點。
AWS AppSync 支援所有 GraphQL 元件的建立和組態。開啟主控台時,您可以使用下列方法來建立 API:
-
透過預先定義的模型API產生自訂的 GraphQL,並設定新的 DynamoDB 資料表 (資料來源) 以支援它。
-
設計API具有空白結構描述且沒有資料來源或解析程式的 GraphQL。
-
使用 DynamoDB 資料表匯入資料並產生結構描述的類型和欄位。
-
使用 AWS AppSync WebSocket 的功能和 Pub/Sub 架構來開發即時 APIs。
-
使用現有的 GraphQL APIs(來源 APIs) 連結至合併的 API。
注意
建議您先檢閱設計結構描述區段,然後再使用更進階的工具。這些指南將說明更簡單的範例,您可以在 中以概念方式建置更複雜的應用程式 AWS AppSync。
AWS AppSync 也支援數個非主控台選項來建立 GraphQL APIs。其中包含:
-
AWS Amplify
AWS SAM
-
AWS CloudFormation
-
的 CDK
下列範例將示範如何使用API預先定義的模型和 DynamoDB 建立 GraphQL 的基本元件。