jobs.sp_add_job (trabajos elásticos de Azure) (Transact-SQL)

  • Artículo

Se aplica a:Azure SQL Database

Agrega un nuevo trabajo en el servicio Trabajos elásticos de Azure para Azure SQL Database.

Este procedimiento almacenado comparte el nombre de sp_add_job con un objeto similar en SQL Server para el servicio Agente SQL Server. Para obtener información sobre la versión de Agente SQL Server, consulte sp_add_job (Transact-SQL).

Convenciones de sintaxis de Transact-SQL

Sintaxis

[jobs].sp_add_job [ @job_name = ] 'job_name'  
  [ , [ @description = ] 'description' ]
  [ , [ @enabled = ] enabled ]
  [ , [ @schedule_interval_type = ] schedule_interval_type ]  
  [ , [ @schedule_interval_count = ] schedule_interval_count ]
  [ , [ @schedule_start_time = ] schedule_start_time ]
  [ , [ @schedule_end_time = ] schedule_end_time ]
  [ , [ @job_id = ] job_id OUTPUT ]

Argumentos

@job_name

Nombre del trabajo. El nombre debe ser único y no puede contener el carácter de porcentaje (%). job_name es nvarchar(128), sin ningún valor predeterminado.

@description

Descripción del trabajo. description es nvarchar(512), con un valor predeterminado de NULL. Si se omite la descripción , se usa una cadena vacía.

@enabled

Especifica si la programación del trabajo está habilitada. Habilitado es bit, con un valor predeterminado de 0 (deshabilitado). Si 0es , el trabajo no está habilitado y no se ejecuta según su programación; sin embargo, se puede ejecutar manualmente. Si 1es , el trabajo se ejecutará según su programación y también se puede ejecutar manualmente.

@schedule_interval_type

El valor indica cuándo se ejecutará el trabajo. schedule_interval_type es nvarchar(50), con un valor predeterminado de Oncey puede ser uno de los siguientes valores:

  • Once
  • Minutes
  • Hours
  • Days
  • Weeks
  • Months

@schedule_interval_count

Número de períodos de schedule_interval_count que se van a producir entre cada ejecución del trabajo. schedule_interval_count es int, con un valor predeterminado de 1. El valor debe ser mayor o igual que 1.

@schedule_start_time

Fecha en la que puede comenzar la ejecución del trabajo. schedule_start_time es DATETIME2, con el valor predeterminado 0001-01-01 00:00:00.0000000.

Todas las horas de los trabajos elásticos se encuentran en la zona horaria UTC.

@schedule_end_time

Fecha en la que puede detenerse la ejecución del trabajo. schedule_end_time es DATETIME2, con el valor predeterminado de 9999-12-31 11:59:59.00000000.

Todas las horas de los trabajos elásticos se encuentran en la zona horaria UTC.

@job_id

Número de identificación que se ha asignado al trabajo si este se ha creado correctamente. job_id es una variable de salida de tipo uniqueidentifier.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

El procedimiento jobs.sp_add_job almacenado debe ejecutarse desde la base de datos del agente de trabajo especificada al crear el agente de trabajo.

Después jobs.sp_add_job de ejecutarse para agregar un trabajo, se puede usar jobs.sp_add_jobstep para agregar pasos que realicen las actividades del trabajo. El número de versión inicial del trabajo es 0, que se incrementa a 1 cuando se agrega el primer paso.

Permisos

De forma predeterminada, los miembros del rol fijo de servidor sysadmin pueden ejecutar este procedimiento almacenado. Solo los miembros de sysadmin pueden usar este procedimiento almacenado para editar los atributos de los trabajos que pertenecen a otros usuarios.

Contenido relacionado