DataWorks:Nœud Oracle

Informations générales

Oracle est un système de gestion de base de données relationnelle (SGBDR) utilisé pour stocker et traiter les données. Il offre des services fiables, efficaces et sécurisés de gestion et d'analyse des données. Pour plus d'informations, consultez la documentation Oracle.

Prérequis

• Le flux métier a été créé.

  Data Studio effectue les opérations de développement spécifiques au moteur en se basant sur les flux métiers. Avant de créer un nœud, créez un flux métier. Pour plus d'informations, consultez la rubrique Créer un flux métier.

• Une source de données Oracle a été créée.

  Avant d'accéder à votre base de données Oracle, ajoutez-la à DataWorks en tant que source de données Oracle. Pour plus d'informations, consultez la rubrique Source de données Oracle.

  Remarque

  Les nœuds Oracle prennent uniquement en charge les sources de données Oracle créées avec une chaîne de connexion JDBC.

• (Facultatif ; requis pour les utilisateurs RAM) L'utilisateur RAM utilisé pour le développement de la tâche a été ajouté à l'espace de travail cible et s'est vu attribuer le rôle Development ou Workspace Administrator (ce dernier octroie des autorisations étendues ; attribuez-le avec prudence). Pour plus d'informations sur l'ajout de membres et l'attribution d'autorisations, consultez la rubrique Ajouter des membres à un espace de travail.

Limites

Régions prises en charge : Chine (Hangzhou), Chine (Shanghai), Chine (Beijing), Chine (Shenzhen), Chine (Chengdu), Chine (Hong Kong), Singapour, Malaisie (Kuala Lumpur), Allemagne (Francfort), États-Unis (Silicon Valley) et États-Unis (Virginie).

Étape 1 : Créer un nœud Oracle

1. Connectez-vous à la console DataWorks. Dans la région cible, cliquez sur Data Development and O&M > Data Development dans le volet de navigation de gauche. Sélectionnez un espace de travail dans la liste déroulante et cliquez sur Go to Data Development.

2. Cliquez avec le bouton droit sur le workflow cible et choisissez Create Node > Database > Oracle.

3. Dans la boîte de dialogue Create Node, saisissez un Name pour le nœud et cliquez sur OK. Une fois le nœud créé, développez et configurez votre tâche.

Étape 2 : Développer une tâche Oracle

(Facultatif) Sélectionner la source de données Oracle

Si votre espace de travail contient plusieurs sources de données Oracle, sélectionnez celle appropriée. Si une seule source de données Oracle existe, elle est utilisée par défaut.

Développer le code SQL : Exemple simple

Dans l'éditeur de code, rédigez la tâche. L'exemple de code suivant interroge les informations de base sur toutes les tables auxquelles l'utilisateur actuel est autorisé à accéder :

SELECT * FROM ALL_TABLES;

Développer le code SQL : Utiliser des paramètres de planification

DataWorks propose des Scheduling Parameter qui vous permettent de transmettre dynamiquement des valeurs à votre code pour les tâches planifiées. Définissez des variables dans le code de votre tâche en utilisant le format ${nom_variable}. Ensuite, accédez à Scheduling Settings > Scheduling Parameter dans le volet droit de l'éditeur de nœud pour assigner une valeur à la variable. Pour plus d'informations sur les formats pris en charge et sur la configuration des paramètres de planification, consultez les rubriques Formats pris en charge pour les paramètres de planification et Configurer et utiliser les paramètres de planification.

Exemple : Interroger les propriétaires, les noms et les dates de création des tables créées depuis le mois précédent jusqu'à aujourd'hui. Le paramètre de planification a est défini sur $[add_months(yyyymm,-1)], ce qui représente le mois précédent.

Le code suivant fournit un exemple.

SELECT owner, object_name, created
FROM all_objects
WHERE object_type = 'TABLE' AND created >= TO_TIMESTAMP('${a}', 'YYYY-MM-DD');

Étape 3 : Configurer la planification de la tâche

Pour exécuter périodiquement la tâche du nœud, cliquez sur Scheduling à droite de la page d'édition du nœud et configurez les paramètres de planification selon vos besoins. Pour plus d'informations, consultez la rubrique Vue d'ensemble des propriétés de planification des tâches.

Étape 4 : Tester le code de la tâche

Effectuez les opérations de test suivantes selon vos besoins pour vérifier que la tâche se comporte comme prévu.

1. (Facultatif) Sélectionnez un groupe de ressources et assignez des valeurs de paramètres personnalisées.

   • Cliquez sur l'icône dans la barre d'outils. Dans la boîte de dialogue Parameter, sélectionnez le groupe de ressources de planification pour les tests.

   • Si le code de votre tâche utilise des variables de paramètres de planification, assignez-leur des valeurs ici pour les tests. Pour plus d'informations sur la logique d'assignation des paramètres, consultez la rubrique Processus de débogage des tâches.

2. Enregistrez et exécutez le code de la tâche.

   Cliquez sur l'icône dans la barre d'outils pour enregistrer votre code de tâche. Cliquez ensuite sur l'icône pour exécuter la tâche.

3. (Facultatif) Effectuez des tests de fumée.

   Pour exécuter des tests de fumée dans l'environnement de développement et vérifier que la tâche planifiée du nœud s'exécute comme prévu, effectuez des tests de fumée pendant ou après la soumission du nœud. Pour plus d'informations, consultez la rubrique Effectuer des tests de fumée.

Étape 5 : Soumettre et publier la tâche

Après avoir configuré la tâche du nœud, soumettez-la et publiez-la. Une fois publiée, le nœud s'exécute périodiquement en fonction de sa configuration de planification.

1. Cliquez sur l'icône dans la barre d'outils pour enregistrer le nœud.

2. Cliquez sur l'icône dans la barre d'outils pour soumettre la tâche du nœud.

   Dans la boîte de dialogue Submission, saisissez une Change Description. Vous pouvez également choisir si une révision du code est requise après la soumission.

   Remarque

   • Vous devez configurer l'Rerun attribute et les Parent Nodes du nœud avant de pouvoir le soumettre.

   • La révision du code permet de garantir la qualité du code et d'éviter les erreurs causées par la publication directe de code non révisé en production. Si la révision du code est activée, le code du nœud soumis doit être approuvé par les réviseurs avant sa publication. Pour plus d'informations, consultez la rubrique Révision du code.

Si vous utilisez un espace de travail en mode standard, après avoir soumis la tâche avec succès, cliquez sur Publish dans le coin supérieur droit de la page d'édition du nœud pour déployer la tâche dans l'environnement de production. Pour plus d'informations, consultez la rubrique Publier une tâche.

Étapes suivantes

Une fois une tâche publiée, elle s'exécute périodiquement en fonction de sa configuration. Pour surveiller son état, cliquez sur O&M dans le coin supérieur droit de la page de l'éditeur de nœud pour accéder au Centre d'opérations et afficher son état de planification et d'exécution. Pour plus d'informations, consultez la rubrique Gérer les tâches planifiées.