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 la procédure DBMS_SCHEDULER.CREATE_PROGRAM en interne.

  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 indiquée, des vérifications de validité sont effectuées et le programme est créé activé si toutes les vérifications réussissent. Si cette option n'est pas spécifiée, le programme n'est pas 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 égal à 0. Saisissez 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 renvoyées, 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 avec le planificateur. Un travail détaché démarre généralement un autre processus, puis s'arrête. Lors de la sortie (lorsque l'action de travail est terminée), un travail détaché reste en cours d'exécution. L'état d'exécution indique que le processus asynchrone démarré par le travail est toujours actif. Lorsque le processus asynchrone termine 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 étant interrompu.

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

    • Limite de programmation : délai maximal 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 afin de 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 LDD. 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.