DataWorks:Nœud SQL Server

Contexte

SQL Server est un système de gestion de base de données relationnelle (SGBDR) qui stocke et traite les données. Il fournit des services fiables, efficaces et sécurisés de gestion et d'analyse des données. Pour plus d'informations, consultez la documentation SQL Server.

Prérequis

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

  Data Studio effectue les opérations de développement spécifiques au moteur en fonction des flux métiers. Avant de créer un nœud, vous devez d'abord créer un flux métier. Pour plus d'informations, consultez Créer un flux métier.

• Vous avez créé une source de données SQL Server avec une chaîne de connexion JDBC. Pour plus d'informations, consultez Gestion des sources 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 accorde des autorisations étendues ; attribuez-le avec prudence). Pour plus d'informations sur l'ajout de membres et l'attribution d'autorisations, consultez 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).

• Les procédures stockées ne sont pas prises en charge.

Étape 1 : Créer un nœud SQL Server

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 > SQL Server.

3. Dans la boîte de dialogue Create Node , saisissez un Name pour le nœud et cliquez sur OK.

Étape 2 : Développer la tâche SQL Server

(Facultatif) Sélectionner la source de données SQL Server

Si votre espace de travail comporte plusieurs sources de données SQL Server, vous devez sélectionner la source de données requise sur la page de l'éditeur de nœud. Si vous ne disposez que d'une seule source de données SQL Server, elle est utilisée par défaut.

Développer le code SQL : Exemple simple

Dans l'éditeur de code du nœud, rédigez le code SQL de votre tâche. L'exemple suivant interroge les informations de base sur toutes les tables utilisateur d'une base de données SQL Server :

SELECT * FROM sys.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 au code dans des scénarios de planification périodique. Vous pouvez définir des variables dans le code de votre tâche en utilisant le format ${nom_variable}. Ensuite, dans le volet de navigation de droite de l'éditeur de nœud, accédez à Scheduling Properties > Scheduling Parameter pour attribuer une valeur à la variable. Pour plus d'informations sur les formats pris en charge et la configuration des paramètres de planification, consultez Formats pris en charge pour les paramètres de planification et Configurer et utiliser les paramètres de planification.

Exemple : Interroger les noms et les dates de création de toutes les tables définies par l'utilisateur créées au cours de l'année écoulée. Le paramètre de planification a est défini sur $[add_months(yyyymmdd,-12)], ce qui représente la date d'il y a un an.

Le code suivant fournit un exemple.

SELECT name, create_date
FROM sys.tables
WHERE type = 'U' AND create_date >= '${a}';

É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 Présentation 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 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ètre de planification, attribuez-leur des valeurs ici pour les tests. Pour plus d'informations sur la logique d'attribution des paramètres, consultez 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 exécuter 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 un test de fumée pendant ou après la soumission du nœud. Pour plus d'informations, consultez 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 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 . Choisissez éventuellement si une revue de code est requise après la soumission.

   Remarque

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

   • La revue de 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 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 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 Publier une tâche.

Étapes suivantes

Opérations sur les tâches : Après qu'une tâche a été validée et publiée, elle s'exécute périodiquement en fonction de la configuration du nœud. Vous pouvez cliquer sur O&M dans le coin supérieur droit de la page d'édition du nœud pour accéder au Operation Center et afficher l'état de planification et d'exécution de la tâche planifiée. Pour plus d'informations, consultez Gérer les tâches planifiées.