建置API操作 - Amazon DynamoDB

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

建置API操作

若要使用 NoSQL Workbench CRUD 建置 DynamoDBAPIs,請從 NoSQL Workbench 使用者介面左側選取 Operation Builder

然後選取開啟,然後選擇連線。

您可以在操作建置器中執行以下操作。

刪除資料表

若要執行Delete Table操作,請執行下列動作。

  1. 從資料表區段尋找要刪除的資料表

  2. 從水平省略號功能表中選取刪除資料表

  3. 輸入資料表名稱 ,確認您想要刪除資料表

  4. 選取刪除

如需此操作的詳細資訊,請參閱 Amazon DynamoDB API參考 中的刪除資料表

刪除 GSI

若要執行Delete GSI操作,請執行下列動作。

  1. 從GSI資料表區段尋找要刪除的資料表的 。

  2. 從水平省略號功能表中選取刪除GSI

  3. 輸入名稱 GSI 以確認您想要刪除 。 GSI

  4. 選取刪除

如需此操作的詳細資訊,請參閱 Amazon DynamoDB API參考 中的刪除資料表

建立資料表

若要執行Create Table操作,請執行下列動作。

  1. 選擇資料表區段旁的 圖示。

  2. 輸入所需的資料表名稱。

  3. 建立分割區索引鍵。

  4. 選用:建立排序金鑰。

  5. 若要自訂容量設定,並取消核取使用預設容量設定 旁的方塊。

    • 您現在可以選取 Provisioned (已佈建的) 或 On-demand capacity (隨需容量)。

      若選取 Provisioned (已佈建的),您可以設定最小和最大讀寫容量單位。您還可以啟用或停用自動調整規模。

    • 如果資料表目前設定為隨需,您將無法指定佈建的輸送量。

    • 如果您從隨需切換到佈建輸送量,則 Autoscaling 會自動套用到所有 GSIs,其中:min: 1, max: 10; target: 70%。

  6. 選取略過GSIs並建立,以建立沒有 的此表格GSI。或者,您可以選擇下一步,使用此GSI新資料表建立 。

如需此操作的詳細資訊,請參閱 Amazon DynamoDB API參考 中的建立資料表

建立 GSI

若要執行Create GSI操作,請執行下列動作。

  1. 尋找您要將 GSI新增至其中的資料表。

  2. 從水平省略號功能表中,選取建立 GSI

  3. 在索引名稱 GSI下命名您的 。

  4. 建立分割區索引鍵。

  5. 選用:建立排序金鑰。

  6. 從下拉式清單中選擇投影類型選項。

  7. 選取建立 GSI

如需此操作的詳細資訊,請參閱 Amazon DynamoDB API參考 中的建立資料表

更新資料表

若要使用 Update Table操作更新資料表的容量設定,請執行下列動作。

  1. 尋找您要更新容量設定的資料表。

  2. 從水平省略號功能表中,選取更新容量設定

  3. 選取佈建隨需容量。

    選取佈建後,您可以設定最小和最大讀取和寫入容量單位。您還可以啟用或停用自動調整規模。

  4. 選取 Update (更新)。

如需此操作的詳細資訊,請參閱 Amazon DynamoDB API參考 中的更新資料表

更新 GSI

若要GSI使用 Update Table操作更新 的容量設定,請執行下列動作。

注意

根據預設,全域次要索引會繼承基礎資料表的容量設定。只有當基礎資料表處於佈建容量模式時,全域次要索引才能具有不同的容量模式。當您對佈建模式資料表建立全域次要索引時,必須為該索引的預期工作負載指定讀取與寫入容量單位。如需詳細資訊,請參閱全域次要索引的佈建輸送量考量

  1. 尋找GSI您要更新容量設定的 。

  2. 從水平省略號功能表中,選取更新容量設定

  3. 您現在可以選取 Provisioned (已佈建的) 或 On-demand capacity (隨需容量)。

    選取佈建後,您可以設定最小和最大讀取和寫入容量單位。您還可以啟用或停用自動調整規模。

  4. 選取 Update (更新)。

