Créer un job

La fonction Travaux automatise les étapes qui ont été effectuées dans la section des prérequis.

Voici un exemple étape par étape de création d'un travail à l'aide de la fonctionnalité Travaux.

Sur la fonctionnalité Travaux de l'outil Data Studio, sélectionnez Créer un travail.

Description de l'image create-job-general.png
Dans l'assistant Créer un travail, dans les paramètres généraux, indiquez les valeurs de champ suivantes :
- Nom du job : entrez le nom du job. Par exemple, MOI NOUVEAU JOB.
- Description du travail : entrez la description. Ce champ est facultatif.
  Cliquez sur Suivant pour accéder à l'onglet Etapes.
Ajouter des étapes
Dans l'onglet Etapes, vous allez ajouter les étapes permettant d'automatiser votre processus.

Vous allez ajouter l'étape de chargement de données, ajouter la recette d'aide à l'IA de table que vous avez créée, exécuter une procédure PL/SQL et exécuter un appel REST en tant qu'étapes de votre travail.
Remarque

Vous avez déjà défini les tâches dans la section Prérequis.

description de l'illustration add-steps.png,
Etape Ajouter un chargement de données :
- Dans la liste déroulante Etape +Add, sélectionnez Ajouter un chargement de données.
- Indiquez les valeurs de champ suivantes dans la boîte de dialogue Ajouter un chargement de données :
  Sélectionner un chargement de données : sélectionnez le chargement de données dans la liste déroulante. Dans cet exemple, il s'agit de DATA_LOAD.
  
  Nom du chargement : entrez le nom du chargement. Ce champ sera automatiquement rempli. Il s'agit du nom utilisé pour marquer votre chargement.
  
  Sélectionnez Arrêter le travail sur les erreurs.
  Cliquez sur Ajouter un chargement de données.
  
  description de l'illustration add-data-load.png,
  
  Votre nouvelle étape apparaîtra dans la liste des étapes de votre travail. Cliquez sur l'icône en forme de crayon en regard de l'étape pour la modifier. Cliquez sur l'icône Supprimer en regard de l'étape pour enlever l'étape sélectionnée.
Ajouter une recette d'assistance IA de table:
- Dans la liste déroulante Etape +Add, sélectionnez Ajouter une recette d'assistance IA de table.
- Spécifiez les valeurs de champ suivantes dans la boîte de dialogue Recette d'assistance IA de table :
  Sélectionner une recette d'assistance IA de table : sélectionnez la recette que vous créez dans la liste déroulante.
  
  Sélectionnez Arrêter le travail sur les erreurs.
  
  Cliquez sur Ajouter une recette d'assistance AI de table.
  
  Description de l'illustration add-table-recipe.png,
  
  Cette nouvelle étape est ajoutée à la liste des étapes, sous l'étape de chargement de données existante. Cliquez sur l'icône en forme de crayon en regard de l'étape pour la modifier. Cliquez sur l'icône de suppression en regard de l'étape pour supprimer l'étape sélectionnée.
Ajouter une procédure
- Dans la liste déroulante + Ajouter une étape de l'onglet Etapes, sélectionnez Ajouter une procédure.
- Indiquez les valeurs de champ suivantes dans la boîte de dialogue Ajouter une procédure :
  Procédure PL/SQL : sélectionnez l'une des procédures PL/SQL que vous créez dans la liste déroulante. Dans cet exemple, vous sélectionnez Imprimer l'informatique.
  
  Arguments de procédure PL/SQL : indiquez une liste d'arguments délimitée par des virgules dans ce champ. Les valeurs que vous spécifiez dans ce champ seront transmises aux paramètres réels à la procédure acceptant les valeurs par défaut pour tous les paramètres que vous omettez. Ces arguments sont transmis à la procédure PL/SQL. Vos arguments peuvent être des nombres, des chaînes, des valeurs booléennes ou l'une des valeurs spéciales commençant par $. Dans ce cas, $job_name sera remplacé par My New Job lors de l'appel de la procédure.
  
  Par exemple, pour remplacer $job_name par PLSQL_JOB dans la sortie, vous devez transmettre le paramètre PLSQL_JOB dans ce champ.
  
  Sélectionnez Arrêter le travail sur les erreurs.
  
  Cliquez sur Ajouter une procédure.
  
  description de l'illustration add-procedure.png,
