建立基本查詢 (JavaScript)

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

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

2. 在側邊欄中，選擇結構描述。

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

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

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

針對解析程式執行時間，選擇 APPSYNC_JS以啟用 JavaScript 執行時間。

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

在編輯解析程式頁面上，有一個稱為解析程式程式碼的程式碼編輯器，可讓您實作解析程式處理常式和回應的邏輯 （步驟前後）。如需詳細資訊，請參閱 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. 在側邊欄中，選擇結構描述。

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

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

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

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

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

2. 輸入 Function name。

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

   注意

   createPost 正在新增或 "putting" 資料表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. 完成後，請選擇建立。

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

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