Descripción general de la implementación
En esta página, se explican los pasos para implementar Cortex Framework en los datos de tu empresa.
Antes de comenzar
Antes de continuar con la implementación, asegúrate de haber completado los requisitos previos que se describen en la página Requisitos previos.
Antes de implementar Cortex Framework, las tablas pertinentes del ERP de SAP deben replicarse en BigQuery. Para obtener más información, consulta la página Fuente de datos de SAP ERP.
Implementación
Una vez que tu entorno esté preparado, podrás ejecutar la implementación. Usa las secuencias de comandos uv de Cortex Framework para compilar y enviar tus recursos de datos a tu proyecto Google Cloud , y transforma tus configuraciones locales en una arquitectura de datos escalable y activa.
Configuración
Antes de la implementación, las capas de la base de datos y del producto de datos se configuran a través de un enfoque centralizado de configuración como código.
Cortex Framework usa un archivo config/config.yaml para configurar la implementación de Cortex Framework. Este archivo contiene la asignación esencial entre tus datos de origen y el entorno de destino Google Cloud. La configuración adecuada garantiza que Cortex Framework sepa exactamente dónde encontrar tus datos sin procesar y dónde materializar las capas resultantes.
Para que la implementación del Cortex Framework sea exitosa, se deben agregar los siguientes valores obligatorios:
YOUR_BUILD_PROJECT_ID: Es el proyecto en el que se ejecutan la orquestación de la implementación y las secuencias de comandos deuv.YOUR_SOURCE_PROJECT_ID: Es el proyecto que contiene tus datos fuente sin procesar.YOUR_TARGET_PROJECT_ID: Es el proyecto de destino en el que residirán los productos de datos procesados y los conjuntos de datos de BigQuery.YOUR_REPO_PROJECT_ID: Es el proyecto que aloja el repositorio de Dataform y los artefactos de implementación.
Para obtener información detallada sobre el archivo de configuración, consulta Configuración de la implementación.
Configura los roles de IAM
Configura los permisos de Identity and Access Management (IAM) necesarios para implementar contenido de Cortex Framework en los proyectos Google Cloud requeridos.
Roles para el proyecto de compilación
Para obtener los permisos que necesitas para compilar Cortex Framework, pídele a tu administrador que te otorgue el rol de IAM de BigQuery Data JobUser (roles/bigquery.jobUser) en tu proyecto de compilación.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Roles para el proyecto de origen
Para obtener los permisos que necesitas para implementar Cortex Framework,
pídele a tu administrador que te otorgue el
rol de IAM de Visualizador de datos de BigQuery (roles/bigquery.dataViewer) en tu proyecto de origen.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Roles para proyectos de destino
Para obtener los permisos que necesitas para implementar Cortex Framework, pídele a tu administrador que te otorgue los siguientes roles de IAM en tus proyectos de destino:
- Editor de datos de BigQuery (
roles/bigquery.dataEditor) - Administrador de Dataform (
roles/dataform.admin) - Administrador de Service Usage ()
roles/serviceusage.serviceUsageAdmin
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Ejecuta la implementación
Ejecuta el siguiente comando para activar la implementación de Cortex Framework. Este proceso realizará las siguientes acciones:
- Verifica que se hayan completado todos los requisitos previos.
- Conéctate al conjunto de datos sin procesar y, según la información del esquema, compila y compila los secuencias de comandos de
.sqlx. - Crea el repositorio y el espacio de trabajo de Dataform y, luego, sincroniza los artefactos compilados con el repositorio.
uv run cortex-build-and-deploy --config "config/config.yaml"
- Sigue los pasos posteriores a la implementación para ejecutar las acciones de Dataform y verificar los resultados en BigQuery.
Opciones de línea de comandos
La interfaz de línea de comandos (CLI) de uv run admite estas acciones:
uv run cortex-build: Ejecuta la compilación del espacio de trabajo de Dataform, traduciendo las configuraciones de YAML y las plantillas de SQLX/JS en recursos de Dataform implementables. Para obtener más información, consulta Compilación de Cortex con la CLI.uv run cortex-deploy: Envía los recursos compilados al espacio de trabajo de Dataform de destino. Para obtener más información, consulta CLI Cortex deploy.uv run cortex-build-and-deploy: Combina la compilación y la transferencia de los recursos de compilación al espacio de trabajo de Dataform. Para obtener más información, consulta Compilación e implementación de Cortex con la CLI.