Ajouter un appel REST:
- Dans la liste déroulante Etape +Add, sélectionnez Ajouter un appel REST.
  Remarque
  
  Vous pouvez utiliser des appels REST pour effectuer diverses opérations. Il peut s'agir de vos propres applications personnalisées, de votre fournisseur cloud ou d'autres fournisseurs tiers. Par exemple, Oracle Cloud Infrastructure (OCI) fournit une variété d'adresses, détaillées à l'adresse suivante : https://docs.oracle.com/en-us/iaas/api/. Il convient de noter que cette portée n'est pas limitée uniquement à OCI.
  
  Dans cet exemple, vous allez appeler les appels REST de banque d'objets d'OCI pour accéder à leur adresse qui lit un fichier à partir de la banque d'objets.
- Indiquez les valeurs de champ suivantes dans la boîte de dialogue Ajouter REST pour configurer une étape de travail :
  Méthode : GET.
  
  Cette méthode extrait les données de la base de données Oracle. La méthode GET est utilisée pour extraire des données, telles que des lignes d'une table ou le résultat d'une requête. Elle ne modifie aucune donnée.
  Vous pouvez sélectionner l'une des méthodes suivantes en fonction de l'opération à effectuer :
  - POST :
    Cette méthode insère de nouvelles données ou appelle un processus qui modifie les données. Il soumet les données à la base de données Oracle, généralement pour créer de nouveaux enregistrements ou exécuter des procédures qui modifient les données.
  - SUPPRIMER :
    Supprime les données de la base de données Oracle. Cette méthode supprime les ressources spécifiées, telles que les lignes d'une table, identifiées par des paramètres ou des variables de chemin.
  - PATCH : met partiellement à jour les données existantes. Cette méthode applique des modifications partielles à une ressource, telles que la mise à jour de colonnes spécifiques d'une ligne sans remplacer l'enregistrement entier.
  URL : indique l'emplacement de stockage d'objet du service REST auquel vous souhaitez accéder, en dirigeant votre demande vers la ressource appropriée sur le serveur. Dans cet exemple, entrez https://objectstorage.us-ashburn-1.oraclecloud.com/n/*********/*/***/*/**/****.csv.
  
  Informations d'identification : sélectionnez l'une des informations d'identification pour authentifier votre demande, en vous assurant que vous êtes autorisé à accéder aux ressources d'API REST en toute sécurité.
  Remarque
  
  Aucune information d'identification sélectionnée dans cet exemple, car l'URL est un bucket public.
  
  Corps : ce champ spécifie les données envoyées au serveur, généralement dans les demandes POST ou PUT. Les demandes GET et DELETE n'ont pas de corps conformément aux normes HTTP.
  
  En-têtes : les en-têtes doivent être fournis en tant qu'objet JSON dans lequel chaque paire clé/valeur de l'objet JSON est utilisée en tant qu'en-tête et valeur dans la demande. Par exemple, {"X-My-Header": "My header value"}. Ce champ spécifie des informations supplémentaires sur la demande ou le client vers le serveur. Ces en-têtes peuvent spécifier des métadonnées telles que le type de contenu, les informations d'identification d'autorisation, les paramètres personnalisés et d'autres informations de contrôle nécessaires au traitement de la demande. Les en-têtes sont généralement utilisés dans les méthodes PUT, PATCH, POST et DELETE pour transmettre ces détails.
  
  Sélectionnez Arrêter le travail sur les erreurs.
  
  Cliquez sur Ajouter une étape.
  
  description de l'illustration add-rest-call.png,
  
  Remarque
  
  Vous pouvez visualiser la sortie de cette étape dans le menu Rapport. Il affiche le contenu de la table que vous avez extraite du stockage cloud.
  
  description de l'illustration rest-call-output.png,
La nouvelle étape apparaît dans la liste des étapes de travail, sous la procédure que vous avez précédemment ajoutée. Cliquez sur l'icône en forme de crayon en regard de l'étape pour la modifier. Cliquez sur l'icône Supprimer en regard de l'étape pour enlever l'étape sélectionnée.

Description de l'image final-job-steps.png.

Une fois que vous avez ajouté toutes les étapes à la fonction Travail dans la boîte de dialogue Créer un travail, vous allez ensuite indiquer le statut des travaux.

