Création et surveillance de travaux

Un travail est une ressource Oracle Cloud Infrastructure qui permet de créer et d'exécuter de manière asynchrone des travaux SQL sur une seule base de données gérée ou sur toutes les bases de données gérées d'un groupe de bases de données.

Avant de créer un travail et de surveiller ses traitements et exécutions, vous devez effectuer les opérations suivantes :

Pour accéder à la section Travaux, procédez comme suit :

  1. Connectez-vous à la console Oracle Cloud Infrastructure.
  2. Ouvrez le menu de navigation et cliquez sur Observation & gestion. Sous Gestion de base de données, cliquez sur Diagnostics et gestion.
  3. Selon que vous voulez créer un travail pour une seule base de données gérée ou pour un groupe de bases de données, accédez à l'une des pages suivantes :
  4. Dans le panneau de gauche, sous Ressources, cliquez sur Travaux.

Les onglets suivants sont affichés dans la section Travaux :

  • Définitions : dans cet onglet, vous pouvez créer un travail et visualiser les travaux qui ont l'état Actif et qui ont été créés au cours de la période sélectionnée dans le champ Période.
  • Exécutions : dans cet onglet, vous pouvez surveiller les traitements et les exécutions de travail.

Création d'un travail

Vous pouvez créer un travail SQL pour effectuer des opérations d'administration sur une seule base de données gérée ou sur un groupe de bases de données.

Les informations fournies lors de la création d'un travail permettent aux composants suivants de se connecter et d'interagir :

  • Base de données gérée unique sur laquelle le travail sera exécuté ou groupe de bases de données sur lequel le travail sera exécuté.
  • Pour les bases de données externes, l'agent de gestion Oracle Cloud Infrastructure installé sur un hôte et disposant d'une connexion à la base de données externe est utilisé pour exécuter le travail.
    Remarque

    L'agent de gestion n'est pas requis pour les bases de données Oracle Cloud et les bases de données autonomes.
  • Bucket Oracle Cloud Infrastructure Object Storage dans lequel les résultats d'un travail de type Requête sont stockés.

