Administración de proyectos

Búsqueda

Para buscar proyectos, use el cuadro de filtro situado en la parte inferior izquierda de la jerarquía. El filtro de búsqueda busca coincidencias en los nombres y las etiquetas de los proyectos y muestra los resultados en la jerarquía de arriba.

Creación de proyectos nuevos

Para crear un proyecto nuevo:

Abra Analyze
Seleccione “Proyectos” en la barra de menús superior
Haga clic en el botón “Nuevo proyecto”
Complete la información del formulario, incluida la sección “Access Control”
Haga clic en “Create”

El proyecto ya está listo para actualizar los permisos de acceso, agregar propietarios y crear flujos de trabajo.

Configuración de una cuenta de documentos predeterminada

En la página de inicio del proyecto, junto a Entorno de la conexión, elija una Cuenta de documentos predeterminada para el proyecto, o Ninguno para borrarla.

Dentro del proyecto, todos los selectores de archivos muestran Project Default en primer lugar, en representación de la cuenta que el proyecto tenga configurada en ese momento. Desaparece de la lista cuando sale del proyecto, cuando el proyecto no tiene ninguna cuenta predeterminada, cuando se ha eliminado esa cuenta o cuando usted no tiene acceso a ella.

Un paso de archivo nuevo preselecciona Project Default cuando el proyecto tiene una cuenta predeterminada. Los pasos existentes nunca se reescriben: cada uno conserva la cuenta con la que se guardó hasta que usted la cambie, ya que la cuenta de documentos es una elección propia de cada paso, a diferencia del entorno de la conexión.

Un paso que se deja en Project Default se resuelve con la cuenta que sea la predeterminada del proyecto cuando se ejecuta, de modo que cambiar la cuenta predeterminada durante una ejecución solo afecta a los nodos que aún no han comenzado, igual que al cambiar el entorno de la conexión. Si un paso se ejecuta en Project Default y el proyecto no tiene ninguna cuenta predeterminada, la ejecución falla y nombra el proyecto, en lugar de recurrir a otra cuenta.

Historial de versiones

Todos los objetos de un proyecto (un paso, una UDF, un flujo de trabajo, una dimensión, un diseño guardado, un documento o editor de datos y la configuración del propio proyecto) están cubiertos por copias de seguridad del historial de versiones. No se hace una copia de seguridad en cada guardado individual; en cambio, cuando un objeto pasa 30 segundos sin otro guardado, se hace una copia de seguridad de su estado estabilizado. Una ráfaga de ediciones (varios guardados en rápida sucesión) produce una sola versión con el resultado final, no una versión por guardado. Guardar nunca se ralentiza por esperar una copia de seguridad: la cuenta regresiva y la propia copia de seguridad se ejecutan en segundo plano. Si necesita una versión de inmediato, use Back up now para capturar el estado actual al instante y esperar a que termine; está disponible en la interfaz de usuario, en la API y como acción backup de MCP *_versions. El historial de versiones está disponible en todos los planes, incluido Free.

Las versiones anteriores admiten la recuperación a un momento dado: restaure un objeto a una versión anterior. La restauración se rechaza dentro de un proyecto bloqueado, igual que cualquier otro cambio en él.

Una versión se restaura en su lugar. Al restaurar una versión de un proyecto, una dimensión, una función definida por el usuario, un paso, un flujo de trabajo o un editor de datos se reemplaza ese mismo elemento, y se rechaza indicar un elemento distinto como destino; por ejemplo, “A project version is restored in place. Leave the target out, or set it to this project.” Restaurar es un cambio en el elemento, por lo que requiere el mismo rol que editarlo; en un proyecto que restringe filas, restaurar el proyecto o una dimensión que lee una columna restringida requiere un Arquitecto del proyecto. Para recuperar datos antiguos de una tabla como una tabla independiente, restaure una instantánea de la tabla en una tabla nueva.

