DataWorks:Nœud KingbaseES

Contexte

KingbaseES est un système de gestion de base de données relationnelle (SGBDR) à grande échelle qui prend en charge la norme SQL. Il convient aux applications d'entreprise traitant de grands volumes de données et nécessitant une forte concurrence ainsi qu'une haute disponibilité. Pour plus d'informations, consultez le site web officiel de KingbaseES.

Prérequis

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

  Data Studio effectue les opérations de développement spécifiques au moteur en s'appuyant sur les flux métier. 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 KingbaseES a été créée.

  Ajoutez votre base de données KingbaseES en tant que source de données KingbaseES dans DataWorks avant de pouvoir accéder à ses données. Pour créer une source de données, consultez la rubrique Gestion des sources de données. Pour en savoir plus sur l'utilisation d'une source de données KingbaseES dans DataWorks, reportez-vous à la rubrique Source de données KingbaseES.

  Remarque

  Les nœuds KingbaseES prennent uniquement en charge les sources de données KingbaseES créées à l'aide d'une chaîne de connexion JDBC.

• Une connexion réseau est établie entre votre source de données et un groupe de ressources.

  Assurez-vous que la source de données souhaitée est connectée au groupe de ressources que vous souhaitez utiliser. Pour configurer la connectivité réseau, consultez la rubrique Établir une connexion réseau entre un groupe de ressources et une source de données.

• (Facultatif ; requis pour les utilisateurs Resource Access Management (RAM)) L'utilisateur RAM utilisé pour le développement des tâches 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 ajouter des membres et leur accorder des permissions, consultez la rubrique Ajouter des membres à un espace de travail.

Limitations

Cette fonctionnalité est disponible dans les régions suivantes : 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 KingbaseES

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 > KingbaseES.

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éé, vous pouvez développer et configurer des tâches dessus.

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

(Facultatif) Sélectionner une source de données KingbaseES

Si vous avez créé plusieurs sources de données KingbaseES dans votre espace de travail, sélectionnez la source de données souhaitée sur la page d'édition du nœud KingbaseES. Si vous n'avez créé qu'une seule source de données KingbaseES, DataWorks l'utilise par défaut.

Rédiger du code SQL : Exemple simple

Dans l'éditeur de code du nœud KingbaseES, rédigez le code SQL de votre tâche. Exemple de code :

SELECT * FROM usertablename;

Rédiger du code SQL : Utiliser des paramètres de planification

DataWorks propose des Scheduling Parameter permettant le passage dynamique de paramètres dans les scénarios de planification périodique. Définissez des variables dans le code de votre tâche en utilisant le format ${nom_variable}. Ensuite, attribuez des valeurs à ces variables sous Properties > Scheduling Parameter dans le volet de navigation droit de la page d'édition du nœud. Pour plus d'informations sur les formats pris en charge et la configuration des paramètres de planification, consultez les rubriques Formats pris en charge des paramètres de planification et Configurer et utiliser les paramètres de planification.

Exemple de code :

SELECT '${var}'; -- An example of using a scheduling parameter.

Étape 3 : Configurer la planification des tâches

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 afin de vérifier que la tâche se comporte comme prévu.

1. (Facultatif) Sélectionnez un groupe de ressources et attribuez des valeurs de paramètre 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 le test.

   • Si le code de votre tâche utilise des variables de paramètres de planification, attribuez-leur ici des valeurs pour les tests. Pour plus d'informations sur la logique d'attribution 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 le code de votre tâche. Cliquez ensuite sur l'icône pour exécuter la tâche.

3. (Facultatif) Effectuez un test de fumée.

   Pour lancer un test 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 ce test pendant ou après la soumission du nœud. Pour plus d'informations, consultez la rubrique Effectuer un test 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 selon 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 d'exiger une revue de code après la soumission.

   Remarque

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

   • La revue de code permet de garantir la qualité du code et d'éviter les erreurs causées par la publication directe en production de code non révisé. Si la revue de 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 Revue de 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

Opérations sur les tâches : Une fois une tâche validée et publiée, elle s'exécute périodiquement selon la configuration du nœud. Cliquez sur O&M dans le coin supérieur droit de la page d'édition du nœud pour accéder au Operation Center et consulter l'état de planification et d'exécution de la tâche planifiée. Pour plus d'informations, consultez la rubrique Gestion des tâches planifiées.