Pour créer un travail, procédez comme suit :

  1. Accédez à la page Détails de la base de données gérée de la base de données gérée pour laquelle créer le travail ou à la page Détails du groupe des bases de données du groupe de bases de données pour lequel créer le travail.
  2. Dans le panneau de gauche, sous Ressources, cliquez sur Travaux.
  3. Dans la section Travaux, cliquez sur l'onglet Définitions, puis sur Créer un travail.
  4. Dans le panneau Créer un travail, procédez comme suit :
    1. Fournissez les informations suivantes pour le travail SQL :
      1. Nom de travail : entrez le nom unique du travail.
      2. Description du travail : saisissez éventuellement la description du travail.
      3. Type SQL : sélectionnez le type SQL. Les options disponibles sont les suivantes :
        • Requête
        • DML
        • DDL
        • PL*SQL
      4. Choisir un compartiment : sélectionnez le compartiment dans lequel créer le travail. Le compartiment dans lequel réside la base de données gérée ou le groupe de bases de données est sélectionné par défaut. Toutefois, vous pouvez choisir de créer le travail dans un autre compartiment.
      5. Délai d'expiration : en fonction de la durée potentielle du travail SQL, sélectionnez l'une des options de la liste déroulante. En fonction de l'option sélectionnée, le travail peut être prioritaire.
    2. Indiquez les détails de programmation du travail en sélectionnant l'une des options suivantes :
      • Une fois (immédiatement) : sélectionnez cette option pour exécuter le travail une fois (immédiatement).
      • Une fois (ultérieurement) : sélectionnez cette option pour exécuter le travail une fois (ultérieurement). Vous devez indiquer l'heure à laquelle il doit être exécuté.
      • Récurrent : sélectionnez cette option pour exécuter un travail plusieurs fois à la fréquence indiquée. Si vous voulez indiquer une date de fin pour le travail programmé, cochez la case Définir une date de fin.
    3. Sélectionnez l'une des options disponibles dans la liste déroulante Type d'informations d'identification pour indiquer les informations d'identification de base de données à connecter à la base de données gérée. Pour plus d'informations sur les types d'informations d'identification, reportez-vous à Utilisation des informations d'identification pour effectuer des tâches de diagnostic et de gestion.
      Remarque

      • Si vous créez un travail pour un groupe de bases de données, vous ne pouvez pas utiliser d'informations d'identification nommées et vous devez sélectionner l'option Nouvelles informations d'identification dans la liste déroulante Type d'informations d'identification et indiquer le nom utilisateur, la clé secrète de mot de passe utilisateur et le rôle. En outre, lors de la création d'un travail pour un groupe de bases de données, les informations d'identification de base de données doivent s'appliquer à toutes les bases de données du groupe.
      • Lors de la création d'un travail programmé (à exécuter une ou plusieurs fois), si le message Une stratégie est requise... apparaît, cliquez sur Ajouter une stratégie pour visualiser la stratégie de principal de ressource qui accorde aux ressources de base de données gérée le droit d'accéder à la clé secrète et l'ajouter automatiquement. Le service Oracle Cloud Infrastructure IAM crée la stratégie et l'ajoute à un ensemble de stratégies appelé DBMgmt_Resource_Policy dans le service IAM.
    4. Pour un travail de type Requête, sélectionnez le bucket Object Storage dans lequel les résultats du travail seront stockés. La section Stockage d'objets Oracle pour les résultats de travail avec la liste déroulante Nom de bucket apparaît uniquement si vous avez sélectionné le travail de type Requête. Le bucket Object Storage peut se trouver dans le même compartiment que le travail ou dans un autre compartiment. Vous devez disposer des droits d'accès requis du service Object Storage pour sélectionner le bucket.

      Lors de la création d'un travail programmé (à exécuter une ou plusieurs fois), si le message Une stratégie est requise... apparaît, cliquez sur Ajouter une stratégie pour visualiser la stratégie de principal de ressource qui accorde aux ressources de base de données gérée le droit d'écrire les résultats du travail programmé dans un bucket Object Storage et de l'ajouter automatiquement. Le service IAM crée la stratégie et l'ajoute à un ensemble de stratégies appelé DBMgmt_Resource_Policy dans le service IAM.

      Afin d'obtenir des informations sur les sujets suivants, reportez-vous aux rubriques indiquées :

    5. Cliquez sur Charger le code SQL pour charger la commande SQL ou saisissez-la dans le champ Commande SQL. Si vous saisissez une commande SQL, n'ajoutez pas de caractères ; ou / à la fin.
    6. Pour les travaux de type Requête, DML et PL*SQL, ajoutez éventuellement des variables attachées dans la section Variables attachées. Si des variables attachées sont utilisées en tant qu'espaces réservés qui doivent être remplacés par des valeurs valides pour que l'instruction s'exécute correctement, cliquez sur Ajouter une variable attachée et indiquez les informations suivantes :
      1. Position : sélectionnez la position de la variable attachée.
      2. Type : sélectionnez le type à indiquer si la variable de liaison est une variable de liaison entrante ou sortante.
      3. Type de données : sélectionnez le type de données approprié.
      4. Type de tableau : entrez le type de tableau pour les types de données Tableau de nombres et Tableau de chaînes. Notez que ce champ n'apparaît pas si vous sélectionnez Nombre, Chaîne ou CLOB dans le champ Type de données.
      5. Valeur : entrez la valeur de la variable attachée.

      Pour ajouter d'autres valeurs de variable attachée, cliquez sur Ajouter une variable attachée et fournissez les informations requises. Pour plus d'informations sur les variables attachées, reportez-vous à Variables attachées et curseurs dans le guide de réglage SQL Oracle Database.

    7. Vous pouvez également cliquer sur Afficher les options avancées pour ajouter des balises définies ou à format libre au travail. Si vous disposez des droits d'accès requis pour créer un travail, vous disposez également des droits d'accès nécessaires pour ajouter des balises à format libre. Pour ajouter une balise définie, vous devez disposer des droits d'accès permettant d'utiliser l'espace de noms de balise.

      Afin d'obtenir des informations sur les sujets suivants, reportez-vous aux rubriques indiquées :

    8. Cliquez sur Créer un travail.
Le nouveau travail est répertorié dans l'onglet Définitions de la section Travaux de la base de données gérée ou du groupe de bases de données. Le travail a le statut Actif s'il est en cours d'exécution et Inactif s'il a déjà été exécuté.

Vous pouvez cliquer sur l'icône Actions (Actions) du travail et effectuer les tâches suivantes :

  • Visualiser les détails : cliquez sur cette option pour accéder à la page Détails de travail et visualiser les détails du travail, ses traitements et ses exécutions, les bases de données gérées associées sur lesquelles il est exécuté, et effectuer des tâches liées aux balises. Pour plus d'informations, reportez-vous à Surveillance des traitements et des exécutions de travail.
  • Cloner le travail : cliquez sur cette option pour cloner le travail.
  • Modifier le travail : cliquez sur cette option pour modifier les détails des travaux récurrents programmés qui ont l'état Actif.
  • Déplacer le travail : cliquez sur cette option pour déplacer le travail du compartiment en cours vers un autre compartiment.
  • Supprimer le travail : cliquez sur cette option pour supprimer le travail.

