Créer une étape de travail Transact-SQL

Article
02/21/2025

s’applique à :SQL Server Azure SQL Managed Instance

Important

Sur Azure SQL Managed Instance, la plupart, mais pas toutes les fonctionnalités de SQL Server Agent sont actuellement prises en charge. Pour plus d’informations, consultez différences T-SQL d’Azure SQL Managed Instance par rapport à SQL Server.

Cette rubrique explique comment créer une étape de travail Microsoft SQL Server Agent qui exécute des scripts Transact-SQL dans SQL Server à l’aide de SQL Server Management Studio, Transact-SQL ou SQL Server Management Objects.

Ces scripts d’étape de travail peuvent appeler des procédures stockées et des procédures stockées étendues. Une seule étape de tâche Transact-SQL peut contenir plusieurs lots et commandes GO intégrées. Pour plus d’informations sur la création d’un travail, consultez Création de travaux.

Avant de commencer

Sécurité

Pour plus d’informations, consultez Sécurité SQL Server Agent.

Utilisation de SQL Server Management Studio

Pour créer une étape de tâche Transact-SQL

Dans l'Explorateur d’objets, connectez-vous à une instance du moteur de base de données SQL Server, puis développez cette instance.
Développez SQL Server Agent, créez une nouvelle tâche ou cliquez avec le bouton droit sur une tâche existante, puis cliquez sur Propriétés.
Dans la boîte de dialogue Propriétés du travail, cliquez sur l'onglet Étapes, puis sur Nouveau.
Dans la boîte de dialogue Nouvelle Étape de Tâche, tapez un nom d'étape .
Dans la liste Type, cliquez sur Transact-SQLscript (TSQL).
Dans la zone Commande, tapez les lots de commandes Transact-SQL, ou cliquez sur Ouvrir pour sélectionner un fichier Transact-SQL à utiliser comme commande.
Cliquez sur Parse pour contrôler votre syntaxe.
Le message « Analyse réussie » s’affiche lorsque votre syntaxe est correcte. Si une erreur est trouvée, corrigez la syntaxe avant de continuer.
Cliquez sur la page Avancé pour définir des options d’étape de travail, telles que : quelle action effectuer si l’étape de travail réussit ou échoue, combien de fois SQL Server Agent doit essayer d’exécuter l’étape de travail et le fichier ou la table où SQL Server Agent peut écrire la sortie de l’étape de travail. Seuls les membres du rôle de serveur fixe sysadmin peuvent écrire la sortie d'une étape de travail dans un fichier de système d’exploitation. Tous les utilisateurs de SQL Server Agent peuvent consigner la sortie dans une table.
Si vous êtes membre du rôle serveur fixe sysadmin et que vous souhaitez exécuter cette étape de travail en tant que connexion SQL différente, sélectionnez la connexion SQL dans la liste Exécuter en tant qu’utilisateur.

Utilisation de Transact-SQL

Pour créer une étape de travail Transact-SQL

Dans Explorateur d’objets, connectez-vous à une instance du moteur de base de données.
Dans la barre Standard, cliquez sur nouvelle requête.

Copiez et collez l’exemple suivant dans la fenêtre de requête, puis cliquez sur Exécuter.

-- creates a job step that uses Transact-SQL  
USE msdb;  
GO  
EXEC sp_add_jobstep  
    @job_name = N'Weekly Sales Data Backup',  
    @step_name = N'Set database to read only',  
    @subsystem = N'TSQL',  
    @command = N'ALTER DATABASE SALES SET READ_ONLY',   
    @retry_attempts = 5,  
    @retry_interval = 5 ;  
GO

Pour plus d’informations, consultez sp_add_jobstep (Transact-SQL).

Utilisation d’objets de gestion SQL Server

Pour créer une étape de travail Transact-SQL

Utilisez la classe JobStep à l’aide d’un langage de programmation que vous choisissez, tel que Visual Basic, Visual C# ou PowerShell.

Partager via