

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

# 導覽 AWS AppSync 主控台
<a name="console-tour"></a>

在將資料新增至 DynamoDB 資料表之前，我們應該檢閱 AWS AppSync 主控台體驗的基本功能。頁面左側的 AWS AppSync 主控台標籤可讓使用者輕鬆導覽至 AWS AppSync 提供的任何主要元件或組態選項：

![\[AWS AppSync console navigation menu showing APIs, Todo API options, and Documentation link.\]](http://docs.aws.amazon.com/zh_tw/appsync/latest/devguide/images/explorer-example-5.jpg)


## 結構描述設計工具
<a name="schema-designer"></a>

選擇**結構描述**以檢視您剛建立的結構描述。如果您檢閱結構描述的內容，您會注意到它已載入大量協助程式操作，以簡化開發程序。在**結構描述**編輯器中，如果您捲動程式碼，最終將到達您在上一節中定義的模型：

```
type Todo {
	id: ID!
	name: String
	when: String
	where: String
	description: String
}
```

您的模型會成為在整個結構描述中使用的基本類型。我們將使用從此類型自動產生的變動，開始將資料新增至資料來源。

以下是有關**結構描述**編輯器的一些其他提示和事實：

1. 程式碼編輯器具有固定和錯誤檢查功能，您可以在撰寫自己的應用程式時使用。

1. 主控台右側顯示則會顯示已建立的 GraphQL 類型，以及不同最上層類型 (例如查詢) 的解析程式。

1. 將新類型新增至結構描述時 （例如 `type User {...}`)，您可以擁有 AWS AppSync 佈建 DynamoDB 資源。這些包括最符合您 GraphQL 資料存取模式的適當主索引鍵、排序索引鍵和索引設計。如果您選擇最上方的 **Create Resources (建立資源)**，並從選單選取其中一個使用者定義的類型，您便可以在結構描述設計中選擇不同的欄位選項。我們將在[設計結構描述](designing-your-schema.md#aws-appsync-designing-your-schema)區段中說明這一點。

### 解析程式組態
<a name="resolver-menu"></a>

在結構描述設計工具中，**解析程式**區段包含結構描述中的所有類型和欄位。如果您捲動欄位清單，您會注意到可以透過選擇連接將解析程式連接到特定欄位****。這將開啟程式碼編輯器，您可以在其中撰寫解析程式程式碼。 AWS AppSync 支援 VTL 和 JavaScript 執行期，您可以在頁面頂端選擇**動作**，然後選擇**更新執行期**來變更。在頁面底部，您也可以建立將依序執行數個操作的函數。不過，解析程式是進階主題，我們不會在本節中涵蓋該主題。

## 資料來源
<a name="data-sources-designer"></a>

選擇**資料來源**以檢視您的 DynamoDB 資料表。透過選擇 `Resource`選項 （如果可用），您可以檢視資料來源的組態。在我們的範例中，這會導致 DynamoDB 主控台。您可以從那裡編輯資料。您也可以選擇資料來源，然後選擇編輯，直接**編輯**部分資料。如果您需要刪除資料來源，您可以選擇資料來源，然後選取**刪除**。最後，您可以選擇建立資料來源，然後設定名稱和類型，以建立新的**資料來源**。請注意，此選項用於將 AWS AppSync 服務連結至現有資源。您仍然需要使用相關服務在帳戶中建立資源， AWS AppSync 才會辨識該資源。

## 查詢
<a name="queries-editor"></a>

選擇**查詢**以檢視您的查詢和變動。當我們使用模型建立 GraphQL API 時， AWS AppSync 會自動產生一些協助程式變動和查詢，以供測試之用。在查詢編輯器中，左側包含 **Explorer**。這是顯示所有變動和查詢的清單。您可以按一下操作和欄位的名稱值，輕鬆啟用您想要在這裡使用的操作和欄位。這會導致程式碼自動出現在編輯器的中央部分。在這裡，您可以透過修改值來編輯您的變動和查詢。在編輯器底部，您有**查詢變數**編輯器，可讓您輸入操作輸入變數的欄位值。在編輯器頂端選擇**執行**將出現下拉式清單，以選取要執行的查詢/變動。此執行的輸出會出現在頁面右側。回到頂端的 **Explorer** 區段，您可以選擇 操作 （查詢、變動、訂閱），然後選擇 **\$1** 符號來新增該特定操作的新執行個體。在頁面頂端，將會有另一個下拉式清單，其中包含查詢執行的授權模式。不過，我們不會涵蓋本節中的該功能 （如需詳細資訊，請參閱[安全性](security-authz.md#aws-appsync-security)。)。

## 設定
<a name="console-settings"></a>

選擇**設定**以檢視 GraphQL API 的一些組態選項。在這裡，您可以啟用一些選項，例如記錄、追蹤和 Web 應用程式防火牆功能。您也可以新增新的授權模式，以保護資料免受不必要的公開洩漏。不過，這些選項更為進階，不會在本節中涵蓋。

**注意**  
預設授權模式 `API_KEY`使用 API 金鑰來測試應用程式。這是授予所有新建立的 GraphQL APIs 的基本授權。建議您使用不同的生產方法。為了本節中的範例，我們只會使用 API 金鑰。如需支援的授權方法的詳細資訊，請參閱[安全性](security-authz.md#aws-appsync-security)。