sys.sp_cdc_change_job (Transact-SQL)

Syntaxe

sys.sp_cdc_change_job [ [ @job_type = ] 'job_type' ]
        [ , [ @maxtrans = ] max_trans ] 
    [ , [ @maxscans = ] max_scans ] 
        [ , [ @continuous = ] continuous ] 
    [ , [ @pollinginterval = ] polling_interval ] 
    [ , [ @retention ] = retention ] 
        [ @threshold = ] 'delete threshold'

Arguments

• [ @job_type= ] 'job_type'
  Type de travail à modifier. job_type est de type nvarchar(20) avec la valeur par défaut 'capture'. Les entrées valides sont 'capture' et 'cleanup'.

• [ @maxtrans ] **=**max_trans
  Nombre maximal de transactions à traiter dans chaque cycle d'analyse. max_trans est de type int avec NULL comme valeur par défaut, qui n'indique aucune modification pour ce paramètre. Si elle est spécifiée, la valeur doit être un entier positif.

  max_trans est valide uniquement pour les travaux de capture.

• [ @maxscans ] **=**max_scans
  Nombre maximal de cycles d'analyse à exécuter afin d'extraire toutes les lignes du journal. max_scans est de type int avec NULL comme valeur par défaut, qui n'indique aucune modification pour ce paramètre.

  max_scan est valide uniquement pour les travaux de capture.

• [ @continuous ] **=**continuous
  Indique si le travail de capture doit s'exécuter continuellement (1) ou une seule fois (0). continuous est de type bit avec NULL comme valeur par défaut, qui n'indique aucune modification pour ce paramètre.

  Lorsque continuous = 1, le travail sp_cdc_scan analyse le journal et traite jusqu'à (max_trans * max_scans) transactions. Il attend alors pendant le nombre de secondes spécifié dans polling_interval avant de commencer l'analyse de journal suivante.

  Lorsque continuous = 0, le travail sp_cdc_scan exécute jusqu'à max_scans analyses du journal, en traitant un maximum de max_trans transactions pendant chaque analyse, puis se termine.

  Si la valeur de l'argument @continuous passe de 1 à 0, @pollinginterval prend automatiquement la valeur 0. Une valeur autre que 0 spécifiée pour @pollinginterval est ignorée.

  Si @continuous est omis ou a pour valeur explicite NULL et que @pollinginterval a pour valeur explicite un nombre supérieur à  0, @continuous prend automatiquement la valeur 1.

  continuous est valide uniquement pour les travaux de capture.

• [ @pollinginterval ] **=**polling_interval
  Nombre de secondes entre les cycles d'analyse du journal. polling_interval est de type bigint avec NULL comme valeur par défaut, qui n'indique aucune modification pour ce paramètre.

  polling_interval est valide uniquement pour les travaux de capture lorsque continuous a la valeur 1.

• [ @retention ] **=**retention
  Nombre de minutes pendant lesquelles les lignes modifiées doivent être conservées dans les tables de modifications. retention est de type bigint avec NULL comme valeur par défaut, qui n'indique aucune modification pour ce paramètre. La valeur maximale est égale à 52494800 (100 ans). Si elle est spécifiée, la valeur doit être un entier positif.

  retention est valide uniquement pour les travaux de nettoyage.

• [ @threshold= ] 'delete threshold'
  Nombre maximal d'entrées qui peuvent être supprimées à l'aide d'une instruction unique lors du nettoyage. delete threshold est de type bigint avec NULL comme valeur par défaut, qui n'indique aucune modification pour ce paramètre. delete threshold est valide uniquement pour les travaux de nettoyage.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Aucun

Notes

Si un paramètre est omis, la valeur associée dans la table dbo.cdc_jobs n'est pas mise à jour. Un paramètre qui a pour valeur explicite NULL est traité comme s'il était omis.

La spécification d'un paramètre qui n'est pas valide pour le type de travail provoquera l'échec de l'instruction.

Les modifications apportées à un travail n'entrent pas en vigueur tant que le travail n'est pas arrêté en utilisant sp_cdc_stop_job et redémarré en utilisant sp_cdc_start_job.

Autorisations

Nécessite l'appartenance au rôle de base de données fixe db_owner.

Exemples

A. Modification d'un travail de capture

USE AdventureWorks;
GO
EXECUTE sys.sp_cdc_change_job 
    @job_type = N'capture',
    @maxscans = 1000,
    @maxtrans = 15;
GO

B. Modification d'un travail de nettoyage

USE AdventureWorks;
GO
EXECUTE sys.sp_cdc_change_job 
    @job_type = N'cleanup',
    @retention = 2880;
GO

Voir aussi

Référence