本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 入門：在 AWS AppSync 中建立您的第一個 GraphQL API
<a name="quickstart"></a>

您可以使用 AWS AppSync 主控台來設定和啟動 GraphQL API。GraphQL APIs通常需要三個元件：

1. **GraphQL 結構描述** - 您的 GraphQL 結構描述是 API 的藍圖。它定義了您可以在執行 操作時請求的類型和欄位。若要將資料填入結構描述，您必須將資料來源連線至 GraphQL API。在本快速入門指南中，我們將使用預先定義的模型建立結構描述。

1. **資料來源** - 這些資源包含用於填入 GraphQL API 的資料。這可以是 DynamoDB 資料表、Lambda 函數等。 AWS AppSync 支援多種資料來源，以建置強大且可擴展的 GraphQL APIs。資料來源會連結到結構描述中的欄位。每當請求在 欄位上執行時，來源的資料就會填入 欄位。此機制由解析程式控制。在本快速入門指南中，我們將使用預先定義的模型以及結構描述來建立資料來源。

1. **解析程式** - 解析程式負責將結構描述欄位連結至資料來源。它們從來源擷取資料，然後根據 欄位定義的內容傳回結果。 AWS AppSync 支援 JavaScript 和 VTL，以寫入 GraphQL APIs 的解析程式。在本快速入門指南中，將根據結構描述和資料來源自動產生解析程式。在本節中，我們不會深入探討這一點。

AWS AppSync 支援建立和設定所有 GraphQL 元件。開啟 主控台時，您可以使用下列方法來建立 API：

1. 透過預先定義的模型產生自訂的 GraphQL API，並設定新的 DynamoDB 資料表 （資料來源） 以支援它。

1. 設計具有空白結構描述且沒有資料來源或解析程式的 GraphQL API。

1. 使用 DynamoDB 資料表匯入資料並產生結構描述的類型和欄位。

1. 使用 AWS AppSync 的 WebSocket 功能和 Pub/Sub 架構來開發即時 APIs。

1. 使用現有的 GraphQL APIs （來源 APIs) 連結至合併 API。

**注意**  
建議您先檢閱[設計結構描述區段，](designing-your-schema.md#aws-appsync-designing-your-schema)再使用更進階的工具。這些指南將說明更簡單的範例，您可以用概念方式在 AWS AppSync 中建置更複雜的應用程式。

AWS AppSync 也支援數個非主控台選項來建立 GraphQL APIs。其中包含：

1. AWS Amplify

1. AWS SAM

1. CloudFormation

1. CDK

 下列範例將示範如何使用預先定義的模型和 DynamoDB 建立 GraphQL API 的基本元件。

**Topics**
+ [啟動結構描述](schema-launch-start.md)
+ [導覽 AWS AppSync 主控台](console-tour.md)
+ [使用 GraphQL 變動將資料新增至 DynamoDB 資料表](add-data-with-graphql-mutation.md)
+ [使用 GraphQL 查詢從 DynamoDB 資料表擷取資料](retrieve-data-with-graphql-query.md)
+ [補充區段](next-steps.md)