Además de este seguimiento automático, los proyectos y sus elementos también admiten el control de versiones. Crear una versión es muy fácil y, además, puede combinar los cambios de una versión en otra. Esto ofrece una forma sencilla de llevar el control de las instantáneas o de crear una versión para desarrollo y poder combinar después esos cambios en la versión que no es de desarrollo cuando lo desee. Consulte Colaborar: versiones, comparación y uso compartido para ver el control de versiones, la comparación y la combinación en la práctica.

Los datos de las tablas tienen su propio historial (instantáneas que toma Lakehouse en cada escritura), que se describe en Instantáneas de tablas.

Restauración y retención mediante el asistente de IA o MCP

Mediante el asistente de IA o MCP, dimension_versions restaura, retiene y libera una versión de dimensión por su version_id, y restore_project revierte todas las dimensiones del proyecto a su última copia de seguridad, y cada listado de *_versions (pasos, UDF, flujos de trabajo, dimensiones, proyectos) muestra el version_id de cada versión y si está retenida. Un restore mediante cualquier herramienta *_versions, o mediante la API REST, restaura el elemento en su lugar: omita el destino o indique el propio elemento. project_upsert puede desbloquear un proyecto bloqueado y respeta if_match, de modo que falla en lugar de sobrescribir un cambio hecho desde la última vez que leyó el proyecto.

Administración del acceso a los proyectos

Tipos de acceso

La seguridad de los proyectos se ha simplificado en tres tipos de acceso:

Todos los miembros del espacio de trabajo
Solo miembros específicos
Solo grupos de seguridad específicos

Configurar la seguridad del proyecto es fácil:

Abra Analyze
Seleccione “Proyectos”
Haga clic en el icono de edición del proyecto que desee restringir
Elija la restricción deseada en “Access Control”
Haga clic en “Update”

Solo un Arquitecto del proyecto o un administrador del inquilino puede cambiar quién tiene acceso a un proyecto: su tipo de acceso, los miembros y los grupos de seguridad que contiene y sus recursos compartidos de datos. Cualquier otra persona ve esos paneles en modo de solo lectura, con la nota “Only project Architects can change access.”

Todos los miembros del espacio de trabajo

El acceso “Todos los miembros del espacio de trabajo” es la opción más sencilla, ya que da acceso a todos los miembros del espacio de trabajo y no requiere asignar miembros adicionales.

Solo miembros específicos

La opción de acceso “Solo miembros específicos” requiere asignar cada miembro al proyecto. Para asignar miembros a un proyecto:

Abra Analyze
Seleccione “Proyectos” en la barra de menús superior
Haga clic en el icono de miembros
Conceda acceso a los miembros marcando la casilla junto a su nombre en la columna “Access”
Haga clic en “Update”

En las nubes con un gran número de miembros, este enfoque puede requerir más esfuerzo del deseado, y es ahí donde resultan útiles los grupos de seguridad.

Solo grupos de seguridad específicos

La opción “Solo grupos de seguridad específicos” permite asignar a grupos de seguridad concretos el permiso para acceder a la cuenta. Como las restricciones de acceso dependen de la asociación con uno o varios grupos de seguridad, la administración del acceso a la cuenta para grupos más grandes es mucho más sencilla. Esto resulta especialmente útil cuando se combina con la asociación automática de grupos del inicio de sesión único. Al usar el inicio de sesión único para establecer las asignaciones de grupos de los miembros, esos grupos también pueden habilitar y deshabilitar de forma implícita el acceso a los proyectos.

Para editar los grupos asignados:

Abra Analyze
Seleccione “Proyectos” en la barra de menús superior
Haga clic en el icono de grupos de seguridad
Conceda acceso a los grupos de seguridad marcando la casilla junto a su nombre en la columna “Access”
Haga clic en “Update”

Uso compartido de datos entre proyectos