如需此操作的詳細資訊,請參閱 Amazon DynamoDB API參考 中的更新資料表

放置項目

您可以使用 Put Item操作建立項目。若要執行或產生 Put Item 操作的程式碼,請執行以下操作。

  1. 尋找您要在其中建立項目的資料表。

  2. 動作下拉式清單中,選取建立項目

  3. 輸入分割區索引鍵值。

  4. 輸入排序索引鍵值 (如有)。

  5. 若想要新增非索引鍵屬性,請執行以下作業:

    1. 選取 + 新增其他屬性

    2. 指定 Attribute name (屬性名稱)、Type (類型) 和 Value (值)。

  6. 如果必須滿足某項條件表達式,Put Item 操作才能成功,請執行以下作業:

    1. 選擇 Condition (條件)。

    2. 指定屬性名稱、比較運算子、屬性類型和屬性值。

    3. 如需其他條件,請再次選擇 Condition (條件)。

    如需詳細資訊,請參閱 DynamoDB 條件表達式CLI範例

  7. 若要產生程式碼,請選擇 Generate code (產生程式碼)。

    從顯示的標籤中選取所需的語言。您現在可以複製此程式碼,並使用在您的應用程式中。

  8. 若希望立即執行此操作,請選擇 Run (執行)。

  9. 若想儲存此操作以供日後使用,請選擇 Save operation (儲存操作),然後輸入操作的名稱,再選擇 Save (儲存)。

如需此操作的詳細資訊,請參閱 Amazon DynamoDB 參考 PutItem 中的 。 DynamoDB API

更新項目

若要執行或產生 Update Item 操作的程式碼,請執行以下操作:

  1. 尋找您要更新項目的資料表。

  2. 選取項目。

  3. 輸入所選表達式的屬性名稱和屬性值。

  4. 如果您想要新增更多表達式,請在更新表達式下拉式清單中選擇另一個表達式,然後選擇 圖示。

  5. 如果必須滿足某項條件表達式,Update Item 操作才能成功,請執行以下作業:

    1. 選擇 Condition (條件)。

    2. 指定屬性名稱、比較運算子、屬性類型和屬性值。

    3. 如需其他條件,請再次選擇 Condition (條件)。

    如需詳細資訊,請參閱 DynamoDB 條件表達式CLI範例

  6. 若要產生程式碼,請選擇 Generate code (產生程式碼)。

    選擇您想要的語言標籤。您現在可以複製此程式碼,並使用在您的應用程式中。

  7. 若希望立即執行此操作,請選擇 Run (執行)。

  8. 若想儲存此操作以供日後使用,請選擇 Save operation (儲存操作),然後輸入操作的名稱,再選擇 Save (儲存)。

如需此操作的詳細資訊,請參閱 Amazon DynamoDB 參考 UpdateItem 中的 。 DynamoDB API

刪除項目

若要執行Delete Item操作,請執行下列動作。

  1. 尋找您想要在其中刪除項目的資料表。

  2. 選取項目。

  3. 動作下拉式清單中,選取刪除項目

  4. 選取刪除 ,確認您想要刪除項目。

如需此操作的詳細資訊,請參閱 Amazon DynamoDB 參考 DeleteItem 中的 。 DynamoDB API

重複項目

您可以建立具有相同屬性的新項目來複製項目。若要複製項目,請執行下列動作。

  1. 尋找您要在其中複製項目的資料表。

  2. 選取項目。

  3. 動作下拉式清單中,選取複製項目

  4. 指定新的分割區金鑰。

  5. 指定新的排序金鑰 (如有必要)。

  6. 選取執行

如需此操作的詳細資訊,請參閱 Amazon DynamoDB 參考 DeleteItem 中的 。 DynamoDB API

Query

