建立基本查詢 （JavaScript）

登入 AWS Management Console 並開啟AppSync主控台 。

1. 在APIs儀表板 中，選擇您的 GraphQL API。

2. 在 Sidebar 中，選擇結構描述 。

輸入您的結構描述和資料來源的詳細資訊。如需詳細資訊，請參閱設計您的結構描述和連接資料來源章節。

在結構描述編輯器旁邊，有一個名為解析程式 的視窗。此方塊包含結構描述視窗中定義的類型和欄位清單。您可以將解析器連接至 欄位。您很可能將解析器連接至您的欄位操作。在本節中，我們將探討簡單的查詢組態。在查詢類型下，選擇查詢欄位旁的連接。

在連接解析程式頁面的解析程式類型 下，您可以選擇管道或單位解析程式。如需這些類型的詳細資訊，請參閱解析程式 。本指南將使用 pipeline resolvers。

針對 Resolver 執行期 ，選擇 APPSYNC_JS 以啟用 JavaScript 執行期。

您可以為此 啟用快取API。建議您立即關閉此功能。選擇 Create (建立)。

在編輯解析程式頁面上，有一個名為解析程式程式碼的程式碼編輯器，可讓您實作解析程式處理程式和回應的邏輯 （步驟前後）。如需詳細資訊，請參閱JavaScript解析程式概觀 。

import {util} from '@aws-appsync/utils';

export function request(ctx) {
    return {};
}

export function response(ctx) {
    return ctx.prev.result;
}

本節下方有一個名為 Functions 的資料表。函數可讓您實作可在多個解析器間重複使用的程式碼。您可以將原始程式碼儲存為可在需要時新增至解析器的函數，而不是不斷重寫或複製程式碼。

函數構成管道操作清單的大量。在解析器中使用多個函數時，您可以設定函數的順序，並將按該順序執行。它們會在請求函數執行之後，以及回應函數開始之前執行。

若要新增函數，請在函數 下，選擇新增函數 ，然後選擇建立新函數 。或者，您可能會看到建立函數按鈕來選擇。

1. 選擇資料來源。這將是解析程式在其上執行動作的資料來源。

   注意

   在我們的範例中，我們正在連接 的解析器getPost，該解析器會藉由 擷取Post物件id。假設我們已經為此結構描述設定 DynamoDB 資料表。其分割區金鑰設定為 id，且為空白。

2. 輸入 Function name。

3. 在函數程式碼 下，您需要實作函數的行為。這可能令人困惑，但每個函數都會有自己的本機請求和回應處理常式。執行請求，然後進行資料來源調用來處理請求，然後由回應處理常式處理資料來源回應。結果會儲存在內容物件中。之後，清單中的下一個函數會執行，如果是最後一個函數，則會傳遞給步驟後回應處理常式。

   注意

   在我們的範例中，我們會將解析器連接至 getPost，從資料來源取得Post物件清單。我們的請求函數會從我們的資料表請求資料，資料表會將回應傳遞至內容 （ctx），然後回應會在內容中傳回結果。 AWS AppSync的強度在於其與其他 AWS 服務的互連性。由於我們使用 DynamoDB ，因此我們有一套操作來簡化這類操作。我們也有一些其他資料來源類型的樣板範例。

   我們的程式碼看起來像這樣：

   import { util } from '@aws-appsync/utils';
   
   /**
    * Performs a scan on the dynamodb data source
    */
   export function request(ctx) {
     return { operation: 'Scan' };
   }
   
   /**
    * return a list of scanned post items
    */
   export function response(ctx) {
     return ctx.result.items;
   }

   在此步驟中，我們新增了兩個函數：

   • request：請求處理常式會根據資料來源執行擷取操作。引數包含內容物件 （ctx），或執行特定操作的所有解析器可用的部分資料。例如，它可能包含授權資料、正在解析的欄位名稱等。傳回陳述式會執行 Scan操作 （如需範例，請參閱此處）。因為我們使用的是 DynamoDB ，因此我們可以使用該服務的一些操作。掃描會執行資料表中所有項目的基本擷取。此操作的結果會以result容器的形式存放在內容物件中，然後再傳遞給回應處理常式。在管道中的回應之前request執行 。

   • response：傳回 輸出的回應處理常式request。引數是更新的內容物件，而傳回陳述式是 ctx.prev.result。在本指南的這個時候，您可能不熟悉此值。 ctx是指內容物件。 prev是指管道中的上一個操作，也就是我們的 request。result 包含解析器在管道中移動時的結果 （s）。如果您將所有操作整合在一起， ctx.prev.result 會傳回上次執行的操作結果，也就是請求處理常式。

4. 完成後選擇建立。

返回解析器畫面，在函數 下，選擇新增函數下拉式清單，並將函數新增至函數清單。

選擇儲存以更新解析程式。

登入 AWS Management Console 並開啟AppSync主控台 。

1. 在APIs儀表板 中，選擇您的 GraphQL API。

2. 在 Sidebar 中，選擇結構描述 。

在解析程式區段和突變類型下，選擇欄位旁的連接。

在連接解析程式頁面上的解析程式類型 下，選擇 pipeline resolvers。提醒您，您可以在這裡找到有關解析程式的詳細資訊。針對 Resolver 執行期 ，選擇 APPSYNC_JS 以啟用 JavaScript 執行期。

您可以為此 啟用快取API。建議您立即關閉此功能。選擇 Create (建立)。

選擇新增函數 ，然後選擇建立新函數 。或者，您可能會看到建立函數按鈕來選擇。

1. 選擇您的資料來源。這應該是您要使用突變操作資料的來源。

2. 輸入 Function name。

3. 在函數程式碼 下，您需要實作函數的行為。這是一個突變，因此請求最好會在調用資料來源上執行一些狀態變更操作。結果將由回應函數處理。

   注意

   createPost 正在新增或「引號」資料表Post中的新 ，並將我們的參數作為資料。我們可以新增如下內容：

   import { util } from '@aws-appsync/utils';
   
   /**
    * Sends a request to `put` an item in the DynamoDB data source
    */
   export function request(ctx) {
     return {
       operation: 'PutItem',
       key: util.dynamodb.toMapValues({id: util.autoId()}),
       attributeValues: util.dynamodb.toMapValues(ctx.args.input),
     };
   }
   
   /**
    * returns the result of the `put` operation
    */
   export function response(ctx) {
     return ctx.result;
   }

   在此步驟中，我們也新增 request和 response函數：

   • request：請求處理常式接受內容作為引數。請求處理常式傳回陳述式會執行 PutItem命令，這是內建的 DynamoDB 操作 （如需範例，請參閱此處或此處）。此PutItem命令會取得分割區key值 （由 自動產生util.autoid()） 並從內容引數輸入 attributes （這些值是我們在請求中傳遞的值），藉此將Post物件新增至 DynamoDB 資料表。key 是 id和 attributes是 date和 title 欄位引數。它們都是透過util.dynamodb.toMapValues協助程式預先格式化，以使用 DynamoDB 資料表。

   • response：回應接受更新的內容，並傳回請求處理常式的結果。

4. 完成後選擇建立。

返回解析器畫面，在函數 下，選擇新增函數下拉式清單，並將函數新增至函數清單。

選擇儲存以更新解析器。