Documentation Oracle Cloud Infrastructure

Création d'une tâche SQL

Une tâche SQL dans Data Integration est associée à une procédure stockée dans une base de données.

La base de données doit être associée à une ressource de données déjà créée dans l'espace de travail. Pour créer une ressource de données, reportez-vous à Création d'une ressource de données.

Créez une tâche SQL dans un projet ou un dossier. Data Integration inclut un projet par défaut pour vous lancer. Pour créer un autre projet ou dossier, reportez-vous à la rubrique Projets et dossiers.

Dans Data Integration, par défaut, vous pouvez avoir des exécutions de tâche simultanées ou parallèles d'une tâche à un moment donné. Pour interdire les exécutions de tâche simultanées lancées manuellement, cochez la case Désactiver l'exécution simultanée de la tâche lorsque vous créez la tâche. Lorsque les exécutions de tâche simultanées sont interdites, une demande d'exécution pour la tâche échoue si une exécution de tâche en cours est déjà dans un état non terminal.

    1. Sur la page Tâches du projet ou du dossier dans lequel créer une tâche, sélectionnez Créer une tâche, puis SQL. Si vous avez besoin d'aide pour trouver la page Tâches dans un projet ou un dossier, reportez-vous à Liste des tâches.
    2. Sur la page Créer une tâche SQL, entrez un nom et, éventuellement, une description.

      L'identificateur est une valeur générée par le système en fonction du nom. Vous pouvez modifier la valeur, mais une fois que vous avez créé et enregistré la tâche, vous ne pouvez plus mettre à jour l'identificateur.

    3. Cochez la case Désactiver l'exécution simultanée de la tâche si vous souhaitez interdire les exécutions simultanées de cette tâche.
    4. (Facultatif) Dans Projet ou dossier, cliquez sur Sélectionner, puis sélectionnez un autre projet ou dossier dans lequel enregistrer la tâche.
    5. Pour enregistrer la tâche pour la première fois, sélectionnez l'un des boutons suivants :

      • Créer : crée et enregistre la tâche. Vous pouvez poursuivre la création et la modification de la tâche.

      • Créer et fermer : permet de créer et d'enregistrer la tâche, de fermer la page et de revenir à la liste des tâches sur la page des détails du projet ou du dossier.

    6. Enregistrez régulièrement pendant que vous travaillez en sélectionnant l'un des boutons suivants :

      • Enregistrer : valide les modifications apportées depuis le dernier enregistrement. Vous pouvez poursuivre la modification après l'enregistrement.

      • Enregistrer et fermer : valide les modifications, ferme la page et retourne à la liste des tâches sur la page des détails du projet ou du dossier.

      • Enregistrer sous : valide les modifications (depuis le dernier enregistrement) et les enregistre dans une copie au lieu d'écraser la tâche en cours. Vous pouvez fournir un nom pour la copie et sélectionner un autre projet ou dossier pour la copie, ou enregistrer la copie dans le même projet ou dossier que la tâche existante.

    7. Dans la section SQL, cliquez sur Sélectionner et sélectionnez la ressource de données associée à la base de données dans laquelle la procédure stockée à utiliser est enregistrée.

      Sur la page Sélectionner SQL qui apparaît, sélectionnez les types directement ou paramétrez les types de ressource uniquement dans l'ordre dans lequel ils apparaissent.

      1. Pour rechercher et sélectionner directement des types de ressource, cliquez sur Sélectionner en regard d'un type lorsqu'il est disponible pour sélection.

        • Ressource de données : nom de la ressource de données.

        • Connexion : connexion à utiliser pour accéder à la base de données associée à la ressource de données.

        • Schéma : schéma propriétaire de la procédure stockée.

        • Procédure stockée : nom de la procédure stockée à utiliser pour cette tâche SQL.

          Pour afficher les paramètres d'une procédure stockée avant de sélectionner la procédure :

          1. Dans le panneau Sélectionner une procédure enregistrée, sélectionnez Afficher tout.
          2. Dans le panneau Rechercher une procédure stockée, recherchez la procédure stockée souhaitée et sélectionnez Visualiser les paramètres dans le menu Actions (Menu Actions) de cette procédure.
      2. Pour affecter des paramètres aux types de ressource :

        1. Sélectionnez Affecter un paramètre en regard d'un type de ressource.

        2. Sur la page Affecter un paramètre, effectuez l'une des actions suivantes :

          • Sélectionnez un paramètre dans la liste. Seuls les paramètres du même type de ressource apparaissent dans la liste pour sélection.

          • Sélectionnez Ajouter paramètre pour ajouter un paramètre pour le type de ressource.

            1. Dans le panneau Ajouter un paramètre, entrez un identificateur et éventuellement une description.

            2. Définissez la valeur par défaut du paramètre pour le type de ressource.

              Pour le type de procédure stockée, vous pouvez afficher les paramètres d'une procédure stockée avant de la sélectionner. Sélectionnez Tout afficher en regard du menu Procédure stockée. Dans le panneau d'exploration de la procédure stockée qui apparaît, localisez la procédure stockée souhaitée et sélectionnez Afficher les paramètres dans le menu Actions (Menu Actions) de cette procédure stockée.

            3. Choisissez Ajouter.

              Le paramètre de type de ressource ajouté est automatiquement sélectionné sur la page Affecter un paramètre.

        3. Sélectionnez Affecter.
      3. Sur la page Sélectionner SQL, sélectionnez Terminé.

        Vous revenez à la page Créer une tâche SQL.

    8. Dans la section Configurer les paramètres, sélectionnez Configurer pour consulter la liste des paramètres et configurer leurs valeurs.

      Le nombre de paramètres de la procédure stockée est affiché en regard de Paramètres configurés. Seules les valeurs de paramètre d'entrée de la procédure stockée peuvent être configurées.

      La valeur configurée d'un paramètre d'entrée doit correspondre au type de données défini de ce paramètre. Par exemple, vous ne pouvez pas fournir de valeur STRING pour un paramètre d'entrée dont le type de données est NUMERIC.

      Sur la page Configurer les paramètres de procédure stockée, configurez une valeur de paramètre en procédant comme suit :

      1. Sur la ligne de la valeur de paramètre d'entrée à configurer, sélectionnez Configurer.
      2. Dans le panneau Modifier un paramètre, entrez une valeur pour le paramètre d'entrée et cliquez sur Enregistrer.

        Après avoir configuré un paramètre d'entrée, vous pouvez modifier ou effacer la valeur.

      3. Lorsque vous avez terminé la configuration des paramètres d'entrée, sélectionnez Configurer.
    9. (Facultatif) Dans la section Valider la tâche, sélectionnez Valider pour vérifier les valeurs de paramètre configurées.

      En cas d'erreurs ou d'avertissements, sélectionnez Afficher les messages. Corrigez toutes les erreurs avant de publier la tâche.

      Remarque

      L'exécution d'une tâche SQL échoue si les paramètres d'entrée de type de données NUMERIC ont NULL comme valeurs par défaut configurées. Pour éviter les échecs d'exécution de tâche, remplacez la valeur NULL par 0 (zéro).
    10. Lorsque vous avez terminé la configuration de la tâche, sélectionnez Créer et fermer ou Enregistrer et fermer.
    Publiez la tâche SQL vers une application dans Data Integration avant d'exécuter la tâche ou de programmer son exécution. Pour plus d'informations sur la publication, reportez-vous à Publication vers une application Data Integration.

  • Utilisez la commande oci data-integration task create-task-from-SQL-task et les paramètres requis pour créer une tâche SQL :

    oci data-integration task create-task-from-sql-task [OPTIONS]

    Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.

  • Exécutez l'opération CreateTask avec le sous-type de ressource approprié pour créer une tâche SQL.