Sử dụng sp_help_schedule trong SQL Server

Trong SQL Server, sp_help_schedule thủ tục được lưu trữ trả về thông tin về lịch biểu trong SQL Server Agent.

Bài viết này cung cấp tổng quan về quy trình được lưu trữ này bao gồm các ví dụ.

Cú pháp

Cú pháp chính thức như sau:

sp_help_schedule   
     [ @schedule_id = ] id ,  
     [ @schedule_name = ] 'schedule_name'   
     [ , [ @attached_schedules_only = ] attached_schedules_only ]  
     [ , [ @include_description = ] include_description ]

Bạn có thể gọi sp_help_schedule , có hoặc không có tham số.

Khi bạn gọi nó mà không có bất kỳ tham số nào, nó sẽ trả về một danh sách tất cả các lịch trình trong phiên bản.

Khi bạn chuyển tên hoặc ID lịch biểu, nó chỉ trả về lịch biểu đó.

Lưu ý rằng sp_help_schedule nằm trong msdb cơ sở dữ liệu, vì vậy nó cần được chạy từ đó. Bạn có thể thực hiện việc này bằng cách chuyển sang msdb cơ sở dữ liệu (ví dụ:với USE msdb ), hoặc bằng cách xác định quy trình với tên cơ sở dữ liệu và giản đồ (tức là msdb.dbo.sp_help_schedule ).

Ví dụ

Dưới đây là một ví dụ để minh họa cách trả lại tất cả các lịch biểu trong trường hợp:

EXEC msdb.dbo.sp_help_schedule;

Kết quả:

Trả lại lịch biểu dựa trên tên của nó

Bạn cũng có thể nhận được một lịch biểu dựa trên tên của nó:

EXEC msdb.dbo.sp_help_schedule
	@schedule_name = 'Weekly_Sun_3AM';

Trả lại lịch biểu dựa trên ID của nó

Ngoài ra, bạn có thể nhận được một lịch biểu dựa trên ID của nó:

EXEC msdb.dbo.sp_help_schedule
	@schedule_id = 14;

Chỉ trả lại các lịch trình đính kèm

Mặc dù sp_help_schedule không trả về lịch biểu cho một công việc cụ thể (sử dụng sp_help_jobschedule cho điều đó), bạn có thể sử dụng nó để chỉ trả về những lịch biểu được đính kèm với một công việc.

Bạn có thể thực hiện việc này với @attached_schedules_only tham số.

@attached_schedules_only tham số là bit , với giá trị mặc định là 0 , có nghĩa là nó trả về cả lịch trình đính kèm và không đính kèm. Chuyển giá trị 1 giới hạn nó chỉ trong các lịch trình đính kèm.

Ví dụ:

EXEC sp_help_schedule
	@attached_schedules_only = 1;

Bao gồm mô tả

Một điều khác bạn có thể làm là chỉ định xem có đưa vào mô tả của lịch trình hay không.

Theo mặc định, mô tả không được bao gồm trong tập kết quả. Trên thực tế, schedule_description cột là bao gồm, nhưng nó không chứa mô tả, trừ khi bạn yêu cầu rõ ràng. Nếu bạn không yêu cầu, hãy schedule_description cột hiển thị (Description not requested.) .

@include_description tham số là bit , với giá trị mặc định là 0 , có nghĩa là nó không hiển thị mô tả. Chuyển giá trị 1 kết quả là mô tả được hiển thị.

EXEC sp_help_jobschedule
	@job_name = 'SqlAgentTest',
	@include_description = 1;