sp_adddynamicsnapshot_job (Transact-SQL)

Crea un trabajo de agente que genera una instantánea de datos filtrados para una publicación con filtros de fila con parámetros. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones. Lo utiliza el administrador para crear manualmente trabajos de instantáneas de datos filtrados para los suscriptores.

Nota

Para crear un trabajo de instantáneas de datos filtrados, antes debe existir un trabajo de instantáneas estándar para la publicación.

Para obtener más información, vea Instantáneas para publicaciones de combinación con filtros con parámetros.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_adddynamicsnapshot_job [ @publication = ] 'publication' 
    [ , [ @suser_sname = ] 'suser_sname' ] 
    [ , [ @host_name = ] 'host_name' ] 
    [ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' OUTPUT ] 
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' OUTPUT ] 
    [ , [ @frequency_type= ] frequency_type ]
    [ , [ @frequency_interval= ] frequency_interval ]
    [ , [ @frequency_subday= ] frequency_subday ]
    [ , [ @frequency_subday_interval= ] frequency_subday_interval ]
    [ , [ @frequency_relative_interval= ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor= ] frequency_recurrence_factor ]
    [ , [ @active_start_date= ] active_start_date ]
    [ , [ @active_end_date= ] active_end_date ]
    [ , [ @active_start_time_of_day= ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day= ] active_end_time_of_day ]

Argumentos

• [ @publication=] 'publication'
  Es el nombre de la publicación a la que se agrega el trabajo de instantáneas de datos filtrados. publication es de tipo sysname y no tiene ningún valor predeterminado.

• [ @suser_sname= ] 'suser_sname'
  Es el valor utilizado al crear una instantánea de datos filtrados para una suscripción filtrada con el valor de la función SUSER_SNAME en el suscriptor. suser_sname es de tipo sysname y no tiene ningún valor predeterminado. suser_sname debe ser NULL si esta función no se utiliza para filtrar dinámicamente la publicación.

• [ @host_name= ] 'host_name'
  Es el valor utilizado al crear una instantánea de datos filtrados para una suscripción filtrada con el valor de la función HOST_NAME en el suscriptor. host_name es de tipo sysname y no tiene ningún valor predeterminado. host_name debe ser NULL si esta función no se utiliza para filtrar dinámicamente la publicación.

• [ @dynamic_snapshot_jobname= ] 'dynamic_snapshot_jobname'
  Es el nombre del trabajo de instantáneas de datos filtrados creado. dynamic_snapshot_jobname es de tipo sysname, su valor predeterminado es NULL y es un parámetro OUTPUT opcional. Si se especifica, dynamic_snapshot_jobname debe tener como resultado un trabajo exclusivo en el distribuidor. Si no se especifica, se generará un nombre de trabajo automáticamente, el cual se devolverá al conjunto de resultados. Allí, el nombre se crea del siguiente modo:

  'dyn_' + <name of the standard snapshot job> + <GUID>
  

  Nota

  Al generar el nombre del trabajo de instantáneas dinámicas, es posible truncar el nombre del trabajo de instantáneas estándar.

• [ @dynamic_snapshot_jobid= ] 'dynamic_snapshot_jobid'
  Es un identificador para el trabajo de instantáneas de datos filtrados creado. dynamic_snapshot_jobid es de tipo uniqueidentifier, su valor predeterminado es NULL y es un parámetro OUTPUT opcional.

• [ @frequency_type=] frequency_type
  Es la frecuencia con que se programa el trabajo de instantáneas de datos filtrados. frequency_type es de tipo int y puede tener uno de estos valores.

  Valor	Descripción
  1	Una vez
  2	A petición
  4 (predeterminado)	Diariamente
  8	Semanalmente
  16	Mensualmente
  32	Mensualmente relativa
  64	Iniciar automáticamente
  128	Periódica

• [ @frequency_interval = ] frequency_interval
  Es el período (medido en días) durante el que se ejecuta el trabajo de instantáneas de datos filtrados. frequency_interval es de tipo int, su valor predeterminado es 1 y depende del valor de frequency_type.

  Valor de frequency_type	Efecto en frequency_interval
  1	frequency_interval no se utiliza.
  4 (predeterminado)	Cada frequency_interval días, con un valor predeterminado de "diariamente".
  8	frequency_interval es uno o más de los siguientes (combinados con un operador lógico | (OR bit a bit) (Transact-SQL)): 1 = Domingo | 2 = Lunes | 4 = Martes | 8 = Miércoles | 16 = Jueves | 32 = Viernes | 64 = Sábado
  16	En el día frequency_interval del mes.
  32	frequency_interval es uno de los siguientes: 1 = Domingo | 2 = Lunes | 3 = Martes | 4 = Miércoles | 5 = Jueves | 6 = Viernes | 7 = Sábado | 8 = Día | 9 = Día de la semana | 10 = Día del fin de semana
  64	frequency_interval no se utiliza.
  128	frequency_interval no se utiliza.

• [ @frequency_subday=] frequency_subday
  Especifica las unidades de frequency_subday_interval. frequency_subday es de tipo int y puede tener uno de estos valores.

  Valor	Descripción
  1	Una vez
  2	Segundo
  4 (predeterminado)	Minute
  8	Hour

• [ @frequency_subday_interval=] frequency_subday_interval
  Es el número de períodos de frequency_subday que pueden sucederse entre ejecuciones del trabajo. frequency_subday_interval es de tipo int y su valor predeterminado es 5.

• [ @frequency_relative_interval=] frequency_relative_interval
  Es la repetición del trabajo de instantáneas de datos filtrados en cada mes. Este parámetro se utiliza cuando frequency_type se establece en 32 (mensualmente relativa). frequency_relative_interval es de tipo int y puede tener uno de estos valores.

  Valor	Descripción
  1 (predeterminado)	Primero
  2	Segundo
  4	Tercero
  8	Cuarto
  16	Último

• [ @frequency_recurrence_factor=] frequency_recurrence_factor
  Es el factor de repetición utilizado en frequency_type. frequency_recurrence_factor es de tipo int y su valor predeterminado es 0.

• [ @active_start_date=] active_start_date
  Es la fecha en que el trabajo de instantáneas de datos filtrados se programa por primera vez, con el formato AAAAMMDD. active_start_date es de tipo int y su valor predeterminado es NULL.

• [ @active_end_date=] active_end_date
  Es la fecha en que el trabajo de instantáneas de datos filtrados deja de estar programado, con el formato AAAAMMDD. active_end_date es de tipo int y su valor predeterminado es NULL.

• [ @active_start_time_of_day=] active_start_time_of_day
  Es la hora en que el trabajo de instantáneas de datos filtrados se programa por primera vez, con el formato HHMMSS. active_start_time_of_day es de tipo int y su valor predeterminado es NULL.

• [ @active_end_time_of_day=] active_end_time_of_day
  Es la hora en que el trabajo de instantáneas de datos filtrados deja de estar programado, con el formato HHMMSS. active_end_time_of_day es de tipo int y su valor predeterminado es NULL.

Conjunto de resultados

Nombre de la columna	Tipo de datos	Descripción
id	int	Identifica el trabajo de instantánea de datos filtrados en la tabla del sistema MSdynamicsnapshotjobs.
dynamic_snapshot_jobname	sysname	Nombre del trabajo de instantáneas de datos filtrados.
dynamic_snapshot_jobid	uniqueidentifier	Identifica de forma única el trabajo del Agente Microsoft SQL Server en el distribuidor.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_adddynamicsnapshot_job se utiliza en la replicación de mezcla para publicaciones que utilizan un filtro con parámetros.

Ejemplo

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

--Add a new merge publication.
DECLARE @publicationdb AS sysname;
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @filter AS sysname;
DECLARE @schema_hr AS sysname;
DECLARE @schema_sales AS sysname;

SET @publicationdb = N'AdventureWorks2012';
SET @publication = N'AdvWorksSalesPersonMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesPerson';
SET @filter = N'SalesPerson_Employee';
SET @schema_hr = N'HumanResources';
SET @schema_sales = N'Sales';

USE [AdventureWorks2012];

-- Enable AdventureWorks2012 for merge replication.
EXEC sp_replicationdboption
  @dbname = @publicationdb,
  @optname = N'merge publish',
  @value = N'true';  

-- Create new merge publication.  
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication of AdventureWorks2012.', 
  @allow_subscriber_initiated_snapshot = N'false';

-- Create a new snapshot job for the publication, using the 
-- default schedule. Pass credentials at runtime using 
-- sqlcmd scripting variables.
EXEC sp_addpublication_snapshot 
  @publication = @publication, 
  @job_login = $(Login), 
  @job_password = $(password);

-- Add an article for the Employee table, 
-- which is horizontally partitioned using 
-- a parameterized row filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_owner = @schema_hr, 
  @source_object = @table1, 
  @type = N'table', 
  @description = 'contains employee information', 
  @subset_filterclause = N'[LoginID] = HOST_NAME()';

-- Add an article for the SalesPerson table, 
-- which is partitioned based on a join filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_owner = @schema_sales, 
  @source_object = @table2, 
  @type = N'table', 
  @description = 'contains customer information';

-- Add a join filter between the two articles.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table1, 
  @filtername = @filter, 
  @join_articlename = @table2, 
  @join_filterclause = N'[Employee].[BusinessEntityID] = [SalesPerson].[SalesPersonID]', 
  @join_unique_key = 1, 
  @filter_type = 1;
GO

-- Start the snapshot agent job.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesPersonMerge';

EXEC sp_startpublication_snapshot 
  @publication = @publication;
GO

PRINT '*** Waiting for the initial snapshot.';
GO

-- Create a temporary table to store the filtered data snapshot 
-- job information.
CREATE TABLE #temp (id int,
    job_name sysname,
    job_id uniqueidentifier,
    dynamic_filter_login sysname NULL,
    dynamic_filter_hostname sysname NULL,
    dynamic_snapshot_location nvarchar(255),
    frequency_type int, 
    frequency_interval int, 
    frequency_subday_type int,
    frequency_subday_interval int, 
    frequency_relative_interval int, 
    frequency_recurrence_factor int, 
    active_start_date int, 
    active_end_date int, 
    active_start_time int, 
    active_end_time int
)