Un recurso compartido de datos permite que un proyecto acceda a las tablas de otro proyecto; por ejemplo, para que los pasos Import Project Table y Export Project Table puedan mover datos entre ellos. El recurso compartido lo concede el proyecto cuyos datos se comparten, a otro proyecto:

Abra el proyecto cuyos datos desea compartir y vaya a su pestaña Inicio.
En Administración del uso compartido de datos, haga clic en Nuevo recurso compartido de datos.
En Seleccionar proyecto, elija el proyecto que puede usar los datos de este proyecto.
En Operaciones permitidas, marque Leer, Escribir o ambas, y haga clic en Agregar recurso compartido de datos.

Eliminar recurso compartido de datos quita un recurso compartido. Solo un Arquitecto del proyecto o un administrador del inquilino puede agregar o eliminar los recursos compartidos de datos de un proyecto.

Un recurso compartido se concede a un proyecto, por lo que solo vale para los miembros de ese proyecto y sus flujos de trabajo:

Leer mediante un recurso compartido requiere un rol en el proyecto al que se concedió. Quien no tenga ningún rol en él no obtiene nada del recurso compartido.
Escribir mediante un recurso compartido (crear una tabla, una carpeta o una dimensión en el proyecto que comparte) requiere un recurso compartido con Escribir y el rol de Gerente o Arquitecto en su propio proyecto, el rol que podría hacer el mismo cambio allí. A cualquier otra persona se le indica “Writing to this project through a data share needs a write share from it to your project, and the Manager or Architect role in your project.”

Los flujos de trabajo se ejecutan con la propia identidad de su proyecto, por lo que los pasos Import Project Table y Export Project Table funcionan mediante un recurso compartido sea quien sea el que inicie la ejecución.

Configuración de distintos roles de visualización

Muchas veces un proyecto puede requerir varias transformaciones y tablas para completar pasos intermedios, mientras que el resultado final puede constar de unas pocas tablas. Los miembros no siempre necesitan ver todos los elementos del proyecto, a veces solo el producto final. PlaidCloud le ofrece la posibilidad de configurar distintos roles de visualización para despejar y controlar fácilmente la visibilidad de cada miembro.

Hay tres roles de visualización integrados: Arquitecto, Gerente y Explorador

El rol Arquitecto es el más sencillo porque permite la visibilidad y el control totales de proyectos, flujos de trabajo, tablas, variables, editores de datos, jerarquías y funciones definidas por el usuario.

Los roles Gerente y Explorador no tienen privilegios de acceso específicos, pero se pueden definir a medida. En otras palabras, puede elegir qué elementos son visibles para cada grupo.

Puede hacer que todos sean Arquitecto si considera que se necesita visibilidad de todo lo que hay en el proyecto; de lo contrario, puede designar a los miembros como miembros del proyecto con rol de Gerente o Explorador (o ambos) y controlar la visibilidad de esa manera.

Para establecer un rol distinto:

Abra Analyze
Seleccione “Proyectos”
Haga clic en el icono de miembros
Seleccione el miembro cuyo rol desea cambiar
Haga doble clic en su rol actual en la columna “Role”
Seleccione el rol deseado
Haga clic en “Update”

Administración de las variables del proyecto

Al ejecutar un proyecto o un flujo de trabajo, puede ser útil definir variables para las tareas recurrentes con el fin de reducir el desorden y ahorrar tiempo. Estas variables funcionan igual que una variable algebraica normal: permiten definir qué representa la variable y qué operación debe seguirla. PlaidCloud permite definir estas variables en el nivel del proyecto, lo que afectará a todos los flujos de trabajo de ese proyecto, o en el nivel del flujo de trabajo, lo que solo afectará a ese flujo de trabajo concreto.

Para establecer una variable en el nivel del proyecto:

Abra Analyze
Seleccione “Proyectos”
Haga clic en el icono Manage Project Variables

