Bài 39 – Data Lineage: một con số trên dashboard BĐS đến từ đâu? thuộc series Tin học BĐS. Bài ưu tiên giải thích bằng tiếng Việt và chỉ giữ các tên kỹ thuật cần thiết để người học có thể thao tác đúng trong công cụ.
Biên soạn: ThS. Nguyễn Mạnh Hùng
Đơn vị: GV. Khoa QLĐĐ&BĐS – ĐH Nông Lâm TP.HCM
Email: nguyenmanhhung@hcmuaf.edu.vn
Cập nhật 01/10/2026: Bài thuộc phần API, JSON và tích hợp dữ liệu của series Tin học BĐS. Nội dung ưu tiên tiếng Việt thuần; chỉ giữ nguyên tên giao thức, định dạng và cú pháp kỹ thuật khi cần thao tác thực tế. Các ví dụ và số liệu đều là tình huống giả lập phục vụ giảng dạy.
Ranh giới chuyên đề: Bài thuộc phần API, JSON và tích hợp dữ liệu. API/JSON/REST được giữ nguyên vì là tên kỹ thuật; các khái niệm còn lại được diễn giải bằng tiếng Việt như yêu cầu, phản hồi, phân trang, khóa API và dòng truy vết nguồn dữ liệu.
1. Dòng truy vết nguồn dữ liệu là khả năng trả lời một con số trên báo cáo đến từ nguồn nào, qua những bước nào và được tính bằng quy tắc gì
Dòng truy vết nguồn dữ liệu là khả năng trả lời một con số trên báo cáo đến từ nguồn nào, qua những bước nào và được tính bằng quy tắc gì.
Trong thực hành, mỗi nguyên tắc cần được chuyển thành điều kiện có thể kiểm tra. Người học phải biết dữ liệu đến từ đâu, trường nào có thể rỗng, khóa nào dùng để liên kết, khi nào phải dừng và kết quả sau xử lý phải có đặc điểm gì.
2. Một chỉ tiêu 'Giá rao trung bình quận A' có thể đi từ API nguồn → bảng thô → làm sạch → loại trùng → chuẩn hóa đơn vị → nhóm theo quận → bảng điều khiển
Một chỉ tiêu 'Giá rao trung bình quận A' có thể đi từ API nguồn → bảng thô → làm sạch → loại trùng → chuẩn hóa đơn vị → nhóm theo quận → bảng điều khiển.
Trong thực hành, mỗi nguyên tắc cần được chuyển thành điều kiện có thể kiểm tra. Người học phải biết dữ liệu đến từ đâu, trường nào có thể rỗng, khóa nào dùng để liên kết, khi nào phải dừng và kết quả sau xử lý phải có đặc điểm gì.
3. Nếu không có dòng truy vết, khi số liệu thay đổi người dùng chỉ thấy kết quả khác nhưng không biết do nguồn đổi, quy tắc đổi hay lỗi xử lý
Nếu không có dòng truy vết, khi số liệu thay đổi người dùng chỉ thấy kết quả khác nhưng không biết do nguồn đổi, quy tắc đổi hay lỗi xử lý.
Trong thực hành, mỗi nguyên tắc cần được chuyển thành điều kiện có thể kiểm tra. Người học phải biết dữ liệu đến từ đâu, trường nào có thể rỗng, khóa nào dùng để liên kết, khi nào phải dừng và kết quả sau xử lý phải có đặc điểm gì.
| Câu hỏi kiểm | Mục đích |
|---|---|
| Nguồn nào? | Truy vết |
| Khóa nào? | Không trùng/không nhầm |
| Rỗng có nghĩa gì? | Không gán sai |
| Có giới hạn/phân trang? | Không thiếu dữ liệu |
| Sau xử lý kiểm gì? | Có bằng chứng |
4. Mỗi bước quan trọng nên ghi đầu vào, đầu ra, quy tắc và người/quy trình chịu trách nhiệm; không cần tài liệu dài nhưng phải đủ để tái lập
Mỗi bước quan trọng nên ghi đầu vào, đầu ra, quy tắc và người/quy trình chịu trách nhiệm; không cần tài liệu dài nhưng phải đủ để tái lập.
Trong thực hành, mỗi nguyên tắc cần được chuyển thành điều kiện có thể kiểm tra. Người học phải biết dữ liệu đến từ đâu, trường nào có thể rỗng, khóa nào dùng để liên kết, khi nào phải dừng và kết quả sau xử lý phải có đặc điểm gì.
5. Phiên bản nguồn và thời gian lấy dữ liệu là phần của truy vết vì cùng một API ở hai thời điểm có thể trả kết quả khác nhau
Phiên bản nguồn và thời gian lấy dữ liệu là phần của truy vết vì cùng một API ở hai thời điểm có thể trả kết quả khác nhau.
Trong thực hành, mỗi nguyên tắc cần được chuyển thành điều kiện có thể kiểm tra. Người học phải biết dữ liệu đến từ đâu, trường nào có thể rỗng, khóa nào dùng để liên kết, khi nào phải dừng và kết quả sau xử lý phải có đặc điểm gì.
6. Công thức hoặc câu lệnh tạo chỉ tiêu phải được lưu cùng định nghĩa nghiệp vụ; tên chỉ tiêu ngắn không đủ giải thích cách tính
Công thức hoặc câu lệnh tạo chỉ tiêu phải được lưu cùng định nghĩa nghiệp vụ; tên chỉ tiêu ngắn không đủ giải thích cách tính.
Trong thực hành, mỗi nguyên tắc cần được chuyển thành điều kiện có thể kiểm tra. Người học phải biết dữ liệu đến từ đâu, trường nào có thể rỗng, khóa nào dùng để liên kết, khi nào phải dừng và kết quả sau xử lý phải có đặc điểm gì.
| Câu hỏi kiểm | Mục đích |
|---|---|
| Nguồn nào? | Truy vết |
| Khóa nào? | Không trùng/không nhầm |
| Rỗng có nghĩa gì? | Không gán sai |
| Có giới hạn/phân trang? | Không thiếu dữ liệu |
| Sau xử lý kiểm gì? | Có bằng chứng |
7. Dòng truy vết giúp kiểm toán dữ liệu, sửa lỗi nhanh hơn và giảm tranh luận giữa các bộ phận khi cùng một chỉ tiêu có hai con số
Dòng truy vết giúp kiểm toán dữ liệu, sửa lỗi nhanh hơn và giảm tranh luận giữa các bộ phận khi cùng một chỉ tiêu có hai con số.
Trong thực hành, mỗi nguyên tắc cần được chuyển thành điều kiện có thể kiểm tra. Người học phải biết dữ liệu đến từ đâu, trường nào có thể rỗng, khóa nào dùng để liên kết, khi nào phải dừng và kết quả sau xử lý phải có đặc điểm gì.
8. Trong bài tập, sinh viên nên chọn một chỉ tiêu và vẽ toàn bộ đường đi từ nguồn tới báo cáo thay vì chỉ trình bày kết quả cuối
Trong bài tập, sinh viên nên chọn một chỉ tiêu và vẽ toàn bộ đường đi từ nguồn tới báo cáo thay vì chỉ trình bày kết quả cuối.
Trong thực hành, mỗi nguyên tắc cần được chuyển thành điều kiện có thể kiểm tra. Người học phải biết dữ liệu đến từ đâu, trường nào có thể rỗng, khóa nào dùng để liên kết, khi nào phải dừng và kết quả sau xử lý phải có đặc điểm gì.
Bảng trọng tâm
| Mắt xích | Ví dụ | Cần lưu |
|---|---|---|
| Nguồn | API | Thời gian/phiên bản |
| Biến đổi | Chuẩn giá | Quy tắc |
| Tổng hợp | Theo quận | Câu lệnh/công thức |
| Báo cáo | Bảng điều khiển | Chỉ tiêu |
Tích hợp dữ liệu là một chuỗi có kiểm soát
Khi lấy dữ liệu từ hệ thống khác, quy trình không dừng ở việc 'đã lấy được JSON'. Cần kiểm quyền truy cập, cấu trúc phản hồi, phân trang, kiểu dữ liệu, lỗi, thời gian lấy và khả năng truy vết đến nguồn.
| Lớp | Câu hỏi | Bằng chứng |
|---|---|---|
| Nguồn | Có được phép dùng? | Điều khoản/tài liệu |
| Yêu cầu | Gọi gì? | Địa chỉ + tham số |
| Phản hồi | Nhận gì? | Mã trạng thái + JSON |
| Biến đổi | Đã sửa gì? | Các bước Power Query |
| Đầu ra | Dùng ở đâu? | Bảng/báo cáo |
| Truy vết | Số liệu từ đâu? | Nhật ký nguồn |
Không nhầm 'tự động' với 'đúng'
API giúp lấy dữ liệu tự động nhưng dữ liệu vẫn có thể thiếu, trùng, cũ hoặc thay đổi cấu trúc. Mỗi lần làm mới cần kiểm số bản ghi, tỷ lệ trường rỗng, khóa duy nhất, thời gian cập nhật và lỗi phản hồi.
Quyền sử dụng dữ liệu là một phần của kỹ thuật
Việc một hệ thống cho phép gọi API không tự động có nghĩa người dùng được phép lưu, phân phối hoặc khai thác mọi dữ liệu. Sinh viên cần hình thành thói quen kiểm tài liệu, điều khoản sử dụng và phạm vi quyền trước khi tích hợp.
Một con số cần có 'hồ sơ nguồn'
Chỉ tiêu quan trọng nên biết nguồn gốc, thời điểm, quy tắc làm sạch, công thức và phiên bản. Đây là nền để hai phòng ban không tranh luận bằng hai con số mà không biết khác nhau ở đâu.
Tình huống giả lập phục vụ giảng dạy
Bảng điều khiển hiển thị 'Giá rao trung bình = 72,4 triệu/m²' nhưng tuần trước là 69,8. Hãy thiết kế quy trình truy vết để xác định thay đổi đến từ nguồn, làm sạch hay công thức.
Sinh viên phải trình bày cả cấu trúc, thao tác, lỗi có thể gặp và cách kiểm tra. Không chỉ nộp một ảnh chụp bảng dữ liệu hoặc đoạn lệnh chạy được mà phải giải thích đường đi của dữ liệu.
Quy trình thực hành gợi ý
- Xác định nguồn dữ liệu và quyền sử dụng.
- Ghi rõ câu hỏi nghiệp vụ hoặc dữ liệu cần lấy.
- Xác định khóa, trường bắt buộc và giá trị rỗng.
- Thử trên tập nhỏ trước khi lấy toàn bộ.
- Ghi số bản ghi, thời gian và lỗi phản hồi.
- Chuẩn hóa kiểu dữ liệu trước khi phân tích.
- Lưu các bước biến đổi hoặc truy vấn.
- Tạo bảng kiểm để người khác có thể chạy lại.
Tiêu chí chấm bài thực hành
| Tiêu chí | Tỷ trọng gợi ý | Đạt khi |
|---|---|---|
| Hiểu cấu trúc | 25% | Phân biệt đúng đối tượng/trường |
| Kỹ thuật | 25% | Truy vấn/kết nối đúng |
| Kiểm soát lỗi | 20% | Xử lý rỗng, phân trang, mã lỗi |
| Truy vết | 20% | Nguồn và biến đổi rõ |
| Bàn giao | 10% | Người khác chạy lại được |
Bài tập mở rộng
- Tạo bộ dữ liệu giả lập ít nhất 500 BĐS.
- Thiết kế trường có NULL hợp lý và trường bắt buộc.
- Tạo một phản hồi JSON giả lập có đối tượng và mảng.
- Thiết kế quy trình lấy dữ liệu nhiều trang.
- Ghi nhật ký thời gian, tham số và số bản ghi.
- Biến dữ liệu thành bảng và kiểm khóa duy nhất.
- Vẽ dòng truy vết từ nguồn đến một chỉ tiêu báo cáo.
- So sánh phương án API, CSV và sao chép/dán cho cùng bài toán.
Những lỗi thường gặp
- Dùng 0 để thay cho dữ liệu chưa có.
- Dùng địa chỉ làm khóa chính.
- Lặp danh mục ở mọi bảng.
- Không đọc tài liệu API.
- Để lộ khóa API.
- Chỉ lấy trang đầu rồi tưởng đã đủ dữ liệu.
- Mở rộng mảng JSON làm nhân bản dòng mà không biết.
- Làm mới nhưng không kiểm số dòng.
- Không ghi nguồn và thời gian lấy dữ liệu.
- Dùng API dù quy trình đơn giản hơn đã đủ.
Liên hệ công việc BĐS
Trong hệ thống BĐS hiện đại, dữ liệu hiếm khi nằm ở một nơi. Excel, cơ sở dữ liệu, bản đồ, website và phần mềm nội bộ thường phải trao đổi với nhau. Người làm BĐS không nhất thiết trở thành lập trình viên, nhưng cần hiểu dữ liệu được lấy thế nào, vì sao có thể thiếu, cách kiểm nguồn và cách phát hiện khi một chỉ tiêu bị thay đổi do lỗi tích hợp.
Tiêu chí tự đánh giá
| Tiêu chí | Đạt khi |
|---|---|
| Hiểu nghĩa dữ liệu | Không nhầm NULL/0/rỗng |
| Hiểu cấu trúc | Đọc được JSON/API cơ bản |
| An toàn | Không lộ khóa truy cập |
| Đủ dữ liệu | Xử lý phân trang |
| Truy vết | Biết số liệu đến từ đâu |
Câu hỏi tự kiểm tra
- NULL này có nghĩa nghiệp vụ gì?
- API có được phép sử dụng theo mục đích này không?
- Tôi đã lấy đủ mọi trang chưa?
- Khóa API có xuất hiện trong tệp chia sẻ không?
- Sau khi mở rộng JSON, số dòng có tăng ngoài dự kiến không?
- Tôi có thể giải thích con số trên báo cáo đến từ đâu không?
Ghi nhớ trong 30 giây
- Dòng truy vết nguồn dữ liệu là khả năng trả lời một con số trên báo cáo đến từ nguồn nào, qua những bước nào và được tính bằng quy tắc gì.
- Nếu không có dòng truy vết, khi số liệu thay đổi người dùng chỉ thấy kết quả khác nhưng không biết do nguồn đổi, quy tắc đổi hay lỗi xử lý.
- Phiên bản nguồn và thời gian lấy dữ liệu là phần của truy vết vì cùng một API ở hai thời điểm có thể trả kết quả khác nhau.
- Dòng truy vết giúp kiểm toán dữ liệu, sửa lỗi nhanh hơn và giảm tranh luận giữa các bộ phận khi cùng một chỉ tiêu có hai con số.
- Trong bài tập, sinh viên nên chọn một chỉ tiêu và vẽ toàn bộ đường đi từ nguồn tới báo cáo thay vì chỉ trình bày kết quả cuối.
Nguồn tham khảo
- Đề cương học phần 612421 – Tin học ứng dụng trong bất động sản, Trường Đại học Nông Lâm TP.HCM.
- Kế hoạch 96 chủ đề website – series Tin học BĐS trong hệ thống BDSNL.
- PostgreSQL Documentation – tài liệu chính thức về NULL, mô hình quan hệ và truy vấn SQL.
- Microsoft Support – tài liệu chính thức về Power Query và kết nối dữ liệu web.
- MDN Web Docs và tài liệu kỹ thuật JSON/HTTP – tham khảo về yêu cầu, phản hồi, mã trạng thái và dữ liệu JSON.
- Nguyên tắc quản trị dữ liệu: nguồn gốc, tính mới, khóa truy cập, nhật ký biến đổi và khả năng truy vết.
Bài tiếp theo: “Khi nào nên dùng API thay vì copy/paste hoặc tải CSV thủ công?”.
Gợi ý kiểm tra chéo trong lớp
Một nhóm chuẩn bị dữ liệu nguồn hoặc phản hồi JSON, nhóm khác chỉ được nhận tài liệu kết nối và phải tái lập bảng kết quả. Nếu không xác định được trang tiếp theo, trường rỗng hay nguồn chỉ tiêu, nhóm thiết kế phải bổ sung tài liệu.
Sau khi kiểm chéo, sinh viên ghi lại ít nhất ba lỗi hoặc điểm chưa rõ và đề xuất cách sửa. Mục tiêu là hình thành thói quen coi tích hợp dữ liệu là quy trình cần kiểm soát, không phải thao tác kỹ thuật một lần.
Gợi ý kiểm tra chéo trong lớp
Một nhóm chuẩn bị dữ liệu nguồn hoặc phản hồi JSON, nhóm khác chỉ được nhận tài liệu kết nối và phải tái lập bảng kết quả. Nếu không xác định được trang tiếp theo, trường rỗng hay nguồn chỉ tiêu, nhóm thiết kế phải bổ sung tài liệu.
Sau khi kiểm chéo, sinh viên ghi lại ít nhất ba lỗi hoặc điểm chưa rõ và đề xuất cách sửa. Mục tiêu là hình thành thói quen coi tích hợp dữ liệu là quy trình cần kiểm soát, không phải thao tác kỹ thuật một lần.
Gợi ý kiểm tra chéo trong lớp
Một nhóm chuẩn bị dữ liệu nguồn hoặc phản hồi JSON, nhóm khác chỉ được nhận tài liệu kết nối và phải tái lập bảng kết quả. Nếu không xác định được trang tiếp theo, trường rỗng hay nguồn chỉ tiêu, nhóm thiết kế phải bổ sung tài liệu.
Sau khi kiểm chéo, sinh viên ghi lại ít nhất ba lỗi hoặc điểm chưa rõ và đề xuất cách sửa. Mục tiêu là hình thành thói quen coi tích hợp dữ liệu là quy trình cần kiểm soát, không phải thao tác kỹ thuật một lần.
Gợi ý kiểm tra chéo trong lớp
Một nhóm chuẩn bị dữ liệu nguồn hoặc phản hồi JSON, nhóm khác chỉ được nhận tài liệu kết nối và phải tái lập bảng kết quả. Nếu không xác định được trang tiếp theo, trường rỗng hay nguồn chỉ tiêu, nhóm thiết kế phải bổ sung tài liệu.
Sau khi kiểm chéo, sinh viên ghi lại ít nhất ba lỗi hoặc điểm chưa rõ và đề xuất cách sửa. Mục tiêu là hình thành thói quen coi tích hợp dữ liệu là quy trình cần kiểm soát, không phải thao tác kỹ thuật một lần.
Gợi ý kiểm tra chéo trong lớp
Một nhóm chuẩn bị dữ liệu nguồn hoặc phản hồi JSON, nhóm khác chỉ được nhận tài liệu kết nối và phải tái lập bảng kết quả. Nếu không xác định được trang tiếp theo, trường rỗng hay nguồn chỉ tiêu, nhóm thiết kế phải bổ sung tài liệu.
Sau khi kiểm chéo, sinh viên ghi lại ít nhất ba lỗi hoặc điểm chưa rõ và đề xuất cách sửa. Mục tiêu là hình thành thói quen coi tích hợp dữ liệu là quy trình cần kiểm soát, không phải thao tác kỹ thuật một lần.