-- Create each snapshot for a partition 
-- The initial snapshot must already be generated.
DECLARE @publication AS sysname;
DECLARE @jobname AS sysname
DECLARE @hostname AS sysname
SET @publication = N'AdvWorksSalesPersonMerge';
SET @hostname = N'adventure-works\Fernando';

WHILE NOT EXISTS(SELECT * FROM sysmergepublications 
    WHERE [name] = @publication 
    AND snapshot_ready = 1)
BEGIN
    WAITFOR DELAY '00:00:05'
END

-- Create a data partition by overriding HOST_NAME().
EXEC sp_addmergepartition 
  @publication = @publication,
  @host_name = @hostname;

-- Create the filtered data snapshot job, and use the returned 
-- information to start the job.
EXEC sp_adddynamicsnapshot_job 
  @publication = @publication,
  @host_name = @hostname;

INSERT INTO #temp (id, job_name, job_id, dynamic_filter_login,
    dynamic_filter_hostname, dynamic_snapshot_location,
    frequency_type, frequency_interval, frequency_subday_type,
    frequency_subday_interval, frequency_relative_interval, 
    frequency_recurrence_factor, active_start_date, active_end_date, 
    active_start_time,active_end_time)
EXEC sp_helpdynamicsnapshot_job;

SELECT @jobname = (SELECT DISTINCT job_name FROM #temp WHERE dynamic_filter_hostname = @hostname);

EXEC msdb..sp_start_job @job_name = @jobname;
DROP TABLE #temp;
GO

Permisos

Solo los miembros del rol fijo de servidor sysadmin o del rol fijo de base de datos db_owner pueden ejecutar sp_adddynamicsnapshot_job.

Vea también

Referencia

sp_dropdynamicsnapshot_job (Transact-SQL)

sp_helpdynamicsnapshot_job (Transact-SQL)

Conceptos

Crear una instantánea para una publicación de mezcla con filtros con parámetros

Filtros de fila con parámetros