En la tabla de variables puede ver las variables y ver o editar sus valores actuales. También puede agregar variables nuevas o eliminar las existentes haciendo clic en el botón “New Project Variable”.

Copia de un proyecto

Copiar proyecto copia un proyecto (completo, o solo las partes que elija) en un proyecto totalmente nuevo o en un proyecto que ya existe.

Para copiar un proyecto:

Abra Analyze
Seleccione “Proyectos”
Seleccione el proyecto que desea copiar
Haga clic en el botón Acciones y elija Copiar proyecto
Elija el destino, seleccione qué se debe incluir y cuántos datos, y haga clic en Copiar proyecto
Revise el resumen de Revisar antes de copiar y haga clic en Iniciar copia

Selección de qué copiar

El árbol de selección enumera lo que contiene el proyecto, por tipo: flujos de trabajo, pasos, tablas, dimensiones, editores de datos y funciones definidas por el usuario. Deje todo marcado para copiar el proyecto completo, o marque solo las partes que desee.

No necesita averiguar de qué dependen esas partes. Todo lo que marque trae consigo sus dependencias: las tablas que lee y escribe un paso, las dimensiones que carga o contra las que asigna, las funciones definidas por el usuario a las que llama y cualquier subflujo de trabajo o macro que invoque. Los sensores de un flujo de trabajo se incluyen con el flujo de trabajo.

Los sensores copiados llegan deshabilitados. No se activa nada en la copia hasta que usted active cada sensor en el proyecto de destino. Una importación que sobrescribe los elementos duplicados no agrega un segundo sensor cuando el flujo de trabajo de destino ya lo tiene.

Copia en un proyecto nuevo

Asigne al proyecto nuevo un nombre y un ID. El ID se convierte en el nombre de su esquema y no se puede cambiar después.

Las programaciones llegan en pausa. Cuando copia un proyecto completo en uno nuevo, los eventos programados de cada flujo de trabajo llegan en pausa, para que la copia no empiece a ejecutarlos por sí sola. Cuando termina la copia, un mensaje enumera los eventos que estaban activos en el original. Para ejecutar uno en la copia, selecciónelo en Herramientas > Programador de eventos y haga clic en Habilitar seleccionados; consulte Pausar un evento.

Copia en un proyecto existente

Elija el destino en la lista de proyectos. La copia se agrega a ese proyecto en lugar de reemplazarlo.

Debe poder modificar el destino. Se rechaza una copia en un proyecto en el que usted no tiene ningún rol, así como una copia en un proyecto que se ha bloqueado para impedir cambios; esto se comprueba antes de leer o escribir nada, de modo que una copia rechazada deja el destino intacto. Además, un proyecto no se puede copiar en sí mismo.

Copiar un proyecto que restringe filas requiere un Arquitecto del proyecto. La copia es un proyecto nuevo sin restricción de acceso a filas, y la propia copia se lo indica: “This copy is not row-restricted.” Configure el Acceso a filas en la copia antes de compartirla. Copiar en un proyecto existente que restringe filas requiere igualmente uno de sus Arquitectos o un administrador del inquilino.

El destino conserva su propia configuración. Su nombre, ID, entorno de conexión de datos, valores predeterminados de almacenamiento, cuenta de documentos, tipo de acceso, listas de acceso y concesiones de acceso a filas se dejan tal como están. Solo se incorpora el contenido que haya seleccionado.

Un paso configurado en Project Default transfiere esa configuración, no una cuenta: una vez copiado, se resuelve con la cuenta predeterminada que tenga el proyecto de destino, no con la que tenía en el origen.

Cuando un elemento entrante es el mismo elemento que ya existe en el destino, usted elige qué ocurre:

Sobrescribir los elementos duplicados con los datos entrantes: la versión entrante reemplaza a la del destino.
Crear una copia nueva de los elementos duplicados: el destino conserva lo que tiene y el elemento entrante se agrega junto a él con copy al final de su nombre, y un contador si ese nombre también está ocupado.

