Programmes

La page Programmes affiche la liste des programmes créés.

Le menu Actions d'un programme comprend les options suivantes : Modifier, Supprimer, Activer ou Désactiver le programme et Afficher les détails du programme, y compris les dépendances de procédure et de procédure utilisées.

Description de l'image program_procedure_dependencies.png

• Créer ou modifier un programme
  Cette section explique comment créer ou modifier un programme Oracle Scheduler.

Créer ou modifier un programme

Cette section explique comment créer ou modifier un programme Oracle Scheduler.

Pour créer un programme, Database Actions utilise en interne la procédure DBMS_SCHEDULER.CREATE_PROGRAM.

1. Sur la page Programmes, en haut à droite, cliquez sur Créer un programme.
2. Dans Propriétés du programme, renseignez les champs suivants :

   Onglet Détails

   • Nom : nom du programme. Le nom doit être unique dans l'espace de noms SQL. Par exemple, un programme ne peut pas porter le même nom qu'une table dans un schéma.

   • Activé : si cette option est spécifiée, des vérifications de validité seront effectuées et le programme sera créé activé si toutes les vérifications réussissent. Si cette option n'est pas spécifiée, le programme n'est pas créé activé.

   • Description : chaîne de texte facultative pouvant être utilisée pour décrire le programme.

   • Type

     • Bloc PL/SQL : le programme est un bloc PL/SQL. Les arguments de travail ou de programme ne sont pas pris en charge lorsque le type de travail ou de programme est PLSQL_BLOCK. Dans ce cas, le nombre d'arguments doit être 0. Entrez ou collez le code PL/SQL complet ou modifiez le code existant.

     • Procédure stockée : le programme est une procédure stockée PL/SQL ou Java, ou un sous-programme C externe. Seules les procédures, et non les fonctions avec des valeurs de retour, sont prises en charge. Les procédures PL/SQL avec des arguments IN OUT ou OUT ne sont pas prises en charge.

       Schéma : schéma de la procédure stockée. S'il n'est pas indiqué, le schéma du travail est supposé.

       Procédure : nom de la procédure stockée.

       Arguments : pour chaque argument, nom, type de données, valeur par défaut, et s'il s'agit d'un argument d'entrée, de sortie ou d'entrée/sortie.

     • Script : le programme est un script SQL (instructions SQL*Plus), un script de sauvegarde (commandes RMAN) ou un script externe (commandes du système d'exploitation). Saisissez ou collez le texte du script dans le champ.

   Onglet Propriétés

   Permet de définir les propriétés du programme. Pour la plupart des propriétés, la valeur par défaut est NULL, mais vous pouvez cocher la case pour spécifier une valeur.

   • Détaché : activé si le programme est un travail détaché. Utilisez un travail détaché pour démarrer un script ou une application qui s'exécute dans un processus distinct, indépendamment et de manière asynchrone dans le planificateur. Un travail détaché démarre généralement un autre processus, puis s'arrête. A la sortie (lorsque l'action de travail est terminée), un travail détaché reste en cours d'exécution. L'état En cours d'exécution indique que le processus asynchrone que le travail a démarré est toujours actif. Une fois que le traitement asynchrone a terminé son travail, il doit se connecter à la base de données et appeler DBMS_SCHEDULER.END_DETACHED_JOB_RUN, ce qui met fin au travail.

   • Nombre maximal d'exécutions : nombre maximal d'exécutions avant que le programme ne soit marqué comme terminé.

   • Nombre maximal d'échecs : nombre maximal d'échecs tolérés avant que le programme ne soit marqué comme interrompu.

   • Durée d'exécution maximale : durée d'exécution maximale du programme.

   • Limite de programmation : délai maximum entre le début du travail planifié et le début réel avant l'annulation d'une exécution de programme.

3. Dans le panneau DDL, vous pouvez vérifier et enregistrer les instructions SQL générées.

   • Pour un nouveau programme, cliquez sur CREATE pour visualiser les instructions DDL générées.

   • Lorsque vous modifiez un programme, cliquez sur UPDATE pour afficher les instructions ALTER générées.

   Lorsque vous avez terminé, cliquez sur Appliquer.

4. Le panneau Sortie affiche les résultats des commandes DDL. En cas d'erreur, accédez au volet correspondant, corrigez les erreurs et réexécutez les commandes. Vous pouvez enregistrer dans un fichier texte ou effacer la sortie.