Utilisation de l'activité Cassandra Insérer lignes
Utilisez l'activité Insérer lignes pour insérer des enregistrements dans les tables existantes de Cassandra.
Pourquoi et quand exécuter cette tâche
Utilisez cette tâche pour insérer des lignes dans l'instance Cassandra. L'appel de cette activité est un appel synchrone lorsque les données entrées sont envoyées à l'activité pour traitement et que la réponse est renvoyée à l'orchestration.
Procédure
- Dans une orchestration active, ouvrez l'onglet Activités et développez le contenu du dossier Cassandra.
- Faites glisser l'icône de l'activité Insérer lignes vers l'orchestration. Sélectionnez l'activité. La liste de contrôle de l'activité Cassandra Insérer lignes s'affiche.
- Dans la liste de contrôle, cliquez sur Récapitulatif.
- Vérifiez le contenu de la zone Nom d'activité et apportez les modifications nécessaires.
- Dans la liste de contrôle, cliquez sur Sélectionner le noeud final.
- Cliquez sur Parcourir et utilisez la boîte de dialogue Explorateur de projets pour sélectionner le noeud final Cassandra approprié.
- Facultatif : vous pouvez créer le noeud final en cliquant sur Nouveau et en spécifiant les détails de connexion requis. Cliquez sur OK pour sauvegarder et utiliser le noeud final pour cette configuration.
- Pour apporter des modifications à la configuration du noeud final sélectionné, cliquez sur Editer pour accéder aux options dans une fenêtre distincte. Toute modification effectuée affecte globalement toutes les utilisations de ce noeud final dans les orchestrations actives.
- Dans la liste de contrôle, cliquez sur Configurer.
- Sous Configurer, cliquez sur Sélectionner la table et indiquez un nom d'espace de clé. Cliquez sur Parcourir pour sélectionner dynamiquement une table dans la liste de tables en cours de la base de données spécifiée par le noeud final.
Pour sélectionner une table, utilisez l'une des méthodes suivantes :
- Cliquez sur une table de la liste, puis sur OK.
- Indiquez le nom de table dans la section ‘Filtrer la table’, puis cliquez sur le bouton Rechercher.
Remarque : Dans la table de sélection de table, la case à cocher ‘Mettre à jour la ligne si la ligne existe déjà (non applicable pour l'option Par lots)’ permet de mettre à jour les valeurs existantes de la table. Si la case est cochée et si un enregistrement comportant la même clé existe déjà, celui-ci est mis à jour. Cela n'est pas applicable si l'option Par lots est activée dans la section Règles de distribution. - Vérifiez que toutes les colonnes de la table sélectionnée sont affichées dans la grille.
- UTF-8 est un codage de caractères standard pour Unicode. Il s'agit du codage par défaut.
- Si vous avez ajouté/mis à jour/supprimé les colonnes existantes de la table, utilisez le bouton
Actualiser pour obtenir les détails de colonne mis à jour de la table sélectionnée. Remarque :
- Pour insérer une seule ligne dans la base de données, sélectionnez directement la section Mapper les entrées.
- Pour insérer plusieurs enregistrements, l'utilisateur doit sélectionner l'option Règles de distribution et activer la case à cocher Par lots.
- Sous Règles de distribution, cochez la case
Activer le traitement par lots et définissez le nombre de lignes que vous souhaitez insérer à un moment donné.
- Une fois la case cochée, le type de traitement par lots sera renseigné dans la section déroulante :
- LOGGED
- UNLOGGED
- Sélectionnez l'un des types de traitement par lots ci-dessus.
- La valeur par défaut dans la liste déroulante ‘Niveau de cohérence d'écriture’ correspond à celle qui est sélectionnée lors de la création du noeud final dans le test de connexion. L'utilisateur peut modifier la valeur en sélectionnant l'un quelconque des niveaux de cohérence.
- Une fois la case cochée, le type de traitement par lots sera renseigné dans la section déroulante :
- Sélectionnez les entrées mappées dans la liste de contrôle. Les schémas XML
générés à partir de la table sélectionnée de l'activité Insérer lignes s'affichent
sous forme de noeuds sous le paramètre d'entrée de demande dans le panneau Vers l'activité.
Pour le type de colonne map<?,?> , le schéma contient une clé et une valeur sous forme de noeud d'élément récursif.
Voici un exemple de demande d'entrée pour le type de données Map :
<to_do> <key>Delivery</key> <value>Cassandra</value> </to_do> <to_do> <key>QA</key> <value>SharePoint</value> </to_do>
Pour les types de colonne set<?> et List<?>, le schéma contient un noeud d'élément récursif.
Voici un exemple de demande d'entrée pour les types de données Set et List :
<email>john_0@abc.com</email> <email>john_1@abc.com</email> <email>john_2@abc.com</email> <projects>Cassandra</projects> <projects>MailChimp</projects> <projects>SharePoint</projects>
- Créez une mappe entre les variables d'orchestration et le paramètre d'entrée de l'activité. Remarque : Des valeurs doivent être fournies lors de l'exécution pour les éléments obligatoires de la structure d'entrée. Une valeur peut être indiquée en spécifiant une valeur par défaut pour l'élément ou en mappant l'élément avec un noeud d'entrée. En phase d'exécution, si aucune valeur n'est fournie pour un élément obligatoire, l'activité émet une exception qui est signalée par la console de gestion Web. Si aucune valeur n'est fournie au moment de l'exécution pour un paramètre d'entrée facultatif, aucune exception n'est émise lors de l'exécution.
- Sélectionnez Mapper les sorties dans la Liste de contrôle. Le schéma XML généré pour contenir la réponse de l'activité s'affiche sous forme de noeuds sous le paramètre de sortie de réponse dans le panneau Depuis l'activité.
- Créez une mappe entre les paramètres de sortie et les variables d'orchestration.
Résultats
Vous pouvez ajouter plusieurs objets en entrée à cette activité. Pour ce faire, cliquez avec le bouton droit sur la zone Nom d'objet (par exemple, Filtre) dans le panneau Vers l'activité de Mapper les entrées, puis sélectionnez Développer les occurrences.