Le fichier Transform.cfg

IMPORTANT

En savoir plus sur le Data Workbench Annonce de fin de vie.

Le fichier Data WorkbenchTransform.cfg contient les paramètres qui définissent les sources de journaux, les transformations de données et les exportateurs.

Les transformations que vous définissez manipulent les données brutes collectées par les capteurs ( .vsl ) ou contenus dans des fichiers texte, des fichiers XML ou des bases de données conformes à la norme ODBC, et les générer soit dans des champs existants, en écrasant les données actives, soit dans des champs nouvellement définis.

Pour configurer la fonctionnalité de transformation, vous devez modifier Data Workbench. Transform.cfg dans le dossier Jeu de données pour le profil pour lequel vous souhaitez exporter des données d’événement. En règle générale, ce profil est dédié à la fonctionnalité de transformation (c’est-à-dire que vous n’effectuez aucun autre traitement de données que celui défini dans Data Workbench. Transform.cfg ). Notez que toute instruction de traitement spécifiée dans la variable Log Processing Dataset Include Les fichiers de tous les profils hérités sont appliqués en plus de ceux spécifiés dans Data Workbench. Transform.cfg fichier .

Pour plus d’informations sur les fichiers d’inclusion de jeux de données, voir Fichiers d’inclusion de jeux de données.

