Utilisation de l'activité Cassandra Mettre à jour lignes
Utilisez l'activité Mettre à jour lignes pour mettre à jour des enregistrements dans Cassandra.
Pourquoi et quand exécuter cette tâche
Cette tâche permet de mettre à jour des enregistrements 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é Mettre à jour lignes vers l'orchestration. Sélectionnez l'activité. La liste de contrôle de l'activité Cassandra Mettre à jour 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.
- 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 mettre à jour une seule ligne de la base de données, sélectionnez directement la section Mapper les entrées.
- Pour mettre à jour plusieurs enregistrements, l'utilisateur doit sélectionner l'option Règles de distribution et activer la case à cocher Par lots.
- Sous Configurer, cliquez sur Règles de distribution. Cochez la case
Activer le traitement par lots et définissez le nombre de lignes que vous souhaitez mettre à jour à un moment donné.
- Une fois la case cochée, le type de traitement par lots sera renseigné dans la section déroulante :
- LOGGED
- UNLOGGED
- COUNTER
- 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 Mapper les entré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é Mettre à jour 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é, une valeur et une option de mise à jour.
L'option de mise à jour (UpdateOption) valide pour map est la suivante :- Add : permet d'ajouter la paire clé-valeur.
- Remove : permet de supprimer la clé spécifiée. Dans le cas d'une suppression, l'élément value ne doit pas être paramétré sur une valeur ou un mappage.
Voici un exemple de demande d'entrée pour le type de données Map :
<to_do> <key>Staging</key> <value>Box.com</value> <updateOption>Add</updateOption> </to_do>
Pour les types de colonne set<?> et List<?>, le schéma contient une valeur d'élément récursive et l'option UpdateOption.
Les valeurs UpdateOption valides pour le type de colonne List<?> sont les suivantes :- Append : permet d'ajouter une seule valeur à la fin de la liste existante.
- Prepend : permet d'ajouter en préfixe une seule valeur au début de la liste existante.
- Discard : permet d'ignorer une seule valeur dans une liste existante.
- Append All : permet d'ajouter une collection de valeurs la fin de la liste existante.
- Prepend All : permet d'ajouter en préfixe une collection de valeurs au début de la liste existante.
- Discard All : permet d'ignorer une collection de valeurs dans une liste existante.
Les valeurs UpdateOption valides pour le type de colonne Set<?> sont les suivantes :- Add : permet d'ajouter une seule valeur dans un ensemble existant.
- Remove : permet de supprimer une seule valeur d'un ensemble existant.
- Add All : permet d'ajouter une collection de valeurs dans un ensemble existant.
- Remove All : permet de supprimer une collection de valeurs d'un ensemble existant.
Voici un exemple de demande d'entrée pour les types de données List et Set :
<email> <value>john_3@abc.com</value> <value>john_4@abc.com</value> <value>john_5@abc.com</value> <updateOption>Append</updateOption> </email> <projects> <value>Salesforce.com</value> <value>Box.com</value> <value>SL</value> <updateOption>Add All</updateOption> </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.