Cliquez sur Suivant pour accéder à l'onglet Rapports.
Envoyer des rapports par courriel :
Dans l'onglet Reporting, sélectionnez l'une des options disponibles pour envoyer des mises à jour par courriel sur la fonction de reporting par courriel :
- Une fois le travail terminé : vous recevrez une mise à jour par courriel une fois le travail terminé.
- En cas d'échec du travail : vous recevrez une mise à jour par courriel lorsque le travail aura échoué.
- En cas d'erreur dans le travail : vous recevrez une mise à jour par courriel lorsque le travail comporte une erreur.
Remarque
- Pour que la fonction Travaux envoie des notifications, vous devez configurer les paramètres SMTP (Simple Mail Transfer Protocol) dans les paramètres Data Studio.
- Pour plus d'informations, reportez-vous au chapitre Envoyer un courriel sur Autonomous Database.
- Pour plus d'informations sur la configuration, reportez-vous à Paramètres Data Studio.
Cliquez sur Suivant pour accéder à l'onglet Planifier.
Créer une programmation de travail :
- Dans l'onglet Programmation, vous allez définir quand exécuter le travail et à quelle fréquence.
  Activer pour la planification : sélectionnez cette option pour configurer une programmation pour l'exécution de la fonctionnalité de travail, c'est-à-dire pour interroger régulièrement la source de données :
  - Dans les champs d'intervalle de temps, entrez un nombre et sélectionnez un type de temps et les jours pendant lesquels interroger le bucket pour rechercher des fichiers nouveaux ou modifiés. Par exemple, pour interroger toutes les deux heures le lundi, le mercredi et le vendredi, entrez 2, puis sélectionnez Heures. Vous pouvez sélectionner Tous les jours, Du lundi au vendredi, Du dimanche au jeudi ou Personnalisé dans la liste déroulante Jours semaine. Le champ Personnalisé vous permet de sélectionner Lundi, Mardi, Mercredi, Jeudi et Vendredi dans les champs appropriés.
  - Sélectionnez une date de début et une date de fin avec des heures de début et de fin. Si vous ne sélectionnez pas de date de début, l'heure et la date actuelles sont utilisées comme date de début. La date de fin est facultative. Cependant, sans date de fin, les aliments vivants continueront à interroger.
  Description de l'image create-job-schedule.png
  
  Cliquez sur Suivant pour accéder à l'onglet Détails de l'API.
Exécuter des travaux manuellement :
Vous pouvez exécuter la fonctionnalité Travaux après sa création avec DBMS_SCHEDULER ou API’s.
Dans l'onglet Détails de l'API de la boîte de dialogue Créer un travail, vous pouvez afficher les volets suivants dans la navigation de gauche :
- Exécuter le travail : exécutez le travail spécifique en copiant les instructions sous l'API REST et en soumettant une demande GET à la ressource REST à l'aide de cURL.
```
curl -u admin:<password>
      'https://*******.******.*******.oraclecloud.com:****/ords/admin/_/db-api/latest/data-tools/jobs/run'
      -X POST -H 'Content-Type: application/json;charset=UTF-8' -d '{"job_name":"My New
      Job","owner":"admin"}'
```
  Ceci est un exemple de code.
  Vous pouvez également exécuter le travail dans la feuille de calcul SQL en copiant et en collant l'exemple de code suivant que vous consultez sous la section SQL :
```
begin c#***$service.dbms_data_tools.run_job('My New Job'); end;
```
  L'exemple de code SQL ci-dessus exécute la fonctionnalité de travail spécifique. Vous pouvez exécuter ce code sur SQL Worksheet pour exécuter la fonction Travaux.
- Détails de l'activité de travail : cette option affiche les API REST et la requête SQL pour vérifier le statut d'une exécution de travail en cours. Par exemple, si votre travail prend 10 heures, vous pouvez voir si le travail est en cours ou non, s'il a échoué ou non.
  Remarque
  
  Chaque fois que le travail est exécuté, l'ensemble du flux de chaque étape est démarré à partir de zéro.
  
  Description de l'illustration invoke-details.png
Cliquez sur Créer.

Un message de confirmation indiquant que My New Job a été créé apparaît.

Le travail qui vient d'être créé apparaît sur la page Travaux.

Description de la figure jobs-dashboard.png

Rubrique parent : Fonctionnalité Travaux

Documentation Oracle Cloud Infrastructure

Créer un job