Skip to content

sys-sp-cdc-start-job-transact-sql.md

Latest commit

 

History

History
87 lines (60 loc) · 2.16 KB

sys-sp-cdc-start-job-transact-sql.md

File metadata and controls

87 lines (60 loc) · 2.16 KB
title sys.sp_cdc_start_job (Transact-SQL)
description Starts a change data capture cleanup or capture job for the current database.
author markingmyname
ms.author maghan
ms.reviewer randolphwest
ms.date 06/23/2025
ms.service sql
ms.subservice system-objects
ms.topic reference
f1_keywords
sp_cdc_start_job
sp_cdc_start_job_TSQL
sys.sp_cdc_start_job_TSQL
sys.sp_cdc_start_job
helpviewer_keywords
sp_cdc_start_job
dev_langs
TSQL

sys.sp_cdc_start_job (Transact-SQL)

[!INCLUDE SQL Server]

Starts a change data capture cleanup or capture job for the current database.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

sys.sp_cdc_start_job
    [ [ @job_type = ] N'job_type' ]
[ ; ]

Arguments

[ @job_type = ] N'job_type'

Type of job to add. @job_type is nvarchar(20) with a default of capture. Valid inputs are capture and cleanup.

Return code values

0 (success) or 1 (failure).

Result set

None.

Remarks

sys.sp_cdc_start_job can be used by an administrator to explicitly start either the capture job or the cleanup job.

Permissions

Requires membership in the db_owner fixed database role.

Examples

A. Start a capture job

The following example starts the capture job for the [!INCLUDE sssampledbobject-md] database. Specifying a value for @job_type isn't required because the default job type is capture.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_start_job;
GO

B. Start a cleanup job

The following example starts a cleanup job for the [!INCLUDE sssampledbobject-md] database.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_start_job @job_type = N'cleanup';

Related content