28/09/2026 · VietTechies · Biên tập
GitHub đang thay đổi cách GitHub Actions báo cáo quy mô kết quả truy vấn workflow run lớn. Với các lượt tìm kiếm được lọc theo workflow, sự kiện, trạng thái, nhánh hoặc người thực hiện, mọi tập kết quả vượt quá 2.500 bản ghi giờ đây sẽ được biểu thị là 2.500+ thay vì cố gắng đưa ra con số chính xác. GitHub công bố thay đổi này vào ngày 25 tháng 9 năm 2026 và cho biết tính năng đang được triển khai trên github.com cùng GitHub Enterprise Cloud.
Vì sao GitHub không còn cung cấp số đếm chính xác
Theo GitHub, các truy vấn bao phủ hơn 2.500 workflow run thường xuyên hết thời gian chờ. Trong những trường hợp đó, số đếm trả về có thể chỉ phản ánh những bản ghi được tìm thấy trước khi truy vấn bị ngắt, thay vì tổng số thực tế. Việc thay con số chưa đầy đủ này bằng một ngưỡng tối thiểu rõ ràng nhằm giúp kết quả bớt chi tiết nhưng chính xác hơn, đồng thời cải thiện hiệu năng truy vấn.
Giới hạn phân trang không thay đổi
Điều chỉnh này tác động đến số đếm được báo cáo, không làm thay đổi mức trần phân trang hiện có. GitHub sẽ tiếp tục trả về kết quả workflow run theo từng trang, với tổng cộng tối đa 1.000 mục. Vì vậy, nhà phát triển không thể hiểu chỉ báo 2.500+ là quyền liệt kê toàn bộ bản ghi phù hợp thông qua cùng một yêu cầu có phạm vi rộng. Chỉ báo này cho biết truy vấn bao phủ một tập kết quả không xác định giới hạn trên và đã vượt ngưỡng.
Các tích hợp có thể cần bộ lọc hẹp hơn
Những tập lệnh và tích hợp phụ thuộc vào việc truy xuất hơn 2.500 workflow run phù hợp từ một truy vấn sẽ phải chia yêu cầu thành các khoảng nhỏ hơn. GitHub đặc biệt khuyến nghị thu hẹp bộ lọc, chẳng hạn bổ sung khoảng ngày, để mỗi truy vấn nhắm chính xác hơn đến các lượt chạy cần thiết.
Tác động thực tế phụ thuộc vào cách bên sử dụng xử lý phản hồi API. Các bảng điều khiển chỉ cần cho biết đang tồn tại một lượng tồn đọng lớn có thể hiển thị trực tiếp số đếm theo ngưỡng tối thiểu. Ngược lại, hệ thống báo cáo, tác vụ lưu trữ hoặc hoạt động kiểm toán cần phạm vi bao phủ chính xác sẽ phải chia nhỏ lượt tìm kiếm và xử lý khả năng trùng lặp giữa các tập kết quả có phạm vi hẹp hơn.
Ranh giới lỗi rõ ràng hơn
Thay đổi này thay thế một giá trị trông có vẻ chính xác nhưng có thể gây hiểu nhầm bằng một trạng thái vượt ngưỡng được xác định rõ. Nó cũng tách biệt hai vấn đề của API: số đếm cho biết có hơn 2.500 bản ghi phù hợp, còn cơ chế phân trang vẫn quyết định số workflow run có thể được trả về. Khi cập nhật cách xử lý lịch sử GitHub Actions quy mô lớn, bên sử dụng nên coi đây là hai giới hạn riêng biệt.
Ảnh minh họa do AI tạo, không phải ảnh tư liệu.
Nguồn: Changes to query results in the GitHub Actions API and UI