若要執行或產生 Query 操作的程式碼,請執行以下操作。

  1. 從無SQL工作台 UI 頂端選取查詢

  2. 指定分割區索引鍵值。

  3. 如果 Query 操作需要排序索引鍵:

    1. 選取 Sort key (排序索引鍵)。

    2. 指定比較運算子和屬性值。

  4. 選取查詢以執行此查詢操作。如果需要更多選項,請勾選更多選項核取方塊,並繼續執行下列步驟。

  5. 如果不是所有屬性都應傳回並附帶操作結果,請選取 Projection expression (投射表達式)。

  6. 選擇 + 圖示。

  7. 輸入附帶查詢結果傳回的屬性。

  8. 如需更多屬性,請選擇 +

  9. 如果必須滿足某項條件表達式,Query 操作才能成功,請執行以下作業:

    1. 選擇 Condition (條件)。

    2. 指定屬性名稱、比較運算子、屬性類型和屬性值。

    3. 如需其他條件,請再次選擇 Condition (條件)。

    如需詳細資訊,請參閱 DynamoDB 條件表達式CLI範例

  10. 若要產生程式碼,請選擇 Generate code (產生程式碼)。

    選擇您想要的語言標籤。您現在可以複製此程式碼,並使用在您的應用程式中。

  11. 若希望立即執行此操作,請選擇 Run (執行)。

  12. 若想儲存此操作以供日後使用,請選擇 Save operation (儲存操作),然後輸入操作的名稱,再選擇 Save (儲存)。

如需此操作的詳細資訊,請參閱 Amazon DynamoDB API參考 中的查詢

Scan

若要執行或產生 Scan 操作的程式碼,請執行以下操作。

  1. 從無SQL工作台 UI 頂端選取掃描

  2. 選取掃描按鈕來執行此基本掃描操作。如果需要更多選項,請勾選更多選項核取方塊,並繼續執行下列步驟。

  3. 指定屬性名稱以篩選掃描結果。

  4. 如果不是所有屬性都應傳回並附帶操作結果,請選取 Projection expression (投射表達式)。

  5. 如果必須滿足某項條件表達式,scan 操作才能成功,請執行以下作業:

    1. 選擇 Condition (條件)。

    2. 指定屬性名稱、比較運算子、屬性類型和屬性值。

    3. 如需其他條件,請再次選擇 Condition (條件)。

    如需詳細資訊,請參閱 DynamoDB 條件表達式CLI範例

  6. 若要產生程式碼,請選擇 Generate code (產生程式碼)。

    選擇您想要的語言標籤。您現在可以複製此程式碼,並使用在您的應用程式中。

  7. 若希望立即執行此操作,請選擇 Run (執行)。

  8. 若想儲存此操作以供日後使用,請選擇 Save operation (儲存操作),然後輸入操作的名稱,再選擇 Save (儲存)。

TransactGetItems

若要執行或產生 TransactGetItems 操作的程式碼,請執行以下操作。

  1. 從無SQL工作台使用者介面頂端的更多操作下拉式清單中,選擇 TransactGetItems

  2. 選擇 附近的 圖示TransactGetItem

  3. 指定分割區金鑰。

  4. 指定排序金鑰 (如有必要)。

  5. 選取執行以執行操作、儲存操作以儲存操作,或選取產生程式碼以產生程式碼。

如需交易的詳細資訊,請參閱 Amazon DynamoDB Transactions

TransactWriteItems

若要執行或產生 TransactWriteItems 操作的程式碼,請執行以下操作。

  1. 從無SQL工作台 UI 頂端的更多操作下拉式清單中,選擇 TransactWriteItems

  2. 動作下拉式清單中選擇操作。

  3. 選擇 附近的 圖示TransactWriteItem

  4. 動作下拉式清單中,選擇您要執行的操作。

    • 如需 DeleteItem,請遵循 刪除項目 操作的說明。

    • 如需 PutItem,請遵循 放置項目 操作的說明。

    • 如需 UpdateItem,請遵循 更新項目 操作的說明。

    若要變更動作順序,請在左側清單中選擇動作,然後選擇上下箭號在清單中上下移動該動作。

    若要刪除動作,請在清單中選擇動作,然後選擇 Delete (刪除) (回收桶) 圖示。

  5. 選取執行以執行操作、儲存操作以儲存操作,或選取產生程式碼以產生程式碼。

如需交易的詳細資訊,請參閱 Amazon DynamoDB Transactions