Création d'une tâche SQL

Une tâche SQL du service d'intégration de données 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, voir 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 aider à démarrer. Pour créer un autre projet ou dossier, voir Projets et dossiers.

Dans le service d'intégration de données, vous pouvez avoir par défaut des exécutions de tâche simultanées ou parallèles à un moment donné. Pour interdire les exécutions de tâches concurrentes 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 ne sont pas autorisées, une demande d'exécution de tâche échoue s'il existe déjà une exécution de tâche en cours qui est à l'état non terminal.

    1. Dans la page Tâches du projet ou du dossier dans lequel vous voulez 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 d'un projet ou d'un dossier, voir Liste des tâches.
    2. Dans la page Créer une tâche SQL, entrez un nom et une description facultative.

      L'identificateur est une valeur générée par le système en fonction du nom. Vous pouvez modifier la valeur, mais après avoir créé et enregistré la tâche, vous ne pouvez pas 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 concurrentes de cette tâche.
    4. (Facultatif) Pour Projet ou dossier, cliquez sur Sélectionner et 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 continuer à créer et à modifier la tâche.

      • Créer et fermer : Crée et enregistre la tâche, ferme la page et vous ramène à la liste des tâches de la page des détails du projet ou du dossier.

    6. Enregistrez périodiquement pendant que vous travaillez en sélectionnant l'un des boutons suivants :
      • Enregistrer : Valide les modifications depuis le dernier enregistrement. Vous pouvez poursuivre la modification après l'enregistrement.

      • Enregistrer et fermer : Validation des modifications, fermeture de la page et retourne à la liste des tâches de la page des détails d'un projet ou d'un dossier.

      • Enregistrer sous : Valide les modifications (depuis le dernier enregistrement) et enregistre une copie, au lieu de remplacer la tâche courante. Vous pouvez indiquer un nom pour la copie et sélectionner un autre projet ou dossier pour celle-ci, ou l'enregistrer 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 que vous souhaitez utiliser est enregistrée.

      Dans la page Sélectionner SQL qui s'affiche, sélectionnez les types directement ou paramétrez les types de ressource uniquement dans l'ordre indiqué.

      1. Pour rechercher et sélectionner des types de ressource directement, cliquez sur Sélectionner à côté 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 contenant la procédure stockée.

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

          Pour voir les paramètres dans une procédure stockée avant de sélectionner la procédure :

          1. Dans le panneau Sélectionner une procédure stockée, sélectionnez Tout voir.
          2. Dans le panneau Rechercher une procédure stockée, recherchez la procédure stockée souhaitée et sélectionnez Voir les paramètres dans le menu Actions (Menu Actions) de cette procédure stockée.
      2. Pour affecter des paramètres aux types de ressource :
        1. Sélectionnez Affecter un paramètre à côté d'un type de ressource.

        2. Dans 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 s'affichent dans la liste pour sélection.

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

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

            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 voir les paramètres dans une procédure stockée avant de sélectionner la procédure. Sélectionnez Tout voir à côté du menu Procédure stockée. Dans le panneau Rechercher la procédure stockée qui s'affiche, recherchez la procédure stockée souhaitée et sélectionnez Voir les paramètres dans le menu Actions (Menu Actions) de cette procédure stockée.

            3. Sélectionnez Ajouter.

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

        3. Sélectionnez Affecter.
      3. Dans la page Select SQL (Sélectionner SQL), sélectionnez Done (Terminé).

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

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

      Le nombre de paramètres dans la procédure stockée est affiché à côté de Paramètres configurés. Seules les valeurs de paramètre d'entrée dans 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 pour ce paramètre. Par exemple, vous ne pouvez pas fournir une valeur STRING pour un paramètre d'entrée dont le type de données est NUMERIC.

      Dans 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 rangée de la valeur de paramètre d'entrée à configurer, sélectionnez Configurer.
      2. Dans le panneau Modifier le paramètre, entrez une valeur pour le paramètre d'entrée et sélectionnez 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.

      S'il y a des erreurs ou des avertissements, sélectionnez Voir les messages. Résoudre les erreurs avant de publier la tâche.

      Note

      L'exécution d'une tâche SQL échoue si les paramètres d'entrée du 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 (zero).
    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 dans une application du service d'intégration de données avant d'exécuter la tâche ou de programmer son exécution. Pour plus d'informations sur la publication, voir Publication dans une application d'intégration de données.
  • 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]

    Pour la liste complète des indicateurs et des options de variable pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

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