Mẫu Jinja là ngôn ngữ mẫu mà bạn có thể sử dụng để xây dựng các truy vấn SQL động. Các truy vấn này điều chỉnh dựa trên các điều kiện bạn xác định. Sử dụng các mẫu Jinja trong bộ dữ liệu ảo trong BI Builder. Ví dụ: bạn có thể đặt phạm vi ngày động để chỉ trả về dữ liệu trong khoảng thời gian đã chọn.
Trong bài viết này, bạn sẽ tìm hiểu cách thêm mẫu Jinja vào tập dữ liệu ảo và cách sử dụng các biến mẫu chính.
Tạo tập dữ liệu ảo
- Mở Trình tạo BI .
- Đi tới SQL > Phòng thí nghiệm SQL .
- Viết truy vấn SQL của bạn.
- Lưu nó dưới dạng tập dữ liệu mới.
Sử dụng tập dữ liệu này làm cơ sở để thêm mẫu.
Tạo tập dữ liệu ảo
Trong ảnh chụp màn hình ở trên, chúng tôi sử dụng truy vấn SQL để lấy dữ liệu về các giao dịch và nhân viên cho năm 2023.
Chỉnh sửa tập dữ liệu ảo
- Mở Bộ dữ liệu tab.
- Chọn một tập dữ liệu ảo.
- nhấp chuột Chỉnh sửa .
Cập nhật truy vấn SQL của bạn và thêm mẫu Jinja:
Ở ĐÂU {% if from_dttm is not none %} date_create >= from_iso8601_timestamp('{{ from_dttm }}') VÀ {% endif %} {% if to_dttm is not none %} date_create < from_iso8601_timestamp('{{ to_dttm }}') VÀ {% endif %} true;
Cách thức hoạt động:
-
{%if from_dttm không phải là không %} kiểm tra xem có ngày bắt đầu lọc hay không.
-
date_create >= from_iso8601_timestamp('{{ from_dttm }}') VÀ lọc dữ liệu để bao gồm các bản ghi có ngày tạo bắt đầu từ ngày bắt đầu được chỉ định.
-
{%endif %} hoàn tất việc kiểm tra ngày bắt đầu.
-
{%if to_dttm không phải là không %} kiểm tra xem có ngày kết thúc lọc hay không.
-
date_create < from_iso860i_timestamp('{{ to_dttm }}') VÀ lọc dữ liệu để bao gồm các bản ghi có ngày tạo trước ngày kết thúc được chỉ định.
-
{%endif %} hoàn thành việc kiểm tra ngày kết thúc.
-
đúng hỗ trợ hoạt động của truy vấn nếu không có ngày nào được chỉ định.
Biến mẫu làm cho truy vấn của bạn linh hoạt. Bạn có thể thay đổi phạm vi ngày bằng cách đặt giá trị cho
từ_dttm
và
to_dttm
. Bạn không cần phải chỉnh sửa chính truy vấn đó.
Các biến trong mẫu Jinja
| Biến | Mô tả |
|---|---|
| cổng_url |
Trả về URL tài khoản Bitrix24 nơi BI Builder chạy. Ví dụ:
CHỌN '{{portal_url()}}' dưới dạng chuỗi
hiển thị tài khoản trong trang tổng quan của bạn.
|
| cột | Đặt các cột được sử dụng để nhóm dữ liệu trong truy vấn. |
| bộ lọc | Áp dụng các bộ lọc cho tập dữ liệu. |
| từ_dttm và to_dttm | Xác định phạm vi thời gian cho dữ liệu. |
| theo nhóm | Lặp lại chức năng cột, nhóm dữ liệu theo các cột được chỉ định. |
| số liệu | Thêm các hàm tổng hợp, chẳng hạn như tổng hoặc trung bình. |
| hàng_limit và hàng_offset | Kiểm soát số lượng hàng cần trả về và bắt đầu từ đâu. |
| bảng_cột | Liệt kê tất cả các cột có sẵn trong tập dữ liệu. |
| cột thời gian và thời gian_hạt | Đặt trường thời gian và khoảng thời gian tổng hợp. |
Kiểm tra mẫu
- Mở tập dữ liệu.
- Tạo một biểu đồ.
- chọn Bản ghi thô như chế độ truy vấn.
- Di chuyển các chỉ số tới Cột phần.
- Đặt bộ lọc.
- nhấp chuột Tạo biểu đồ .
Để xem lại cách mẫu hoạt động trong truy vấn:
- Bấm vào dấu ba chấm ( ... ) thực đơn.
- chọn Xem truy vấn .
Biểu đồ sẽ phản ánh phạm vi ngày đã chọn. Truy vấn chỉ trả về dữ liệu trong khoảng thời gian đó.
Tóm lại
- Mẫu Jinja cho phép bạn tạo các truy vấn SQL động.
- Thêm mẫu bằng cách chỉnh sửa truy vấn SQL trong tập dữ liệu.
-
Sử dụng các biến như
từ_dttmvàto_dttmđể kiểm soát các bộ lọc mà không thay đổi truy vấn.
