使用 GraphQL 變動將資料新增至 AWS AppSync 主控台中的 DynamoDB 資料表

將資料新增至資料來源

1. 如果您尚未這麼做，請登入 AWS Management Console 並開啟 AppSync 主控台。

2. 從資料表中選擇您的 API。

3. 在左側的索引標籤中，選擇查詢。

4. 在資料表左側的 Explorer 索引標籤中，您可能會看到查詢編輯器中已定義的數個變動和查詢：

   

   注意

   此變動實際上位於您的結構描述中做為 Mutation類型。它具有 程式碼：

   type Mutation {
   	createTodo(input: CreateTodoInput!): Todo
   	updateTodo(input: UpdateTodoInput!): Todo
   	deleteTodo(input: DeleteTodoInput!): Todo
   }

   如您所見，此處的操作與查詢編輯器中的操作類似。

   AWS AppSync 會自動從我們先前定義的模型產生這些項目。此範例將使用 createTodo 變動將項目新增至我們的 TodoAPITable 資料表。

5. 在createTodo變動下展開操作，以選擇createTodo操作：

   

   啟用上圖等所有欄位的核取方塊。

   注意

   您在此處看到的屬性是變動的不同可修改元素。input 您可以將 視為 的 參數createTodo。具有核取方塊的各種選項是執行 操作後，將在回應中傳回的欄位。

6. 在畫面中央的程式碼編輯器中，您會注意到 操作出現在createTodo變動下方：

   mutation createTodo($createtodoinput: CreateTodoInput!) {
     createTodo(input: $createtodoinput) {
       where
       when
       name
       id
       description
     }
   }

   注意

   為了正確解釋此程式碼片段，我們也必須查看結構描述程式碼。宣告mutation createTodo($createtodoinput: CreateTodoInput!){}是具有其其中一個操作的變動，createTodo。完整變動位於結構描述中：

   type Mutation {
   	createTodo(input: CreateTodoInput!): Todo
   	updateTodo(input: UpdateTodoInput!): Todo
   	deleteTodo(input: DeleteTodoInput!): Todo
   }

   從編輯器返回變動宣告， 參數是名為 $createtodoinput 且必要輸入類型為 的物件CreateTodoInput。請注意， CreateTodoInput（以及變動中的所有輸入） 也會在結構描述中定義。例如，以下是 的樣板程式碼CreateTodoInput：

   input CreateTodoInput {
   	name: String
   	when: String
   	where: String
   	description: String
   }

   它包含我們在模型中定義的欄位，即 name、where、 when和 description。

   返回編輯器程式碼，在 中createTodo(input: $createtodoinput) {}，我們會將輸入宣告為 $createtodoinput，這也用於變動宣告。我們這樣做是因為這允許 GraphQL 根據提供的類型驗證我們的輸入，並確保它們與正確的輸入一起使用。

   編輯器程式碼的最後部分顯示執行 操作後，將在回應中傳回的欄位：

   {
       where
       when
       name
       id
       description
     }

   在此編輯器下方的查詢變數索引標籤中，會有一般createtodoinput物件，其中可能有下列資料：

   {
     "createtodoinput": {
       "name": "Hello, world!",
       "when": "Hello, world!",
       "where": "Hello, world!",
       "description": "Hello, world!"
     }
   }

   注意

   這是我們為先前提到的輸入配置值的位置：

   input CreateTodoInput {
   	name: String
   	when: String
   	where: String
   	description: String
   }

   透過新增要在 DynamoDB 資料表中放置的資訊createtodoinput來變更 。在這種情況下，我們希望建立一些Todo項目作為提醒：

   {
     "createtodoinput": {
       "name": "Shopping List",
       "when": "Friday",
       "where": "Home",
       "description": "I need to buy eggs"
     }
   }

7. 選擇編輯器頂端的執行。在下拉式清單中選擇 createTodo。在編輯器的右側，您應該會看到回應。這可能看起來如下：

   {
     "data": {
       "createTodo": {
         "where": "Home",
         "when": "Friday",
         "name": "Shopping List",
         "id": "abcdefgh-1234-1234-1234-abcdefghijkl",
         "description": "I need to buy eggs"
       }
     }
   }

   如果您導覽至 DynamoDB 服務，您現在會在資料來源中看到包含此資訊的項目：