本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在將資料新增至 DynamoDB 資料表之前,我們應該檢閱 AWS AppSync 主控台體驗的基本功能。頁面左側的 AWS AppSync 主控台索引標籤可讓使用者輕鬆導覽至 AWS AppSync 提供的任何主要元件或組態選項:

結構描述設計工具
選擇結構描述以檢視您剛建立的結構描述。如果您檢閱結構描述的內容,您會注意到它已載入大量協助程式操作,以簡化開發程序。在結構描述編輯器中,如果您捲動程式碼,最終將到達您在上一節中定義的模型:
type Todo {
id: ID!
name: String
when: String
where: String
description: String
}
您的模型會成為整個結構描述中使用的基本類型。我們將使用從此類型自動產生的變動,開始將資料新增至資料來源。
以下是關於結構描述編輯器的一些其他秘訣和事實:
-
程式碼編輯器具有固定和錯誤檢查功能,您可以在撰寫自己的應用程式時使用。
-
主控台右側顯示則會顯示已建立的 GraphQL 類型,以及不同最上層類型 (例如查詢) 的解析程式。
-
將新類型新增至結構描述時 (例如
type User {...}
),您可以擁有 AWS AppSync 佈建 DynamoDB 資源。這些包括最符合您 GraphQL 資料存取模式的適當主索引鍵、排序索引鍵和索引設計。如果您選擇最上方的 Create Resources (建立資源),並從選單選取其中一個使用者定義的類型,您便可以在結構描述設計中選擇不同的欄位選項。我們將在設計結構描述區段中說明這一點。
解析程式組態
在結構描述設計工具中,解析程式區段包含結構描述中的所有類型和欄位。如果您捲動欄位清單,您會注意到您可以選擇連接,將解析程式連接到特定欄位。這會開啟程式碼編輯器,您可以在其中撰寫解析程式程式碼。 AWS AppSync 支援 VTL 和 JavaScript 執行期,您可以透過選擇動作,然後選擇更新執行期來變更頁面頂端。在頁面底部,您也可以建立將依序執行數個操作的函數。不過,解析程式是進階主題,我們不會在本節涵蓋該主題。
資料來源
選擇資料來源以檢視您的 DynamoDB 資料表。透過選擇 Resource
選項 (如果可用),您可以檢視資料來源的組態。在我們的範例中,這會導致 DynamoDB 主控台。您可以從那裡編輯資料。您也可以選擇資料來源,然後選擇編輯,直接編輯部分資料。如果您需要刪除資料來源,您可以選擇資料來源,然後選取刪除。最後,您可以選擇建立資料來源,然後設定名稱和類型,以建立新的資料來源。請注意,此選項用於將 AWS AppSync 服務連結至現有資源。您仍然需要使用相關服務在帳戶中建立資源, AWS AppSync 才會辨識該資源。
查詢
選擇查詢以檢視您的查詢和變動。當我們使用模型建立 GraphQL API 時, AWS AppSync 會自動產生一些協助程式變動和查詢,以供測試之用。在查詢編輯器中,左側包含 Explorer。這是顯示所有變動和查詢的清單。您可以按一下操作和欄位的名稱值,輕鬆啟用您想要在這裡使用的操作和欄位。這會導致程式碼自動出現在編輯器的中心部分。在這裡,您可以透過修改值來編輯變動和查詢。在編輯器底部,您有查詢變數編輯器,可讓您輸入操作輸入變數的欄位值。在編輯器頂端選擇執行將出現下拉式清單,以選取要執行的查詢/變動。此執行的輸出會出現在頁面右側。回到頂端的 Explorer 區段,您可以選擇操作 (查詢、變動、訂閱),然後選擇 + 符號來新增該特定操作的新執行個體。在頁面頂端,將會有另一個下拉式清單,其中包含查詢執行的授權模式。不過,我們不會涵蓋本節中的該功能 (如需詳細資訊,請參閱安全性。)。
設定
選擇設定以檢視 GraphQL API 的一些組態選項。在這裡,您可以啟用一些選項,例如記錄、追蹤和 Web 應用程式防火牆功能。您也可以新增新的授權模式,以保護資料免於意外洩漏給大眾。不過,這些選項更為進階,不會在本節中涵蓋。
注意
預設授權模式 API_KEY
使用 API 金鑰來測試應用程式。這是提供給所有新建立 GraphQL APIs 的基本授權。建議您使用不同的生產方法。為了本節中的範例,我們只會使用 API 金鑰。如需支援的授權方法的詳細資訊,請參閱 安全性。