Tổng số bảng html
Bạn phải cung cấp tên của thuộc tính khóa phân vùng và một giá trị duy nhất cho thuộc tính đó. 9 trả về tất cả các mục có giá trị khóa phân vùng đó. Theo tùy chọn, bạn có thể cung cấp thuộc tính khóa sắp xếp và sử dụng toán tử so sánh để tinh chỉnh kết quả tìm kiếm Show Để biết thêm thông tin về cách sử dụng 9, chẳng hạn như cú pháp yêu cầu, tham số phản hồi và các ví dụ bổ sung, hãy xem Truy vấn trong Tham chiếu API Amazon DynamoDBBiểu thức điều kiện chính cho truy vấnĐể chỉ định tiêu chí tìm kiếm, bạn sử dụng biểu thức điều kiện chính—một chuỗi xác định các mục sẽ được đọc từ bảng hoặc chỉ mục Bạn phải chỉ định tên và giá trị của khóa phân vùng làm điều kiện bình đẳng. Bạn không thể sử dụng thuộc tính không phải khóa trong Biểu thức điều kiện khóa Bạn có thể tùy chọn cung cấp điều kiện thứ hai cho khóa sắp xếp (nếu có). Điều kiện khóa sắp xếp phải sử dụng một trong các toán tử so sánh sau
Chức năng sau đây cũng được hỗ trợ
Các ví dụ về Giao diện dòng lệnh AWS (AWS CLI) sau đây minh họa việc sử dụng các biểu thức điều kiện chính. Các biểu thức này sử dụng phần giữ chỗ (chẳng hạn như 29 và 00) thay vì giá trị thực. Để biết thêm thông tin, hãy xem Tên thuộc tính biểu thức trong DynamoDB và Giá trị thuộc tính biểu thứcThí dụ Truy vấn bảng 01 cho một 02 cụ thể (khóa phân vùng). Tất cả các mục có giá trị 02 đó đều được truy vấn đọc vì khóa sắp xếp ( 04) không được bao gồm trong 05 6Thí dụ Truy vấn bảng 01 cho một 02 (khóa phân vùng) cụ thể, nhưng lần này chỉ trả về các mục có một 04 (khóa sắp xếp) nhất định
Các đối số cho 09 được lưu trữ trong tệp 20 3Thí dụ Truy vấn bảng 21 cho một 22 (khóa phân vùng) cụ thể, nhưng chỉ trả về những mục có 23 (khóa sắp xếp) bắt đầu bằng một số ký tự nhất định 2Các đối số cho 09 được lưu trữ trong tệp 20 0Bạn có thể sử dụng bất kỳ tên thuộc tính nào trong biểu thức điều kiện khóa, miễn là ký tự đầu tiên là 26 hoặc 27 và các ký tự còn lại (bắt đầu từ ký tự thứ hai, nếu có) là 26, 27 hoặc 50. Ngoài ra, tên thuộc tính không được là từ dành riêng của DynamoDB. (Để có danh sách đầy đủ về những từ này, hãy xem Các từ dành riêng trong DynamoDB. ) Nếu tên thuộc tính không đáp ứng các yêu cầu này, bạn phải xác định tên thuộc tính biểu thức làm trình giữ chỗ. Để biết thêm thông tin, hãy xem Tên thuộc tính biểu thức trong DynamoDBĐối với các mục có giá trị khóa phân vùng nhất định, DynamoDB lưu trữ các mục này gần nhau, theo thứ tự được sắp xếp theo giá trị khóa sắp xếp. Trong một hoạt động của 9, DynamoDB truy xuất các mục theo thứ tự đã sắp xếp, sau đó xử lý các mục bằng cách sử dụng 05 và bất kỳ 53 nào có thể có. Chỉ sau đó, kết quả 9 mới được gửi lại cho khách hàngThao tác 9 luôn trả về một tập kết quả. Nếu không tìm thấy mục nào phù hợp, tập kết quả sẽ trốngKết quả 9 luôn được sắp xếp theo giá trị khóa sắp xếp. Nếu kiểu dữ liệu của khóa sắp xếp là 57, kết quả được trả về theo thứ tự số. Mặt khác, kết quả được trả về theo thứ tự byte UTF-8. Theo mặc định, thứ tự sắp xếp tăng dần. Để đảo ngược thứ tự, đặt tham số 58 thành 59Một thao tác 9 đơn lẻ có thể truy xuất tối đa 1 MB dữ liệu. Giới hạn này được áp dụng trước khi bất kỳ 53 hoặc 92 nào được áp dụng cho kết quả. Nếu 93 xuất hiện trong phản hồi và không phải là null, thì bạn phải đánh số trang cho tập kết quả (xem Kết quả truy vấn bảng phân trang)Lọc biểu thức cho truy vấnNếu bạn cần tinh chỉnh thêm kết quả 9, bạn có thể tùy chọn cung cấp biểu thức bộ lọc. Biểu thức bộ lọc xác định mục nào trong kết quả 9 sẽ được trả lại cho bạn. Tất cả các kết quả khác đều bị loại bỏMột biểu thức bộ lọc được áp dụng sau khi 9 kết thúc, nhưng trước khi trả về kết quả. Do đó, một 9 tiêu thụ cùng một lượng dung lượng đọc, bất kể có biểu thức bộ lọc hay khôngThao tác 9 có thể truy xuất tối đa 1 MB dữ liệu. Giới hạn này áp dụng trước khi đánh giá biểu thức bộ lọcBiểu thức bộ lọc không thể chứa khóa phân vùng hoặc thuộc tính khóa sắp xếp. Bạn cần chỉ định các thuộc tính đó trong biểu thức điều kiện chính, không phải biểu thức bộ lọc Cú pháp của biểu thức bộ lọc tương tự như cú pháp của biểu thức điều kiện chính. Biểu thức bộ lọc có thể sử dụng cùng bộ so sánh, hàm và toán tử logic làm biểu thức điều kiện chính. Ngoài ra, biểu thức bộ lọc có thể sử dụng toán tử không bằng ( 99), toán tử 90, toán tử 91, toán tử 92, toán tử 93, toán tử 94, toán tử 95 và toán tử 96. Để biết thêm thông tin, xem vàThí dụ Ví dụ AWS CLI sau đây truy vấn bảng 01 cho một 02 (khóa phân vùng) và 04 (khóa sắp xếp) cụ thể. Trong số các mục được tìm thấy, chỉ những chủ đề thảo luận phổ biến nhất mới được trả về—nói cách khác, chỉ những chủ đề có nhiều hơn một số 90 nhất định 2Các đối số cho 09 được lưu trữ trong tệp 20 5Lưu ý rằng 90 là một từ dành riêng trong DynamoDB (xem Các từ dành riêng trong DynamoDB), vì vậy, ví dụ này sử dụng 94 làm trình giữ chỗ. Để biết thêm thông tin, hãy xem Tên thuộc tính biểu thức trong DynamoDBMột biểu thức bộ lọc xóa các mục khỏi tập kết quả 9. Nếu có thể, hãy tránh sử dụng 9 khi bạn muốn lấy một số lượng lớn các mặt hàng nhưng cũng cần loại bỏ hầu hết các mặt hàng đóGiới hạn số lượng mục trong tập kết quảThao tác 9 cho phép bạn giới hạn số lượng mục mà nó đọc. Để thực hiện việc này, hãy đặt tham số 98 thành số mục tối đa mà bạn muốnVí dụ: giả sử bạn 9 bảng, có giá trị 98 là 01 và không có biểu thức bộ lọc. Kết quả 9 chứa sáu mục đầu tiên từ bảng khớp với biểu thức điều kiện chính từ yêu cầuBây giờ, giả sử rằng bạn thêm một biểu thức bộ lọc vào 9. Trong trường hợp này, DynamoDB đọc tối đa sáu mục, sau đó chỉ trả về những mục khớp với biểu thức bộ lọc. Kết quả cuối cùng của 9 chứa sáu mục hoặc ít hơn, ngay cả khi nhiều mục hơn sẽ khớp với biểu thức bộ lọc nếu DynamoDB tiếp tục đọc nhiều mục hơnĐếm các mục trong kết quảNgoài các mục phù hợp với tiêu chí của bạn, phản hồi 9 chứa các yếu tố sau
Nếu bạn không sử dụng biểu thức bộ lọc, thì 06 và 07 có cùng giá trịNếu kích thước của tập kết quả 9 lớn hơn 1 MB, thì 06 và 07 chỉ đại diện cho một phần tổng số mục. Bạn cần thực hiện nhiều thao tác 9 để truy xuất tất cả kết quả (xem Kết quả truy vấn bảng phân trang)Mỗi phản hồi của 9 chứa 06 và 07 cho các mục đã được xử lý theo yêu cầu cụ thể của 9 đó. Để có được tổng số lớn cho tất cả các yêu cầu của 9, bạn có thể tiếp tục kiểm đếm cả 06 và 07Đơn vị dung lượng được tiêu thụ bởi truy vấnBạn có thể 9 bất kỳ bảng hoặc chỉ mục phụ nào, miễn là nó có khóa chính tổng hợp (khóa phân vùng và khóa sắp xếp). Hoạt động của 9 tiêu thụ các đơn vị dung lượng đọc, như sauNếu bạn 9 một. DynamoDB sử dụng các đơn vị dung lượng đọc từ. TableKhả năng đọc được cung cấp của bảng. Chỉ số phụ toàn cầu Chỉ số được cung cấp khả năng đọc. Chỉ mục phụ cục bộ Các bảng cơ sở cung cấp khả năng đọcTheo mặc định, một hoạt động của 9 không trả về bất kỳ dữ liệu nào về dung lượng đọc mà nó tiêu thụ. Tuy nhiên, bạn có thể chỉ định tham số 25 trong yêu cầu 9 để lấy thông tin này. Sau đây là các cài đặt hợp lệ cho 25
DynamoDB tính toán số lượng đơn vị dung lượng đọc đã sử dụng dựa trên kích thước mục, chứ không phải lượng dữ liệu được trả về ứng dụng. Vì lý do này, số lượng đơn vị dung lượng được tiêu thụ là như nhau cho dù bạn yêu cầu tất cả các thuộc tính (hành vi mặc định) hay chỉ một số thuộc tính (sử dụng biểu thức phép chiếu). Con số này cũng giống nhau cho dù bạn có sử dụng biểu thức bộ lọc hay không. 9 tiêu thụ một đơn vị dung lượng đọc tối thiểu (0. 5 với mặc định cuối cùng nhất quán, 1. 0 nhất quán mạnh mẽ) cho mỗi phân vùng liên quan đến việc phục vụ yêu cầu - điều này bao gồm các phân vùng không chứa bất kỳ mục nàoĐọc tính nhất quán cho truy vấnTheo mặc định, hoạt động 9 thực hiện các lần đọc nhất quán cuối cùng. Điều này có nghĩa là kết quả 9 có thể không phản ánh những thay đổi do các thao tác 34 hoặc 35 mới hoàn thành gần đây. Để biết thêm thông tin, hãy xem Tính nhất quán đọcNếu bạn yêu cầu số lần đọc nhất quán mạnh mẽ, hãy đặt tham số 36 thành 37 trong yêu cầu 9 |