Quyền và quy tắc nhập liệu của Janitor

Trang này liệt kê quyền cần cho từng thao tác của Janitor và các quy tắc Janitor kiểm tra khi bạn lưu một giá trị. Dùng trang này để tra một thông báo lỗi hoặc lên kế hoạch cấp quyền cho nhóm.

Quyền

Janitor dùng hai quyền. Admin cấp các quyền này qua role trên portal. Xem Role và quyền trên portal.

Thao tác	maintenance:read	maintenance:manage
Xem job, lượt chạy, chi tiết bước và thiết lập	Có	Có
Kiểm tra lượt chạy bằng Dry run	Có	Có
Tạo job, hoặc tạo job hàng loạt	—	Có
Đổi lịch chạy hoặc tùy chọn của job	—	Có
Vô hiệu hóa hoặc bật lại job, xóa job	—	Có
Bắt đầu lượt chạy bằng Run	—	Có
Reset state	—	Có
Stop run	—	Có
Đổi thiết lập	—	Có
Tạm dừng hoặc tiếp tục toàn bộ việc bảo trì	—	Có

Dry run chỉ cần quyền maintenance:read, vì thao tác này không bắt đầu lượt chạy và không thay đổi gì.

ORPHAN CLEANUP không cần phê duyệt thêm. Bất kỳ ai có quyền maintenance:manage đều bật được tùy chọn này.

Quy tắc nhập liệu

Janitor từ chối giá trị nằm ngoài các khoảng dưới đây. Quy tắc thời gian lưu giữ áp dụng như nhau cho thiết lập và cho từng job.

Trường	Vị trí	Tối thiểu	Tối đa
Max concurrent runs	Settings → Concurrency	1	100
Max concurrent runs per catalog	Settings → Concurrency	1	Giá trị của Max concurrent runs
Max manual runs	Settings → Concurrency	1	Giá trị của Max concurrent runs
Max concurrents start	Settings → Concurrency	1	Giá trị của Max concurrent runs
Schedule checker (s)	Settings → Schedule	10	3.600
Query timeout (s)	Settings → Schedule	30	3.600
Snapshot retention (days)	Settings và từng job	7	365
Orphan retention (days)	Settings và từng job	7	365

Ví dụ, khi Max concurrent runs là 5, ba giới hạn còn lại có thể từ 1 đến 5.

Các quy tắc khác:

• Khi đã đặt khung giờ bảo trì, lượt chạy kế tiếp theo lịch của job phải nằm trong khung đó. Khung giờ có thể vắt qua nửa đêm, ví dụ 22:00 đến 06:00.
• Exclude table patterns là biểu thức chính quy và không phân biệt chữ hoa, chữ thường.

Giá trị mặc định

Thiết lập	Mặc định
Max concurrent runs	1
Max concurrents start	1
OPTIMIZE	Bật
EXPIRE SNAPSHOTS	Bật, lưu giữ 7 ngày
ORPHAN CLEANUP	Tắt, lưu giữ 7 ngày

Thông báo

Lỗi

Khi thấy một trong các thông báo này, Janitor không lưu thay đổi.

Thông báo	Cách xử lý
max_concurrent_runs_per_catalog must not exceed max_concurrent_runs ({value})	Giảm Max concurrent runs per catalog, hoặc tăng Max concurrent runs.
max_manual_runs must not exceed max_concurrent_runs ({value})	Giảm Max manual runs, hoặc tăng Max concurrent runs.
max_jobs_started_per_tick must not exceed max_concurrent_runs ({value})	Giảm Max concurrents start, hoặc tăng Max concurrent runs.
Snapshot retention must be at least 7 days. Setting a shorter period may cause maintenance operations to behave unexpectedly.	Chọn 7 ngày trở lên.
Orphan file retention must be at least 7 days. Setting a shorter period may cause maintenance operations to behave unexpectedly.	Chọn 7 ngày trở lên.
The scheduled time derived from the cron expression falls outside the configured maintenance window ({start} – {end}). Please adjust the cron or contact your Platform Admin.	Chọn giờ trong khung, hoặc liên hệ Admin để đổi khung giờ.

Cảnh báo

Janitor vẫn lưu thay đổi nhưng hiện cảnh báo này.

Thông báo	Ý nghĩa
Orphan file retention is shorter than snapshot retention. Files referenced by unexpired snapshots may be incorrectly removed.	ORPHAN CLEANUP có thể xóa các file mà một snapshot còn giữ vẫn đang dùng. Đặt Orphan retention (days) ít nhất bằng Snapshot retention (days).

Thông báo của lượt chạy

Thông báo	Ý nghĩa
Maintenance is globally paused	Toàn bộ việc bảo trì đang tạm dừng. Run bị từ chối cho đến khi có người tiếp tục bảo trì.
Run is not cancellable	Lượt chạy đã kết thúc nên không dừng được.
Cancelled by operator	Có người đã dừng lượt chạy, hoặc lượt chạy bị dừng do tạm dừng emergency.
Cleared by operator	Có người đã dùng Reset state trên job.

Bước tiếp theo

• Tổng quan Janitor.