Aller au contenu principal

Variables

Le module Variables est l'endroit central pour gérer les valeurs réutilisables dans DataSync. Une variable associe un nom à une valeur spécifique et vous permet de substituer ce nom chaque fois que la valeur est nécessaire. Cela peut se faire dans des filtres, des requêtes ou des champs calculés à travers plusieurs extractions. En gardant ces valeurs dans un seul endroit, vous maintenez la cohérence de votre projet et évitez l'effort de faire le même changement à plusieurs endroits.

Utiliser des variables simplifie la maintenance et réduit considérablement le risque d'erreurs. Au lieu de modifier chaque instruction SQL contenant une certaine valeur, vous la mettez à jour une fois dans le module Variables et le changement est appliqué partout où la variable est utilisée.

remarque

Pour utiliser une variable dans DataSync, tapez un symbole @ suivi du nom de la variable : [FieldName] = @MyVar

Quand utiliser des variables

  • Créer des filtres et des requêtes : Filtrer dynamiquement les résultats d'extraction ou construire des requêtes qui s'adaptent à différentes valeurs de paramètre.
  • Purger des tables : Appliquer dans les extractions de migration pour vider le contenu des tables avant de charger de nouvelles données.
  • Calculer des valeurs de champ : Utiliser dans des transformations ou des champs calculés pour standardiser ou automatiser une logique répétitive.

Dans cette section :

SujetDescription
Ajouter une variableCréer une nouvelle variable en spécifiant son nom et sa valeur pour une réutilisation dans les extractions, les requêtes et les calculs.
Modifier une variable existanteMettre à jour la valeur ou le nom d'une variable pour changer son comportement dans toutes les extractions associées.
Supprimer une variableSupprimer une variable qui n'est plus nécessaire dans aucune extraction ou transformation.
Insérer des paramètres RSD dans le profil APIDéfinir des paramètres de substitution à l'exécution pour les appels API en assignant des valeurs aux variables RSD dans le profil API.

Exemple

Supposons que vous ayez une variable nommée @City avec la valeur Toronto. Au lieu de taper Toronto plusieurs fois dans une instruction SQL, vous utilisez @City :

WHERE Customers.City = @City

Si la valeur change pour Toronto, ON, mettez simplement à jour @City dans le module Variables. Le changement est automatiquement appliqué partout où la variable est référencée, sans devoir modifier chaque instruction individuellement.