Las variables de proyecto y de flujo de trabajo son la excepción a Crear una copia nueva: una variable se identifica por su nombre, por lo que no hay forma de agregar una segunda copia de una sin cambiarle el nombre por algo a lo que nada hace referencia. Cuando el destino ya define una variable que la copia también incluye, se conserva el valor propio del destino y la copia le indica qué variables dejó sin tocar. Sobrescribir trata las variables como todo lo demás y las reemplaza.

Esta coincidencia es por identidad, no por nombre: un elemento que procede originalmente del mismo proyecto se reconoce como el mismo elemento, mientras que dos elementos que simplemente comparten nombre se tratan como elementos distintos y ambos estarán presentes después.

Selección de cuántos datos copiar

Modo	Qué se copia
Solo estructura	Tablas, pasos y el resto de la selección, sin filas.
Datos completos	Las filas de todas las tablas, en el mismo lakehouse y entre lakehouses.
Muestra	Hasta el número de filas que indique de cada tabla, solo para un proyecto nuevo. El número puede ser de 1 a 1 000 000.

Una tabla de muestra contiene hasta ese número de filas, o todas sus filas cuando tiene menos.

Revisión de la copia

Antes de copiar nada, Revisar antes de copiar resume la copia: el proyecto de origen, adónde va, el modo de datos, el número de tablas y vistas, el tamaño, un tiempo estimado, el lakehouse de origen y el de destino, y cualquier advertencia en Tenga en cuenta. Haga clic en Iniciar copia para comenzar, o en Cancelar para volver y cambiar la selección.

Quién puede ver la copia

Una copia hecha con datos es privada para la persona que la hizo. Compártala desde el proyecto nuevo cuando esté listo. Una copia de un proyecto con seguridad a nivel de fila sigue siendo privada por el mismo motivo.

Copiar datos en un proyecto existente requiere acceso de escritura a ese proyecto.

Resultados de la copia

Cuando termina la copia, una ventana Resultados de la copia enumera el resultado de cada tabla por nombre, con el motivo de cualquier tabla que haya fallado. Haga clic en Reintentar las tablas con error para copiar de nuevo solo esas tablas; el contenido de una tabla reintentada se reemplaza. Se le notifica, por mensaje y por correo electrónico, cuando una copia termina o falla, y puede volver a abrir los resultados desde el mensaje, o más tarde seleccionando la copia en la pestaña Proyectos y eligiendo Ver resultado de la importación o la copia en el menú Acciones.

Los resultados permanecen en la copia hasta que alguien los descarte. Una vez terminada la copia, haga clic en Descartar resultado para quitarlos para todos los que puedan abrir el proyecto. No cambia nada en el proyecto, pero sus tablas con error ya no se pueden reintentar desde la ventana. Descartar requiere acceso de edición al proyecto, y el proyecto no debe estar bloqueado.

Actualizar referencias

Los pasos de flujo de trabajo de un proyecto hacen referencia a tablas y otros objetos dentro de ese proyecto. Actualizar referencias reescribe esas referencias para que apunten a la copia en lugar del original, que es casi siempre lo que se desea y es la razón por la que está activada de forma predeterminada. Si se desactiva, los pasos copiados siguen apuntando al proyecto del que proceden.

Visualización del informe del proyecto

Cuando un proyecto o un flujo de trabajo es dinámico, mantener una documentación detallada supone un reto. Para ayudar a resolver este problema, PlaidCloud ofrece la posibilidad de generar un informe en el nivel del proyecto que documenta con detalle los flujos de trabajo, los pasos de flujo de trabajo, las transformaciones definidas por el usuario, las variables y las tablas. Este informe se genera a petición y refleja el estado actual del proyecto.

Para descargar el informe:

Abra Analyze
Seleccione “Proyectos”
Haga clic en el icono de informe