Vnstock Logo
Module kết nối dữ liệu · thư viện vnstock

Vnstock kết nối và chuẩn hoá dữ liệu thế nào

Vnstock là hệ sinh thái tự động hoá cá nhân trong nghiên cứu đầu tư. Sơ đồ dưới đây chỉ giải thích cơ chế của thư viện vnstock: module giúp bạn kết nối và chuẩn hoá dữ liệu đầu vào trên hạ tầng mình chọn.

Chọn từng tầng để xem trách nhiệm và giới hạn của module

Vị trí trong hệ sinh thái

Kết nối dữ liệu là bước đầu, không phải toàn bộ Vnstock

Đầu ra của thư viện vnstock có thể tiếp tục đi vào các công cụ định lượng, tự động hoá hoặc quy trình riêng của bạn. Mỗi thư viện thế hệ 5 có một vai trò độc lập.

vnstock

Kết nối và chuẩn hoá dữ liệu đầu vào

Vnstock News

Theo dõi và sắp xếp thông tin để đọc tại nguồn

Vnstock Pipeline

Kiểm tra chất lượng, lưu trữ và tự động hoá quy trình

Vnstock Quant

Tính toán định lượng trên dữ liệu của bạn

Dữ liệu đầu vào do bạn chọn

Thư viện vnstock bắt đầu từ nguồn bên thứ ba bạn có quyền dùng và yêu cầu nghiên cứu do bạn xác định.

Nguồn được hỗ trợ
Tham số truy vấn
Quyền sử dụng

Nguồn được hỗ trợ

Phạm vi và điều kiện được ghi trong tài liệu của từng nhóm hàm

Tham số truy vấn

Mã, khoảng thời gian và trường thông tin do bạn lựa chọn

Quyền sử dụng

Khả năng truy cập không đồng nghĩa với quyền sử dụng không giới hạn

Đây là điểm bắt đầu của riêng module kết nối dữ liệu, không phải định nghĩa cho toàn bộ hệ sinh thái Vnstock.

Bạn chọn nguồn và tự kiểm tra điều kiện áp dụng cho việc lưu trữ, phân tích, hiển thị hoặc chia sẻ dữ liệu của mình.

Bạn tạo lời gọi hàm trên hạ tầng mình chọn

Tầng kết nối

Lời gọi hàm được chuyển thành yêu cầu phù hợp với nguồn bạn chọn.

Chạy trên hạ tầng của bạn
Gửi truy vấn tới nguồn
Nhận phản hồi

Chạy trên hạ tầng của bạn

Thiết bị, máy chủ hoặc dịch vụ đám mây do bạn chọn

Gửi truy vấn tới nguồn

Trực tiếp hoặc qua proxy do bạn tự cấu hình

Nhận phản hồi

Phản hồi được chuyển sang tầng chuẩn hoá tại cùng hạ tầng

Thư viện không vận hành kho dữ liệu thị trường tập trung để bán hoặc phân phối lại nội dung của nguồn.

Nguồn có thể đặt giới hạn hoặc biện pháp kiểm soát truy cập. Thư viện không được thiết kế để vượt những biện pháp đó.

Phản hồi được chuyển sang bước chuẩn hoá

Tầng chuẩn hoá

Phản hồi từ nguồn được chuyển thành cấu trúc nhất quán để bạn dễ kiểm tra và xử lý tiếp.

Ép kiểu
Đồng bộ đơn vị
Chuẩn hoá tên trường
Tổ chức dạng bảng

Ép kiểu

Chuỗi, số và thời gian được đưa về kiểu phù hợp

Đồng bộ đơn vị

Đơn vị được chuyển về quy ước của từng nhóm dữ liệu

Chuẩn hoá tên trường

Tên trường nhất quán giữa các nguồn được hỗ trợ

Tổ chức dạng bảng

Kết quả được sắp xếp để tiếp tục phân tích bằng Python

Mỗi nguồn có thể dùng tên trường, kiểu dữ liệu và đơn vị khác nhau. Tầng chuẩn hoá ánh xạ chúng về quy ước được công bố trong tài liệu.

Chuẩn hoá giúp code phía sau ít phụ thuộc hơn vào cấu trúc riêng của từng nguồn; nó không thay thế việc đối chiếu dữ liệu gốc.

Cấu trúc thống nhất được trả qua giao diện thư viện

Giao diện thư viện vnstock

Bạn làm việc với các nhóm hàm thống nhất thay vì tự xử lý từng kiểu phản hồi của nguồn.

Reference()
Market()
Fundamental()
Các nhóm khác

Reference()

Nhóm thông tin tham chiếu

Market()

Nhóm thông tin thị trường

Fundamental()

Nhóm báo cáo tài chính

Các nhóm khác

Phạm vi cụ thể được công bố theo phiên bản trong tài liệu

Cú pháp thống nhất giúp bạn chuyển giữa các nhóm công việc mà không phải học lại toàn bộ cách tổ chức lệnh.

Tên hàm, tham số và cấu trúc đầu ra của từng phiên bản được mô tả trong tài liệu thư viện.

Kết quả tiếp tục đi vào quy trình nghiên cứu của bạn

Đầu ra trên hạ tầng của bạn

Kết quả trở thành đầu vào cho bước phân tích, tự động hoá hoặc lưu trữ do bạn lựa chọn.

pandas DataFrame
Vnstock Quant
Vnstock Pipeline
Trợ lý AI

pandas DataFrame

Kiểm tra và phân tích bằng hệ công cụ Python

Vnstock Quant

Tính toán định lượng trên dữ liệu của bạn

Vnstock Pipeline

Kiểm tra chất lượng, lưu có tổ chức và tự động hoá quy trình

Trợ lý AI

Hỗ trợ viết mã theo Agent Skills và tài liệu Vnstock

Đầu ra không phải điểm kết thúc của hệ sinh thái. Đây là đầu vào để bạn dùng các thư viện khác hoặc công cụ riêng cho bước nghiên cứu tiếp theo.

Dữ liệu nghiệp vụ được xử lý và lưu trên thiết bị, máy chủ hoặc dịch vụ đám mây do bạn chọn.

Ba nguyên tắc của module kết nối dữ liệu

Các nguyên tắc này áp dụng cho thư viện vnstock, không đại diện cho toàn bộ cơ chế của những thư viện khác trong hệ sinh thái.

Minh bạch nguồn gốc

Truy vấn xuất phát từ hạ tầng bạn chọn và đi tới nguồn, trực tiếp. Quyền sử dụng dữ liệu phụ thuộc vào từng nguồn.

Tách bạch lớp xử lý

Kết nối, chuẩn hoá và giao diện hàm có trách nhiệm riêng. Cách chia lớp giúp giới hạn ảnh hưởng khi cấu trúc của một nguồn thay đổi.

Đầu ra chuẩn hoá

Kết quả từ các nguồn được hỗ trợ được đưa về quy ước có tài liệu, để bạn kiểm tra và chuyển sang bước phân tích tiếp theo.

Bắt đầu với thư viện vnstock

Xem cú pháp, phạm vi nguồn được hỗ trợ và cấu trúc đầu ra của phiên bản hiện hành trong tài liệu thư viện.