Dans l'onglet Traitements de la section Travaux, vous pouvez visualiser les traitements et les exécutions de travail associées. Les traitements de travail pour la période sélectionnée dans le champ Période sont affichés avec un aperçu du statut des exécutions de travail : Succès, Echec et En cours. Vous pouvez cliquer sur les liens de statut d'exécution pour filtrer les exécutions par statut.

Remarque

Les exécutions de travail pour les bases de données Oracle Cloud ont une limite de temps de 50 minutes. Si l'exécution du travail dépasse cette limite, elle échoue et une erreur s'affiche.

Vous pouvez créer des requêtes d'indicateur et des alarmes sur le statut d'exécution des jobs dans le service Oracle Cloud Infrastructure Monitoring à l'aide de la mesure dbmgmtJobExecutionsCount. Pour plus d'informations, reportez-vous à Mesures de diagnostic et de gestion pour les bases de données Oracle.

Voici un exemple de requête que vous pouvez utiliser pour créer une alarme de travail ayant échoué :

dbmgmtJobExecutionsCount[1m]{managedDbId = "<OCID of the Oracle Database>", status = "Failed"}.mean()

Dans la requête, la dimension managedDbId est utilisée pour vous informer des travaux en échec pour la base de données gérée dont l'OCID est mentionné dans la requête. De même, vous pouvez utiliser les dimensions suivantes :

  • managedDbGroupId : afin d'être informé des travaux en échec pour toutes les bases de données gérées d'un groupe de bases de données.
  • jobId : pour être averti en cas d'échec d'un travail particulier.

Pour plus d'informations sur la création d'une alarme, reportez-vous à Création d'une alarme de base.

Surveillance des traitements et des traitements de travail

Vous pouvez surveiller les traitements et les exécutions d'un travail soumis pour une base de données gérée ou un groupe de bases de données. Une exécution de travail est créée pour chacune des bases de données gérées associées au travail. Un traitement de travail est la somme des exécutions d'un travail spécifique exécutées à une date programmée.

Pour visualiser les traitements et les exécutions de travail, procédez comme suit :

  1. Accédez à la page Détails de la base de données gérée ou Détails du groupe des bases de données.
  2. Dans le panneau de gauche, sous Portée, assurez-vous que le compartiment dans lequel le travail a été créé est sélectionné.
  3. Dans le panneau de gauche, sous Ressources, cliquez sur Travaux.
  4. Dans la section Travaux, cliquez sur l'onglet Définitions, puis sur le nom du travail. Vous pouvez également cliquer sur l'icône Actions (Actions) correspondante, puis sur Afficher les détails.

La page Détails de travail apparaît. Elle fournit les détails du travail et de ses traitements et exécutions, ainsi que les bases de données gérées associées sur lesquelles il est exécuté. Sur cette page, vous pouvez effectuer des tâches telles que modifier, déplacer et supprimer le travail et utiliser des balises. De plus, vous pouvez également surveiller chaque exécution de travail et son statut. Pour ce faire, procédez comme suit :

  1. Dans la section Traitements de travail, développez un traitement de travail et cliquez sur un lien d'exécution de travail.

    Le lien d'exécution de travail est au format suivant :

    <Name of job>_<Name of Managed Database>_YYYY-MM-DD'T'HH:MM:SS.SSS
  2. Sur la page Détails d'exécution de travail, consultez les détails tels que le statut de l'exécution de travail, l'instruction SQL associée à l'exécution et la durée de l'exécution de travail. La durée correspond au temps nécessaire pour réaliser l'ensemble du workflow de l'exécution de travail et pas seulement au temps nécessaire pour exécuter l'instruction SQL sur la base de données.
  3. Pour un travail de type Requête, cliquez sur Télécharger la sortie pour télécharger la sortie de l'exécution de travail dans un fichier .txt.
    Remarque

    L'option Télécharger la sortie est disponible uniquement pour les travaux de type Requête. Vous pouvez utiliser cette option uniquement si vous disposez des droits d'accès requis du service Oracle Cloud Infrastructure Object Storage. Pour plus d'informations, reportez-vous à Autorisations supplémentaires requises pour utiliser Diagnostics & Management.