實作

• 更新項目

  更新應用程式程式碼中的項目時，需著重四個元素：
  

  • 索引鍵，識別您要更新的項目。
  • 表達式屬性名稱，是您要更新之屬性的預留位置。
  • 表達式屬性值，是您要更新其屬性的值的預留位置。
  • 更新表達式會使用表達式屬性名稱和表達式屬性值來宣告您要的更新。假設您最近已經為 John Grisham 的 The Rainmaker 新增了有聲書格式，並且您要更新 DynamoDB 資料表以反映該變更。UpdateItem API 呼叫如下所示。
    

  # The UpdateItem API allows you to update a particular item as identified by its key.
  resp = table.update_item(
      Key={"Author": "John Grisham", "Title": "The Rainmaker"},
      # Expression attribute names specify placeholders for attribute names to use in your update expressions.
      ExpressionAttributeNames={
          "#formats": "Formats",
          "#audiobook": "Audiobook",
      },
      # Expression attribute values specify placeholders for attribute values to use in your update expressions.
      ExpressionAttributeValues={
          ":id": "8WE3KPTP",
      },
      # UpdateExpression declares the updates you want to perform on your item.
      # For more details about update expressions, see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html
      UpdateExpression="SET #formats.#audiobook = :id",
  )

  您的 UpdateItem API 呼叫具有四個元素。首先，透過指定作者 John Grisham 和標題 The Rainmaker，來指定要操作項目的索引鍵。

  其次，您指定要在更新運算式中使用的表達式屬性名稱。您修改 Formats 屬性，其為一種對應，因此，您需要在對應內針對屬性 (Formats) 和索引鍵 (Audiobook) 定義運算式屬性名稱。

  最後，您撰寫要在 UpdateItem API 呼叫中套用的更新運算式。此更新運算式使用先前定義的運算式屬性名稱和表達式屬性值。您的 SET #formats.#audiobook = :id 表達式告知 DynamoDB 將 Formats 屬性的 Audiobook 索引鍵設定為 8WE3KPTP 的 ID 值。 

  第三，您說明要在表達式屬性值中使用的值。在 Formats 對應中，某個格式的值為庫存系統中的項目編號。在此範例中，值為 8WE3KPTP。

  update_item.py 指令碼讓 UpdateItem API 呼叫顯示在單元前面的程式碼區塊中。為顯示呼叫的差異，指令碼會先擷取並列印項目，然後再執行更新呼叫。然後，進行 UpdateItem API 呼叫。最後，指令碼再次擷取並列印項目以顯示差異。

  在執行指令碼之前，您需要新增幾行。透過 Cloud9 開啟 update_item.py，然後在指令碼頂端貼上以下 3 行：

  import boto3
  dynamodb = boto3.resource('dynamodb', region_name='us-east-1')
  table = dynamodb.Table('Books')

  接下來，執行以下命令：
  

  $ python update_item.py
  

  您應會看到以下輸出。
  

  Item before update:
  {'Title': 'The Rainmaker', 'Formats': {'Hardcover': 'J4SUKVGU', 'Paperback': 'D7YF4FCX'}, 'Author': 'John Grisham', 'Category': 'Suspense'}
  Item after update:
  {'Title': 'The Rainmaker', 'Formats': {'Audiobook': '8WE3KPTP', 'Hardcover': 'J4SUKVGU', 'Paperback': 'D7YF4FCX'}, 'Author': 'John Grisham', 'Category': 'Suspense'}

  如您所見，The Rainmaker 在套用更新後擁有新的 Audiobook 格式。

  在本單元，您學會如何使用 UpdateItem API 更新現有項目。 在下一個單元，您將學習如何清理所建立的資源，以避免額外收費。