Si les données que vous souhaitez exporter sont traitées par une grappe de serveurs Data Workbench, chacun des serveurs de traitement (DPU) de la grappe traite les données, mais uniquement le premier DPU (serveur de traitement #0 dans la grappe). profile.cfg ) écrira les données de sortie dans son système de fichiers local.

Pour modifier le fichier Transform.cfg de Data Workbench

  1. Lorsque vous travaillez dans le profil pour lequel vous souhaitez exporter des données, ouvrez le Profile Manager et cliquez sur Dataset pour afficher le contenu du répertoire.
  2. Cliquez avec le bouton droit de la souris sur la coche en regard de Data Workbench. Transform.cfg, puis cliquez sur Make Local. Une coche pour ce fichier apparaît dans la variable User colonne .
  3. Cliquez avec le bouton droit de la souris sur la coche que vous venez de créer, puis cliquez sur Open > from the workbench. Data Workbench Transform.cfg s’affiche.
  4. Modifiez les paramètres du fichier de configuration à l’aide du tableau ci-dessous comme guide :
Paramètre Description
Heure de fin

Facultatif. Filtrez les données pour inclure les entrées du journal avec horodatages jusqu’à cette heure, mais sans les inclure. Adobe recommande d’utiliser l’un des formats suivants pour l’heure :

  • 1er janvier 2013HH:MM:SS EDT
  • 1er janvier 2013 HH:MM:SS GMT

Par exemple, en spécifiant le 29 juillet 2013 00:00:00 EDT comme le Heure de fin comprend les données jusqu’au 28 juillet 2013, au 11 juillet:59:59 HEURES HEURES.

Vous devez spécifier un fuseau horaire. Le fuseau horaire n’est pas défini par défaut sur GMT s’il n’est pas spécifié. Pour obtenir la liste des abréviations de fuseaux horaires prises en charge par le serveur Data Workbench, voir Codes du fuseau horaire .

Le paramètre Utiliser les heures de début et de fin pour les sources de fichiers journaux et Capteur est associé à ce paramètre.

Exportateurs

Les sous-champs d'un exportateur spécifient le mode de traitement et/ou de formatage des données de sortie. Vous pouvez définir plusieurs exportateurs pour un ensemble de sources de journal. Chaque type d’exportateur crée une sortie indépendamment.

Il existe trois types d'exportateurs :

  • ExportTextFile
  • ExportDelimitedTextFile
  • ExportVSLFile

Pour plus d’informations sur les types d’exportateur, voir Définition des exportateurs .

Seuil de hachage Facultatif. Facteur d’échantillonnage pour un sous-échantillonnage aléatoire de lignes. S’il est défini sur un nombre n, un seul identifiant de suivi sur chaque n est sélectionné pour l’exportation, ce qui réduit le nombre total de lignes exportées par un facteur n. Pour exporter toutes les lignes, définissez le Seuil de hachage sur 1.
Condition d’entrée du journal Facultatif. Définit les règles selon lesquelles les entrées de journal sont prises en compte pour l’exportation. Pour plus d’informations sur la variable Condition d’entrée du journal , voir Fichier de configuration de traitement du journal .
Sources de journalisation

Sources des données. Sources de journalisation peut être .vsl fichiers, fichiers journaux ou fichiers XML ou données provenant de bases de données compatibles avec ODBC. Pour plus d’informations sur sources de journal , voir Fichier de configuration de traitement du journal .

Transform s’attend à ce que toutes les données source soient dans l’ordre chronologique au sein de fichiers d’entrée triés lexicographiquement. Si cette exigence n’est pas satisfaite, les calculs "À partir de" sont incorrects et des données d’entrée supplémentaires peuvent être traitées après la fermeture des fichiers de sortie.

Mode hors ligne

Facultatif. True ou false. Si la valeur est true, Transform suppose que tous les fichiers d’entrée sont présents au démarrage du traitement des données. Lorsque toutes les données d’entrée ont été lues, Transform ferme tous les fichiers de sortie sans attendre que des données supplémentaires soient reçues. La valeur par défaut est false.

Remarque : If Mode hors ligne est défini sur true, Transform s’attend à ce que toutes les données source soient présentes avant le début du traitement. Un message d’avertissement est généré dans la variable VisualServer.log si des données supplémentaires sont reçues une fois les fichiers de sortie fermés.

Retraiter

Facultatif. N’importe quel caractère ou combinaison de caractères peut être saisi ici. La modification de ce paramètre et l’enregistrement du fichier dans la variable Transform La machine lance le retraitement des données.

Pour plus d’informations sur le retraitement de vos données, voir Retraitement et retransformation .

Phases

Facultatif. Les noms des étapes de traitement qui peuvent être utilisés dans Inclure le jeu de données de traitement du journal fichiers exécutés en plus des outils de données Transform.cfg fichier . Les étapes de traitement permettent d’organiser les transformations définies dans Inclure le jeu de données de traitement du journal fichiers . Ce paramètre est très utile si vous avez défini une ou plusieurs transformations dans plusieurs Inclure le jeu de données de traitement du journal et vous souhaitez que des transformations spécifiques soient effectuées à des moments spécifiques pendant le processus d’exportation.

L’ordre dans lequel vous répertoriez les scènes détermine l’ordre dans lequel les transformations dans la Inclure le jeu de données de traitement du journal Les fichiers sont exécutés pendant l’exportation des données. Prétraitement et Post-traitement sont des phases intégrées; Prétraitement est toujours la première étape, et Post-traitement est toujours la dernière étape. Par défaut, il existe une scène nommée Par défaut .

Pour ajouter une nouvelle étape de traitement

  • Dans Data Workbench Transform.cfg fenêtre, clic droit Phases , puis cliquez sur Ajouter > Évaluation .
  • Saisissez le nom de la nouvelle étape.

Pour supprimer une étape de traitement existante

  • Cliquez avec le bouton droit de la souris sur le nombre correspondant à l’étape que vous souhaitez supprimer, puis cliquez sur Supprimer < #stage_number >.

Remarque : Lorsque vous spécifiez une étape dans une Inclure le jeu de données de traitement du journal fichier le nom de l’étape doit correspondre exactement au nom que vous saisissez ici. Pour plus d’informations sur les fichiers d’inclusion de jeux de données, voir Fichiers d’inclusion de jeux de données .

Heure de début

Facultatif. Filtrez les données pour inclure les entrées du journal avec horodatages à cette heure ou après cette heure. Adobe recommande d’utiliser l’un des formats suivants pour l’heure :

  • 1er janvier 2013 HH:MM:SS EDT
  • 1er janvier 2013 HH:MM:SS GMT

Par exemple, en spécifiant le 29 juillet 2013 00:00:00 HNE car l’heure de début inclut des données à partir du 29 juillet 2013, à 12:00:00H00 HNE.

Vous devez spécifier un fuseau horaire. Le fuseau horaire n’est pas défini par défaut sur GMT s’il n’est pas spécifié. Pour obtenir la liste des abréviations de fuseaux horaires prises en charge par le serveur Data Workbench, voir Codes du fuseau horaire .

Remarque : Le paramètre Utiliser les heures de début et de fin pour les sources de fichiers journaux et Capteur est associé à ce paramètre.

Transformations

Facultatif. Définit les transformations à appliquer aux données. Pour plus d’informations sur les types de transformation disponibles, voir Transformations de données .

Remarque : Les types de transformation suivants ne fonctionnent pas lorsqu’ils sont définis dans Data Workbench Transform.cfg fichier :

  • AppendURI
  • CrossRows
  • ODBCLookup
  • Sessionize
REMARQUE

Si des données supplémentaires sont reçues après la fermeture des fichiers de sortie (voir Log Sources et Offline Mode dans le tableau précédent), Transform crée de nouveaux fichiers de sortie avec les données additionnelles. Les noms des nouveaux fichiers de sortie sont générés à partir du nom du fichier de sortie d’origine avec l’ajout d’un numéro de version entre parenthèses juste avant l’extension. Par exemple, si le fichier de sortie d’origine est 20070701-ABC.vsl, les versions suivantes de ce fichier seront nommées 20070701-ABC(1).vsl, 20070701-ABC(2).vsl, etc. Notez que l’utilisation des fichiers versionnés en tant qu’entrée au serveur Data Workbench peut entraîner des erreurs de traitement.

Adobe recommande d’éviter la création de fichiers de sortie versionnés en s’assurant que toutes les données source sont dans l’ordre chronologique au sein de fichiers d’entrée triés lexicographiquement et, si Offline Mode est définie sur true, que toutes les données source sont présentes avant le début du traitement. Pour plus d’informations, voir Log Sources et Offline Mode entrées dans la table précédente.

  1. Ajouter des transformations en cliquant avec le bouton droit de la souris Transformations et clic Add new > Transformation type. Renseignez les champs de transformation.

    Voir Transformations de données pour obtenir des descriptions et des exemples des transformations que vous pouvez utiliser avec la fonctionnalité de transformation.

  2. Clic droit (modified) dans la partie supérieure de la fenêtre, puis cliquez sur Save.

  3. Pour que les modifications apportées localement prennent effet, dans la variable Profile Manager, cliquez avec le bouton droit de la souris sur la coche de Data Workbench. Transform.cfg dans le User , puis cliquez sur Save to > profile name, où nom du profil est le nom du profil pour lequel vous exportez des données. Le retraitement des données commence après la synchronisation du profil.

    REMARQUE

    Pour plus d’informations sur le retraitement de vos données en vue de l’exportation, voir Retraitement et retransformation.

Sur cette page