Create a Transact-SQL Job Step

  • Article

S’applique à :SQL ServerAzure SQL Managed Instance

Important

Dans Azure SQL Managed Instance, la plupart, mais pas toutes les fonctionnalités SQL Server Agent sont actuellement prises en charge. Pour plus d’informations, consultez Différences T-SQL entre Azure SQL Managed Instance et SQL Server.

Cette rubrique indique comment créer une étape de travail de 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 même étape de travail Transact-SQL peut contenir plusieurs traitements et commandes GO incorporé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 Implémenter la sécurité de SQL Server Agent.

Utilisation de SQL Server Management Studio

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

  1. Dans l’Explorateur d'objets , connectez-vous à une instance du Moteur de base de données SQL Serveret développez-la.

  2. Développez SQL Server Agent, créez un travail ou cliquez avec le bouton droit de la souris sur un travail existant, puis cliquez sur Propriétés.

  3. Dans la boîte de dialogue Propriétés du travail , cliquez sur la page Étapes , puis sur Nouveau.

  4. Dans la boîte de dialogue Nouvelle étape du travail , tapez un nom d'étapede travail.

  5. Dans la liste Type , cliquez sur Script Transact-SQL (TSQL).

  6. Dans la zone Commande , tapez les traitements de commandes Transact-SQL ou cliquez sur Ouvrir pour sélectionner un fichier Transact-SQL à utiliser comme commande.

  7. Cliquez sur Analyser pour vérifier votre syntaxe.

  8. Le message « Analyse réussie » s'affiche si votre syntaxe est correcte. Si le système trouve une erreur, corrigez la syntaxe avant de continuer.

  9. Cliquez sur la page Avancé pour définir les options d'étape de travail, telles que l'action à exécuter lorsque l'étape de travail aboutit ou échoue, le nombre de tentatives d'exécution de l'étape de travail que doit effectuer l'Agent SQL Server et le fichier ou la table où SQL Server peut écrire la sortie de l'étape de travail. Seuls les membres du rôle de serveur fixe sysadmin peuvent écrire une sortie d'étape de travail dans un fichier du système d'exploitation. Tous les utilisateurs de SQL Server Agent peuvent consigner une sortie dans une table.

  10. Si vous êtes membre du rôle de serveur fixe sysadmin et voulez exécuter cette étape de travail avec une 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

  1. Dans l' Explorateur d'objets, connectez-vous à une instance du Moteur de base de données.

  2. Dans la barre d'outils standard, cliquez sur Nouvelle requête.

  3. 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 de SQL Server Management Objects

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

Utilisez la classe JobStep à l’aide du langage de programmation de votre choix, tel que Visual Basic, Visual C# ou PowerShell.