Setting up a local test environment

Introducción

Para editar transformaciones de datos, se recomienda una configuración de prueba local para mejorar la experiencia de edición y prueba de los ingenieros de datos.

Un entorno de prueba local incluye el siguiente conjunto de herramientas.

Herramienta	Uso
dbt	para ejecutar las transformaciones de datos en una base de datos local.
Código de Visual Studio	para editar el código SQL de las transformaciones de datos.
SQL Server (edición Express)	para probar las transformaciones de datos.
SQL Server Management Studio	para revisar el resultado de las transformaciones de datos en la base de datos local.

Requisitos previos

Para instalar y ejecutar un proyecto dbt , necesitas Python 3.9. Puede descargar Python 3.9 desde el sitio web oficial de Python.

Create a Python virtual environment

Se recomienda crear un entorno virtual de Python en el que instalará dbt. Es recomendable crear una carpeta dedicada a las transformaciones. También puede utilizar esta carpeta para crear el entorno virtual de Python.

Paso	Acción
1	Abra el Explorador de Windows y cree una carpeta donde se ubicará su entorno virtual. Por ejemplo, C:\My_transformations.
2	Abre un símbolo del sistema de Windows.

Ejecuta los comandos descritos en los pasos a continuación para crear un entorno virtual de Python.

Paso	Acción	Comando
1	Instala el paquete de Python virtualenv.	py -m pip install virtualenv
2	Ve a la carpeta en la que quieres crear el entorno.	cd [path_to_your_folder]. Por ejemplo, cd C:\My_transformations
3	Crea un entorno virtual (llamado venv).	py -m virtualenv venv

Instalar Dbt

Asegúrese de que el entorno virtual aún esté activado. Sigue estos pasos para instalar dbt para ejecutar transformaciones.

Importante:

La ejecución de scripts debe estar habilitada en tu sistema. Sigue estos pasos:

1. Abre PowerShell en modo de administrador.

2. Introduce el comando Establecer-PolíticaDeEjecuciónRemotoSigned o Establecer-PolíticaDeEjecución-RemoteSigned -Scope CurrentUser.

3. Introduce Y cuando se te pida.

Paso	Acción	Comando
1	Activar el entorno virtual.	venv\Scripts\activate
2	Instalar el paquete dbt	pip install dbt-sqlserver==1.4.3*
3	Compruebe si la instalación se ha realizado correctamente	dbt --version

* La plataforma UiPath® no admite la característica dbt 1.4 para incluir scripts de Python como parte de tu proyecto dbt .

Código de Visual Studio

Visual Studio Code es el editor de código recomendado para editar transformaciones de datos.

Instalar código de Visual Studio

Puedes descargar Visual Studio Code desde la página web Descargar Visual Studio Code.

Extensiones

Después de haber instalado el código de Visual Studio, instala las siguientes extensiones para facilitar el trabajo con dbt:

• Usuario avanzado de Dbt

Sigue estos pasos para instalar una extensión en el código de Visual Studio.

Paso	Acción
1	Iniciar Visual Studio Code
2	Ve al panel Extensiones (CTRL + MAYÚS + X). Consulta la siguiente ilustración.
3	Busca la extensión dbt Power User escribiendo el nombre en el cuadro de texto Buscar extensiones en el mercado de UiPath.
4	Haz clic en Instalar.

Consulta la siguiente ilustración.

Establecer la ruta del intérprete de Python

Para ejecutar Python desde el entorno virtual que se creó, la ruta de acceso debe establecerse en el código de Visual Studio.

Sigue estos pasos.

Paso	Acción
1	Ve a Archivo> Preferencias> Configuración.
2	Busca Python.
3	En Ruta predeterminada del intérprete, comprueba la ruta a python.exe. Debe estar ubicado en la [path_to_your_folder]\venv\Scriptscarpeta . Consulta la siguiente ilustración para ver un ejemplo.

Microsoft SQL Server

Microsoft SQL Server es la base de datos necesaria para probar las transformaciones. Este servidor de base de datos no se proporciona como parte del producto Process Mining . Para editar y probar la transformación, también puedes utilizar SQL Server Express. Puedes descargar Microsoft SQL Server Express desde la página web oficial de descargas de Microsoft SQL Server.

Nota: se recomienda probar las transformaciones con pequeños conjuntos de datos de desarrollo. Esto hace posible probarlos usando un SQL Server con requisitos mínimos. Si no tiene un Microsoft SQL Server disponible o si desea probar las transformaciones en una máquina de escritorio local, se recomienda utilizar Microsoft SQL Server Express.

Nota:

De forma predeterminada, SQL Server no distingue entre mayúsculas y minúsculas, mientras que Process Mining sí lo hace. Se recomienda cambiar el comportamiento de la base de datos local de SQL Server para que coincida con este comportamiento, para evitar cualquier problema. Esto se puede lograr estableciendo la intercalación correcta durante la instalación. El valor predeterminado para la intercalación depende de tu configuración regional.

Para cambiar la intercalación y que distinga entre mayúsculas y minúsculas, reemplaza la parte CI por CS, por ejemplo, Latin1_General_CI_AS debe cambiarse a Latin1_General_CS_AS. Si ya instalaste SQL Server, sigue las instrucciones que se describen en Establecer o cambiar la intercalación del servidor para actualizar la intercalación.

Requisitos mínimos

A continuación se muestra una descripción general de los requisitos mínimos de SQL Server para un entorno de desarrollo local. Si quieres utilizar más de 10 millones de registros en tu entorno de desarrollo, utiliza la Calculadora de capacidad para calcular los requisitos del sistema correspondientes para SQL Server.

Tipo	Requisitos mínimos (10 millones de eventos)
Versión	SQL Server 2019 o posterior
CPU	8 vCPU / núcleos (se recomiendan 16)
Memoria	32 GiB de RAM
Discos	Se recomienda baja latencia y discos dedicados
Discos de datos	256 GiB
Base de datos temporal	128 GiB

Capacity calculator

Puedes usar la calculadora de capacidad para determinar los requisitos de hardware para configurar una máquina Microsoft SQL Server dedicada para Process Mining. Consulta Calculadora de capacidad.

Estudio de administración de SQL Server (SSMS)

Para ver las tablas de la base de datos y administrar la infraestructura de SQL Server, puede descargar SQL Server Management Studio (SSMS), que puede instalarse en cualquier equipo.