Setting up a local test environment

Introduction

Pour modifier les transformations de données, une configuration de test locale est recommandée afin d'améliorer l'expérience de modification et de test des ingénieurs de données.

Un environnement de test local comprend l'ensemble d'outils suivant.

Outil	Utilisation
dbt	pour exécuter les transformations de données sur une base de données locale.
Code Visual Studio	pour modifier le code SQL des transformations de données.
SQL Server (édition Express)	pour tester les transformations de données.
Studio de gestion SQL Server	pour examiner le résultat des transformations de données dans la base de données locale.

Prérequis

Pour installer et exécuter un projet dbt , il vous faut Python 3.9 (ou version ultérieure). Vous pouvez télécharger Python depuis le site Web officiel de Python.

Consultez la documentation officielle de Dbt sur la compatibilité Python pour plus d'informations.

Create a Python virtual environment

Il est recommandé de créer un environnement virtuel Python dans lequel vous installerez dbt. Il est recommandé de créer un dossier dédié pour vos transformations. Vous pouvez également utiliser ce dossier pour créer l'environnement virtuel Python.

Étape	Action
1	Ouvrez l'Explorateur Windows et créez un dossier dans lequel votre environnement virtuel sera situé. Par exemple, C:\My_transformations .
2	Ouvrez une invite de commande Windows.

Exécutez les commandes décrites dans les étapes suivantes pour créer un environnement Python Virtual.

Étape	Action	Commande
1	Installez le package Python virtualenv .	py -m pip install virtualenv
2	Accédez au dossier dans lequel vous souhaitez créer l'environnement.	cd [path_to_your_folder]. Par exemple, cd C:\My_transformations
3	Créez un environnement virtuel (nommé venv ).	py -m virtualenv venv

Installer Dbt

Assurez-vous que l'environnement virtuel est toujours activé. Suivez ces étapes pour installer dbt afin d'exécuter des transformations.

Important :

Les scripts en cours d'exécution doivent être activés sur votre système. Suivez ces étapes :

1. Ouvrez PowerShell en tant qu'administrateur.
2. Entrez la commande Set-ExecutionPolicy RemoteSigned ou Set-ExecutionPolicy -ExecutionPolicy RemoteSigned-Scope CurrentUser.
3. Saisissez Y lorsque vous y êtes invité.

Étape	Action	Commande
1	Activez l'environnement virtuel.	venv\Scripts\activate
2	Installer le paquet dbt	pip install dbt-core==1.8.8 * pip install dbt-sqlserver==1.8.4
3	Vérifier si l'installation a réussi	dbt --version

• La UiPath® Platform ne prend pas en charge la fonctionnalité dbt pour inclure les scripts Python dans votre projet dbt .

Code Visual Studio

Visual Studio Code est l'éditeur de code recommandé pour la modification des transformations de données.

Installer le code Visual Studio

Vous pouvez télécharger Visual Studio Code à partir de la page Web Télécharger le code Visual Studio.

Extensions

After you have installed Visual Studio Code, install the following extensions to make it easier to work with dbt:

• Utilisateur avancé de Dbt

Suivez ces étapes pour installer une extension dans Visual Studio Code.

Étape	Action
1	Démarrer le code Visual Studio
2	Accédez au panneau Extensions (CTRL + SHIFT + X).
3	Search for the dbt Power User extension by start typing the name in the Search Extensions in Marketplace text box.
4	Click on Install.

L'illustration suivante montre le panneau Extensions.

Définir le chemin d’accès de l’interprète Python

Pour exécuter Python à partir de l'environnement virtuel qui a été créé, le chemin d'accès doit être défini dans Visual Studio Code.

Suivez ces étapes.

Étape	Action
1	Accédez à Fichier > Préférences > Paramètres.
2	Search for Python.
3	Dans le Chemin d'accès à l'interrogateur par défaut, assurez-vous de vérifier le chemin d'accès au fichier python.exe. Il doit être situé dans le dossier [path_to_your_folder]\venv\Scripts .

Serveur Microsoft SQL

Microsoft SQL Server est la base de données requise pour tester les transformations. Ce serveur de base de données n'est pas fourni avec le produit Process Mining . Pour modifier et tester la transformation, vous pouvez également utiliser SQL Server Express. Vous pouvez télécharger Microsoft SQL Server Express à partir de la page Web officielle des téléchargements de Microsoft SQL Server.

Remarque :

Il est recommandé de tester les transformations à l'aide de petits ensembles de données de développement. Cela permet de les tester à l'aide d'un serveur SQL avec des exigences minimales. Si vous n'avez pas Microsoft SQL Server disponible, ou si vous souhaitez tester les transformations sur une machine de bureau locale, il est recommandé d'utiliser Microsoft SQL Server Express.

Remarque :

Par défaut, SQL Server est insensible à la casse tandis que Process Mining l'est. Il est conseillé de modifier le comportement de votre base de données SQL Server locale pour qu'il corresponde à ce comportement, afin d'éviter tout problème. Pour ce faire, il suffit de définir le bon classement lors de l'installation. La valeur par défaut du classement dépend de vos paramètres régionaux. Pour modifier le classement afin de devenir sensible à la casse, remplacez la partie CI par CS, par exemple Latin1_General_CI_AS doit être remplacé par Latin1_General_CS_AS. Si vous avez déjà installé SQL Server, suivez les instructions décrites dans Définir ou modifiez le classement du serveur pour mettre à jour le classement.

Configuration minimale requise

Le tableau suivant contient un aperçu de la configuration minimale requise pour SQL Server pour un environnement de développement local. Si vous souhaitez utiliser plus de 10 millions d'enregistrements dans votre environnement de développement, utilisez le Calculateur de capacité pour calculer la configuration système requise correspondante pour SQL Server.

Saisie de texte	Configuration minimale requise (10 millions d'événements)
Version	SQL Server 2019 ou versions ultérieures
Processeur	8 processeurs virtuels/cœurs (16 recommandés)
Mémoire	32 Go de RAM
Disques	Une faible latence et des disques dédiés sont recommandés
Disques de données	256 GiB
BD temporaire	128 GiB

Capacity calculator

Vous pouvez utiliser le Calculateur de capacité pour déterminer la configuration matérielle requise en vue de configurer une machine Microsoft SQL Server dédiée pour Process Mining. Consultez le Calculateur de capacité.

SQL Server Management Studio (SSMS)

Pour afficher les tables de la base de données et gérer l'infrastructure SQL Server, vous pouvez télécharger SQL Server Management Studio (SSMS), qui peut être installé sur n'importe quel ordinateur.