在 Go(AWS SDK v2)中使用 DynamoDB Scan
Scan 逐頁讀取表格或索引中的每一個項目,然後可選擇以 FilterExpression 丟棄列。在 AWS SDK for Go v2 中,內建的 ScanPaginator 會追蹤 LastEvaluatedKey,直到整個表格讀完。
Code
package main
import (
"context"
"fmt"
"log"
"github.com/aws/aws-sdk-go-v2/aws"
"github.com/aws/aws-sdk-go-v2/config"
"github.com/aws/aws-sdk-go-v2/service/dynamodb"
"github.com/aws/aws-sdk-go-v2/service/dynamodb/types"
)
func main() {
ctx := context.TODO()
cfg, err := config.LoadDefaultConfig(ctx, config.WithRegion("us-east-1"))
if err != nil {
log.Fatalf("load config: %v", err)
}
client := dynamodb.NewFromConfig(cfg)
paginator := dynamodb.NewScanPaginator(client, &dynamodb.ScanInput{
TableName: aws.String("Music"),
FilterExpression: aws.String("#filter0 >= :filterValue0"),
ExpressionAttributeNames: map[string]string{
"#filter0": "Year",
},
ExpressionAttributeValues: map[string]types.AttributeValue{
":filterValue0": &types.AttributeValueMemberN{Value: "2010"},
},
})
var items []map[string]types.AttributeValue
for paginator.HasMorePages() {
page, err := paginator.NextPage(ctx)
if err != nil {
log.Fatalf("scan: %v", err)
}
items = append(items, page.Items...)
}
fmt.Printf("Matched %d items\n", len(items))
}說明
FilterExpression— 在伺服器端於讀取之後套用。它縮小的是回應,而非成本:無論是否過濾,你都要為每個被掃描的項目付費。ExpressionAttributeNames— 被過濾的屬性以別名表示(#filter0→Year),讓像Year這樣的保留字保持安全。- 分頁 — 每個
Scan頁在過濾 之前 最多讀取 1 MB,因此當表格仍有符合項目時,一個過濾後的頁可能回傳空的。dynamodb.NewScanPaginator會持續呼叫直到LastEvaluatedKey耗盡 — 絕不要停在第一頁。 - 設定
Limit可限制每頁掃描的項目數(過濾前)— 它不限制回傳的項目數。 - 對大型的全表 scan,以
Segment/TotalSegments把工作分散到各 goroutine(一個平行 scan)。 - 偏好
Query。Scan讀取整個表格;除了極小的表格以外,它又慢又貴。
改用視覺化操作
手動組裝 filter?DynamoDB Expression Builder 會建立 FilterExpression 與 name/value map 並複製可執行的程式碼。
想在 GUI 中探索表格 — 具備過濾、分頁的結果格線與複製為程式碼 — 下載 DynoTable,別再從指令稿盲目地 scan。
相關範例
- 在 Java 中使用 DynamoDB Scan — 以 AWS SDK for Java 2.x 執行相同的 scan。
- 在 Go 中使用 DynamoDB Query — 你通常該優先採用的較便宜讀取。
- Query vs. Scan — 何時(罕見地)
Scan才合理。 - 為什麼我的 DynamoDB Scan 又慢又貴? — 成本模型以及如何避免它。
- DynamoDB ProvisionedThroughputExceededException — 全表 scan 對佈建表格的容量造成什麼影響。
- DynamoDB ThrottlingException — 另一種節流,以及指數退避如何處理它。
References
- Scan — Amazon DynamoDB API Reference
- Use Scan with an AWS SDK or CLI — Amazon DynamoDB Developer Guide
- dynamodb package — AWS SDK for Go v2 (pkg.go.dev)
- dynamodb/types package — AWS SDK for Go v2 (pkg.go.dev)
- Scanning tables — Amazon DynamoDB Developer Guide
最後驗證於 2026-07-13,對照上方連結的 AWS 官方文件。