建置 API 操作
若要使用 NoSQL Workbench 來建立 DynamoDB CRUD API,請選取位於 NoSQL Workbench 左側的操作建置器。
選取開啟,然後選擇連線。
您可以在操作建置器中執行以下操作。
刪除資料表
若要執行 Delete Table 操作,請執行下列動作。
-
從資料表區段尋找要刪除的資料表。
-
從水平省略符號功能表中,選取刪除資料表。
-
輸入資料表名稱,確認您想要刪除資料表。
-
選取刪除。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的刪除資料表。
刪除 GSI
若要執行 Delete GSI 操作,請執行下列動作。
-
從資料表區段尋找要刪除之資料表的 GSI。
-
從水平省略號功能表中選取刪除 GSI。
-
輸入 GSI 名稱,確認您想要刪除該 GSI。
-
選取刪除。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的刪除資料表。
建立資料表
若要執行 Create Table 操作,請執行下列動作。
-
選擇資料表區段旁的 + 圖示。
-
輸入所需的資料表名稱。
-
建立分割區索引鍵。
-
選用:建立排序索引鍵。
-
自定義容量設定並取消勾選使用預設容量設定核取方塊。
-
您現在可以選取 Provisioned (已佈建的) 或 On-demand capacity (隨需容量)。
若選取佈建,您可以設定最小和最大讀寫容量單位。您還可以啟用或停用自動擴展。
-
若資料表目前設定為隨需,您將無法指定佈建輸送量。
-
如果您從隨需切換到佈建輸送量,則自動擴展將自動套用到所有 GSI,其中包含:最小值:1,最大值:10;目標:70%。
-
-
選取略過 GSI 並建立,以建立沒有 GSI 的資料表。或者,您可以選擇下一步,使用此新資料表建立 GSI。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的建立資料表。
建立 GSI
若要執行 Create GSI 操作,請執行下列動作。
-
尋找您要新增 GSI 的資料表。
-
從水平省略號功能表中,選取建立 GSI。
-
在索引名稱下,命名您的 GSI。
-
建立分割區索引鍵。
-
選用:建立排序索引鍵。
-
從下拉式清單中選擇投影類型選項。
-
選擇建立 GSI。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的建立資料表。
更新資料表
若要使用 Update Table 操作更新資料表的容量設定,請執行下列動作。
-
尋找待更新容量設定的資料表。
-
從水平省略號功能表中,選取更新容量設定。
-
選取佈建或隨需容量。
若選取佈建,您可以設定最小和最大讀寫容量單位。您還可以啟用或停用自動擴展。
-
選取 Update (更新)。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的更新資料表。
更新 GSI
若要使用 Update Table 操作更新 GSI 的容量設定,請執行下列動作。
注意
根據預設,全域次要索引會繼承基礎資料表的容量設定。只有在基礎資料表設定為佈建容量模式時,全域次要索引才具有不同的容量模式。當您對佈建模式資料表建立全域次要索引時,必須為該索引的預期工作負載指定讀取與寫入容量單位。如需更多詳細資訊,請參閱 全域次要索引的佈建輸送量考量。
-
尋找待更新容量設定的 GSI。
-
從水平省略號功能表中,選取更新容量設定。
-
您現在可以選取 Provisioned (已佈建的) 或 On-demand capacity (隨需容量)。
若選取佈建,您可以設定最小和最大讀寫容量單位。您還可以啟用或停用自動擴展。
-
選取 Update (更新)。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的更新資料表。
放置項目
您可以使用 Put Item 操作以建立項目。若要執行或產生 Put Item 操作的程式碼,請執行以下操作。
-
尋找您要在其中建立項目的資料表。
-
從動作下拉式清單中,選取建立項目。
-
輸入分割區索引鍵值。
-
輸入排序索引鍵值 (如有)。
-
若想要新增非索引鍵屬性,請執行以下作業:
-
選取新增其他屬性。
-
指定 Attribute name (屬性名稱)、Type (類型) 和 Value (值)。
-
-
如果必須滿足某項條件表達式,
Put Item操作才能成功,請執行以下作業:-
選擇 Condition (條件)。
-
指定屬性名稱、比較運算子、屬性類型和屬性值。
-
如需其他條件,請再次選擇 Condition (條件)。
如需詳細資訊,請參閱 DynamoDB 條件表達式 CLI 範例。
-
-
若要產生程式碼,請選擇 Generate code (產生程式碼)。
從顯示的標籤中選取所需的語言。您現在可以複製此程式碼,並使用在您的應用程式中。
-
若希望立即執行此操作,請選擇 Run (執行)。
-
若想儲存此操作以供日後使用,請選擇 Save operation (儲存操作),然後輸入操作的名稱,再選擇 Save (儲存)。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的 PutItem。
更新項目
若要執行或產生 Update Item 操作的程式碼,請執行以下操作:
-
尋找您要在其中更新項目的資料表。
-
選取項目。
-
輸入所選表達式的屬性名稱和屬性值。
-
若要新增更多表達式,請在更新表達式下拉式清單中選擇另一項表達式,然後選取 + 圖示。
-
如果必須滿足某項條件表達式,
Update Item操作才能成功,請執行以下作業:-
選擇 Condition (條件)。
-
指定屬性名稱、比較運算子、屬性類型和屬性值。
-
如需其他條件,請再次選擇 Condition (條件)。
如需詳細資訊,請參閱 DynamoDB 條件表達式 CLI 範例。
-
-
若要產生程式碼,請選擇 Generate code (產生程式碼)。
選擇您想要的語言標籤。您現在可以複製此程式碼,並使用在您的應用程式中。
-
若希望立即執行此操作,請選擇 Run (執行)。
-
若想儲存此操作以供日後使用,請選擇 Save operation (儲存操作),然後輸入操作的名稱,再選擇 Save (儲存)。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的 UpdateItem。
刪除項目
若要執行 Delete Item 操作,請執行下列動作。
-
尋找您想要在其中刪除項目的資料表。
-
選取項目。
-
從動作下拉式清單中,選取刪除項目。
-
選取刪除,確認您想要刪除項目。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的 DeleteItem。
複製項目
您可以建立具有相同屬性的新項目以複製項目。執行下列步驟以複製項目。
-
尋找您要在其中複製項目的資料表。
-
選取項目。
-
從動作下拉式清單中,選取複製項目。
-
指定新的分割區索引鍵。
-
指定新的排序索引鍵 (如有必要)。
-
選取執行。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的 DeleteItem。
Query
若要執行或產生 Query 操作的程式碼,請執行以下操作。
-
從 NoSQL Workbench UI 頂端選取查詢。
-
指定分割區索引鍵值。
-
如果
Query操作需要排序索引鍵:-
選取 Sort key (排序索引鍵)。
-
指定比較運算子和屬性值。
-
-
選取查詢以執行此查詢操作。如果需要更多選項,請勾選更多選項核取方塊並繼續執行下列步驟。
-
如果不是所有屬性都應傳回並附帶操作結果,請選取 Projection expression (投射表達式)。
-
選擇 + 圖示。
-
輸入附帶查詢結果傳回的屬性。
-
如需更多屬性,請選擇 +。
-
如果必須滿足某項條件表達式,
Query操作才能成功,請執行以下作業:-
選擇 Condition (條件)。
-
指定屬性名稱、比較運算子、屬性類型和屬性值。
-
如需其他條件,請再次選擇 Condition (條件)。
如需詳細資訊,請參閱 DynamoDB 條件表達式 CLI 範例。
-
-
若要產生程式碼,請選擇 Generate code (產生程式碼)。
選擇您想要的語言標籤。您現在可以複製此程式碼,並使用在您的應用程式中。
-
若希望立即執行此操作,請選擇 Run (執行)。
-
若想儲存此操作以供日後使用,請選擇 Save operation (儲存操作),然後輸入操作的名稱,再選擇 Save (儲存)。
如需此操作的詳細資訊,請參閱《Amazon DynamoDB API 參考》中的 Query。
Scan
若要執行或產生 Scan 操作的程式碼,請執行以下操作。
-
從 NoSQL Workbench UI 頂端選取掃描。
-
選取掃描按鈕以執行此基本掃描操作。如果需要更多選項,請勾選更多選項核取方塊並繼續執行下列步驟。
-
指定屬性名稱以篩選掃描結果。
-
如果不是所有屬性都應傳回並附帶操作結果,請選取 Projection expression (投射表達式)。
-
如果必須滿足某項條件表達式,scan 操作才能成功,請執行以下作業:
-
選擇 Condition (條件)。
-
指定屬性名稱、比較運算子、屬性類型和屬性值。
-
如需其他條件,請再次選擇 Condition (條件)。
如需詳細資訊,請參閱 DynamoDB 條件表達式 CLI 範例。
-
-
若要產生程式碼,請選擇 Generate code (產生程式碼)。
選擇您想要的語言標籤。您現在可以複製此程式碼,並使用在您的應用程式中。
-
若希望立即執行此操作,請選擇 Run (執行)。
-
若想儲存此操作以供日後使用,請選擇 Save operation (儲存操作),然後輸入操作的名稱,再選擇 Save (儲存)。
TransactGetItems
若要執行或產生 TransactGetItems 操作的程式碼,請執行以下操作。
-
從 NoSQL Workbench UI 頂端的更多操作下拉式清單中,選擇 TransactGetItems。
-
選擇 TransactGetItem 附近的 + 圖示。
-
指定分割區索引鍵。
-
指定排序索引鍵 (如有必要)。
-
選取執行以執行操作、儲存操作以儲存,或選取產生程式碼以產生操作的程式碼。
如需交易的詳細資訊,請參閱 Amazon DynamoDB Transactions。
TransactWriteItems
若要執行或產生 TransactWriteItems 操作的程式碼,請執行以下操作。
-
從 NoSQL Workbench UI 頂端的更多操作下拉式清單中,選擇 TransactWriteItems。
-
從動作下拉式清單中,選擇操作。
-
選擇 TransactWriteItem 附近的 + 圖示。
-
在動作下拉式清單中,選擇您想執行的操作。
若要變更動作順序,請在左側清單中選擇動作,然後選擇上下箭號在清單中上下移動該動作。
若要刪除動作,請在清單中選擇動作,然後選擇 Delete (刪除) (回收桶) 圖示。
-
選取執行以執行操作、儲存操作以儲存,或選取產生程式碼以產生操作的程式碼。
如需交易的詳細資訊,請參閱 Amazon DynamoDB Transactions。