Ir al contenido

Administración de tablas y vistas

PlaidCloud ofrece la posibilidad de organizar y administrar tablas, incluidas las etiquetas. Las tablas están disponibles para todos los flujos de trabajo de un proyecto y cuentan con muchas herramientas y opciones.

Además de las tablas, PlaidCloud ofrece también vistas basadas en los datos de las tablas. El uso de vistas permite actualizaciones instantáneas cuando cambian las tablas subyacentes, además de ahorrar espacio de almacenamiento de datos.

Las opciones incluyen:

  • La misma tabla puede existir en varias rutas de la jerarquía (jerarquías alternativas)
  • Las tablas se pueden etiquetar para facilitar su búsqueda e inclusión en los procesos de PlaidCloud
  • Las tablas pueden tener versiones
  • Las tablas se pueden publicar para que estén disponibles en las visualizaciones de los paneles de control

PlaidCloud utiliza un sistema basado en rutas para organizar las tablas, como el que se usa para navegar por una serie de carpetas, lo que permite una organización más flexible y lógica de las tablas. Con este sistema, las tablas pueden moverse dentro de una jerarquía, o se pueden crear varias referencias a una misma tabla desde distintas ubicaciones de la jerarquía (jerarquías alternativas). La capacidad de administrar las tablas con este método permite que la estructura refleje las necesidades operativas, de informes y de control.

Use Filtro en la parte inferior de la lista, junto al recuento de filas, para buscar en los nombres y las etiquetas de las tablas. Pulse / o Ctrl/Cmd+F para ir a él. El mismo filtro se aplica al árbol y a la lista plana. El interruptor Todos | Publicado junto al filtro limita la lista a las tablas publicadas; está establecido en Todos de forma predeterminada y se aplica tanto en el árbol como en la lista plana.

La carpeta Por flujo de trabajo al final de la pestaña Tablas agrupa las tablas bajo cada flujo de trabajo que las lee o las escribe. Abra un flujo de trabajo para ver sus tablas. La carpeta es una vista de las mismas tablas, por lo que no puede mover ni copiar nada desde ella.

Seleccione Buscar columna en la barra de herramientas de la pestaña Tablas para encontrar las tablas que tienen una columna con un nombre determinado. La búsqueda lee los nombres de las columnas, no los datos, por lo que es rápida, y solo encuentra tablas que ya se han creado. La ventana se abre con la última búsqueda que ejecutó en ese proyecto desde que abrió el proyecto, si ejecutó alguna.

Escriba al menos dos caracteres y los resultados se actualizan mientras escribe, o pulse Intro para buscar de inmediato. Cuando se muestran los resultados de lo que ha escrito, Intro en el cuadro de búsqueda selecciona la tabla resaltada, igual que en una fila. Elija cómo se compara el nombre:

  • Exacto: el nombre completo de la columna, sin distinguir mayúsculas de minúsculas
  • Contiene: parte del nombre de la columna, sin distinguir mayúsculas de minúsculas. Es el valor predeterminado.
  • Aproximado: nombres parecidos, sin distinguir mayúsculas de minúsculas, espacios, guiones bajos ni otros separadores, y tolerando pequeñas erratas. Las coincidencias más cercanas aparecen primero.

La ventana recuerda en ese navegador el tipo de coincidencia que eligió por última vez. Mientras el cuadro de búsqueda está vacío, muestra sus últimas cinco búsquedas en el proyecto en ese navegador; seleccione una para ejecutarla de nuevo. Una búsqueda se considera ejecutada y se añade a la lista cuando pulsa Intro, la selecciona de la lista o actúa sobre sus resultados.

Cada tabla que coincide es una fila, con su nombre, su ruta y las tres primeras columnas coincidentes. La línea situada sobre los resultados cuenta las tablas encontradas hasta el momento mientras se ejecuta la búsqueda. Cuando no hay coincidencias con Exacto o Contiene, seleccione ¿Probar con Aproximado? para buscar de nuevo con Aproximado. Si la búsqueda falla o se detiene antes de tiempo, seleccione Reintentar. Cuando no se pudieron leer las columnas de algunas tablas, los resultados indican que pueden estar incompletos.

Cuando los resultados incluyen más de un nombre de columna, unos chips situados sobre la lista nombran hasta 12 de ellos, los más frecuentes primero, cada uno con el número de tablas que lo tienen. Seleccione un chip para enumerar solo las tablas con esa columna y selecciónelo de nuevo para enumerarlas todas.

Expanda una fila para ver:

  • Columnas coincidentes: cada columna coincidente, con su tipo cuando es texto, entero, número, fecha, marca de tiempo o booleano. Una columna mostrada en el color de advertencia tiene un tipo distinto en otras tablas de los resultados; pase el cursor sobre ella para ver los tipos.
  • Alimentada por: las tablas que leen los pasos que escriben esta tabla, cada una con el nombre del paso
  • Alimenta a: las tablas que escriben los pasos que leen esta tabla, cada una con el nombre del paso

Solo se enumeran los pasos del mismo proyecto.

Para actuar sobre los resultados:

  • Haga doble clic en una fila, o pulse Intro sobre ella, para cerrar la ventana y seleccionar esa tabla en la pestaña Tablas. Si una búsqueda de columnas mostrada en el árbol o el conmutador Todos | Publicado oculta la tabla, se borra y un mensaje se lo indica. Pulse Ctrl+Intro, o Cmd+Intro en un Mac, para abrir la tabla en el Explorador de tablas. Las teclas de flecha arriba y abajo del cuadro de búsqueda se desplazan entre las filas.
  • Seleccione Mostrar en el árbol para limitar el árbol y la lista aplanada a las tablas de los resultados, o a las del chip seleccionado, y abrir las carpetas del árbol que las contienen. Un chip situado sobre la lista nombra la búsqueda y cuenta sus tablas. Seleccione el chip para abrir la búsqueda de nuevo, o la × que contiene para mostrar todas las tablas. Al actualizar la pestaña Tablas se ejecuta la búsqueda de nuevo.
  • Seleccione Copiar para copiar las tablas enumeradas, una por línea, con el nombre, la ruta, las columnas coincidentes y sus tipos de cada tabla separados por tabuladores.

Mostrar en el árbol y Copiar están disponibles cuando la búsqueda termina con al menos una tabla.

Un asistente de IA conectado mediante MCP encuentra las mismas tablas con table_find(column=...). Coincide con el nombre completo, con una parte, con su inicio o con su final, o con nombres parecidos mediante column_match='fuzzy', y devuelve los tipos de las columnas coincidentes y, en una coincidencia aproximada, lo cerca que está la mejor columna.

Para encontrar qué tablas contienen un valor, elija Buscar valores en los datos… (lento) en el menú Acciones de la pestaña Tablas, o haga clic con el botón derecho en una tabla y elíjalo para buscar solo en esa tabla. Escriba el valor, elija Contiene para coincidir con parte de un valor y seleccione Buscar. Cada tabla que contiene el valor se enumera con las columnas en las que aparece y algunos de los valores coincidentes. Haga doble clic en una tabla, o pulse Intro sobre ella, para abrirla en el Explorador de tablas. Una columna abre la tabla filtrada por las filas que coinciden.

Antes de buscar, tenga en cuenta que:

  • La búsqueda lee todas las filas de todas las tablas buscadas, por lo que puede ser muy lenta y usar muchos recursos del almacén. La ventana se lo advierte y los botones de búsqueda permanecen desactivados hasta que termina una búsqueda.
  • Solo ve las filas que ya podría abrir. La seguridad a nivel de fila se aplica a todas las búsquedas.
  • El historial de consultas de su almacén registra los valores que busca.
  • La búsqueda abarca las columnas de texto de las tablas. Las tablas que no se han creado se omiten y se nombran en una advertencia.
  • Los resultados llegan por páginas. Cuando la línea de estado indica que la búsqueda se detuvo antes de tiempo, elija Buscar más para continuar con las tablas que aún no se han buscado.

Un asistente de IA conectado mediante MCP usa table_value_search. Devuelve las tablas y columnas que contienen el valor, nunca los valores en sí. Cuando pide al asistente de IA de un proyecto que encuentre un valor, Weave envía los nombres de las tablas y columnas coincidentes al proveedor del modelo de lenguaje.

Para convertir un archivo CSV en una tabla nueva de este proyecto:

  1. Arrastre el archivo desde su computadora a la lista Tablas del proyecto, o elija Nuevo > Tabla desde archivo CSV en la barra de herramientas y suelte el archivo en el cuadro o haga clic en Elegir un archivo CSV.
  2. PlaidCloud carga el archivo en su Personal Temp Drive, o en el Temp Drive del espacio de trabajo si usted no tiene uno, y lo importa en una tabla nueva en el nivel superior de la lista, con el nombre del archivo: Sales Data.csv pasa a ser sales_data. Si el proyecto ya tiene una tabla con ese nombre, la nueva recibe un número, como sales_data_2.
  3. La lista se actualiza con la tabla nueva seleccionada, y Sus datos de un vistazo se abre sobre ella. Consulte Comience con su propio CSV para ver lo que muestra el panel.

Solo se aceptan archivos que terminan en .csv. Necesita permiso para crear tablas y para escribir en el almacenamiento de documentos, y un proyecto bloqueado no acepta un CSV hasta que se desbloquea. Si la importación falla, la ventana indica el motivo y su proyecto queda como estaba. PlaidCloud elimina el archivo cargado de la unidad temporal una vez que ha terminado la importación, haya tenido éxito o no; si no lo hace, la unidad temporal lo elimina después de un día.

Para mover una tabla:

  1. Arrástrela a la carpeta donde desea ubicarla

Para mover una tabla al nivel superior del proyecto, arrástrela al espacio vacío debajo de la última fila. En los selectores de carpeta, / es el nivel superior del proyecto.

Para cambiar el nombre de una tabla:

  1. Haga clic con el botón derecho en la tabla
  2. Seleccione la opción de cambiar el nombre
  3. Escriba el nombre nuevo y guárdelo
  4. La tabla tiene ahora un nombre nuevo, pero conserva su identificador único original.

Para borrar una tabla:

  1. Seleccione las tablas en la jerarquía ‘
  2. Haga clic en el botón de borrar de la barra de herramientas superior.

Nota: puede borrar una sola tabla o varias

Para eliminar una tabla:

  1. Seleccione las tablas en la jerarquía
  2. Haga clic en el botón de eliminar de la barra de herramientas superior
  3. La operación de eliminación comprobará si la tabla está en uso en pasos de flujos de trabajo o en vistas. Si es así, se le pedirá que quite esas asociaciones antes de poder eliminarla.

Nota: también puede forzar la eliminación de las tablas. La eliminación forzada deja referencias rotas, por lo que debe usarse con moderación.

La ventana de eliminación muestra cuándo se leyó la tabla por última vez, por ejemplo Last read 3 days ago by una persona o un paso, para que pueda distinguir una tabla que nadie usa de una que sigue en uso. PlaidCloud obtiene este dato del historial de consultas de su propio almacén y excluye las lecturas hechas por sus propias tareas de mantenimiento.

Almacén Qué se necesita
Snowflake Las lecturas provienen de Access History, que Snowflake registra con hasta unas 3 horas de retraso. El rol de la conexión necesita el rol de base de datos SNOWFLAKE.GOVERNANCE_VIEWER (IMPORTED PRIVILEGES en la base de datos SNOWFLAKE también funciona). Snowflake Standard edition no tiene Access History.
Databricks Las lecturas provienen de la tabla de linaje, que Databricks también registra con retraso, por lo que es posible que una lectura reciente aún no aparezca. La identidad de la conexión necesita USE CATALOG en system, USE SCHEMA en system.access y SELECT en system.access.table_lineage.
PlaidCloud Lakehouse El historial de lecturas aún no está disponible. La ventana muestra Read history incomplete.

Cuando conecta su almacén, la comprobación de la conexión recomienda cualquiera de estos permisos que falte, cada uno con la instrucción que debe ejecutarse. Son recomendados, no obligatorios: sin ellos el almacén se conecta y la ventana muestra Read history incomplete.

Cuando PlaidCloud no puede leer todo el historial, la línea dice Read history incomplete y nunca informa de “sin lecturas” en su lugar. Cualquier persona con acceso SQL directo a su almacén puede establecer una etiqueta de sesión que cambia cómo se etiquetan sus propias lecturas.

Un asistente de IA conectado mediante MCP obtiene la misma respuesta con table_describe(include=['last_read']).

Al seleccionar una tabla se abre su panel de detalles. Su sección Columnas enumera cada columna con su Tipo y su Descripción, que proviene de Propiedades de la columna. Apunte a una fila para leer una descripción larga completa.

Una tabla que en este momento no está en el almacén, porque sus datos caducaron o ningún paso la ha creado, no tiene columnas que enumerar. La sección lo indica y muestra cuántas columnas tiene la tabla. Ejecute un paso que escriba la tabla para enumerarlas.

Al seleccionar una tabla se abre su panel de detalles, que enumera los pasos de flujo de trabajo que la utilizan:

  • Tabla creada por: pasos que escriben en la tabla
  • La tabla contribuye a: pasos que leen de ella
  • Puede hacer referencia a esta tabla: pasos que llegan a una tabla mediante una variable que no se puede resolver. Esta sección solo aparece cuando hay tales pasos.

Al seleccionar otra tabla, estas listas se borran de inmediato. Un paso de otro proyecto que comparte los datos de este proyecto, como un paso Importar: tabla externa del proyecto que lee esta tabla, también aparece en la lista, sin su nombre ni su flujo de trabajo, porque es posible que usted no tenga acceso a ese proyecto. Esos pasos pueden aparecer un momento después que el resto.

Un paso puede nombrar una tabla directamente, o llegar a ella mediante una ruta que contiene una variable, como /Periods/{period}/Sales. Cuando esa variable tiene un valor actual, el paso aparece en las dos primeras listas con un icono de información a su lado. Pase el puntero sobre la fila para ver la ruta tal como la almacena el paso.

Trate esas filas como la respuesta más débil que son. Describen lo que tocaría una ejecución que comenzara ahora, no todo lo que ha tocado la tabla alguna vez. Si cambia la variable, se lee una tabla distinta.

Algunas variables no se pueden resolver. O bien nada ha establecido la variable, o bien el valor que usa una ejecución no proviene de lo almacenado: un paso Worklow Loop toma sus variables de los datos a medida que itera, un paso Set Variable asigna durante la ejecución, a una macro le entrega sus variables el paso que la llama, y una ejecución iniciada por un sensor lleva los detalles propios de ese sensor. En cada caso, lo que se almacena entre ejecuciones es un resto de la última y no un valor en el que confiar. En lugar de resolverlas a una tabla que puede ser la incorrecta, PlaidCloud enumera los pasos por nombre en Puede hacer referencia a esta tabla, con la variable que no pudo resolver, para que pueda abrirlos y comprobarlos.

Un paso que su rol no puede ver también aparece en la lista, para que sepa que la tabla está en uso, pero sin su nombre ni su flujo de trabajo, y no puede abrirlo. Aun así cuenta cuando elimina la tabla. Un paso que sí puede ver aparece sin ningún flujo de trabajo que su rol oculte. A un Arquitecto no se le oculta nada.

Nota: cuando elimina tablas de la lista Tablas, un paso que llega a una tabla mediante una ruta, con variable o sin ella, cuenta como que la usa, aunque su variable no se pueda resolver. La ventana de eliminación enumera el paso, y la eliminación se realiza solo si usted la fuerza.

Para agregar una carpeta nueva:

  1. Haga clic en el botón Carpeta nueva de la barra de herramientas

Para agregar una carpeta a una carpeta existente:

  1. Haga clic con el botón derecho en la carpeta
  2. Seleccione Carpeta nueva

Cuando la selección está dentro de una carpeta, el aviso para el nombre de la carpeta nueva también tiene Crear en el nivel superior. Márquela para colocar la carpeta nueva en el nivel superior del proyecto.

Los datos de las tablas se ven con el Explorador de datos. El Explorador de datos ofrece una vista de cuadrícula de los datos, así como un resumen columna por columna de los valores y las estadísticas. Están disponibles tanto el filtrado con señalar y hacer clic como la exportación a formatos de archivo conocidos. Las selecciones de filtro también se pueden guardar como un paso Extract que se puede usar en un flujo de trabajo.

Las visualizaciones de los paneles de control se limitan intencionadamente a las tablas que se han publicado. Al publicar una tabla, puede indicar un nombre único que distinga los datos. Esto puede ser útil cuando la tabla tiene un nombre más oscuro en la parte del flujo de trabajo que la generó, pero necesita un nombre más claro para quienes crean paneles de control.

Las tablas publicadas no tienen rutas asociadas. Aparecerán como una lista de tablas para usar en el área de paneles de control.

Marcar una tabla para los roles de visualización

Sección titulada «Marcar una tabla para los roles de visualización»

La visualización de las tablas por parte de distintos roles se puede controlar haciendo clic en las casillas Explorador o Gerente. Si es necesario actualizar varias tablas, seleccione las tablas en la jerarquía y elija el rol de visualización que desee en el menú Acciones de la barra de herramientas superior.

Notas para describir el contenido de las tablas

Sección titulada «Notas para describir el contenido de las tablas»

Agregue una nota a una tabla para ayudar a entender los datos.

Ver la forma, el tamaño y la hora de la última actualización de una tabla

Sección titulada «Ver la forma, el tamaño y la hora de la última actualización de una tabla»

El número de filas y de columnas y el tamaño de los datos de cada tabla se muestran en la jerarquía de tablas. En las tablas muy grandes (de varios millones de filas), el recuento de filas puede ser una estimación, y se mostrará un indicador de recuento aproximado de filas.

Para ver y editar otros atributos de la tabla:

  1. Seleccione una tabla
  2. Haga clic para ver el formulario de contexto de la tabla a la derecha.

Para duplicar una tabla:

  1. Seleccione la tabla
  2. Haga clic en el botón de duplicar de la barra de herramientas superior.

Crear una aplicación Panel a partir de una tabla

Sección titulada «Crear una aplicación Panel a partir de una tabla»

Seleccione una tabla o una vista y elija Crear aplicación Panel en el menú Nuevo o en el menú contextual. Se abre el cuadro de diálogo Nueva aplicación Studio con el proyecto y la tabla ya elegidos. La aplicación toma el nombre de la tabla; cámbielo si lo desea y después elija Crear, y Panel Studio la abre con Weave listo para crear su primera página. El comando está disponible cuando selecciona una sola tabla o vista, tiene acceso de edición al proyecto y el proyecto no es de solo lectura. Consulte Creación de una aplicación Panel.

La lista Tablas muestra las columnas Datos actuales, Historial, Días de viaje en el tiempo y Nota junto al tamaño de cada tabla. Días de viaje en el tiempo es el valor propio de la tabla; 1 significa que usa el valor predeterminado del proyecto. La barra de estado situada debajo de la lista muestra el total del proyecto: cuánto almacena, y cuánto de eso son datos actuales y cuánto es historial. Los tamaños marcados como Estimado provienen de la forma de la tabla hasta que PlaidCloud la mide.

Elija Almacenamiento en el menú Acciones para abrir la ventana Almacenamiento del proyecto, con sugerencias para liberar espacio y los ajustes de time travel. Consulte Administración del almacenamiento.

Crear un editor de datos a partir de una tabla

Sección titulada «Crear un editor de datos a partir de una tabla»

Puede convertir una tabla en un editor de datos configurado en un solo paso: seleccione la tabla y elija Crear editor de datos a partir de tabla en el menú Nuevo o en el menú contextual. PlaidCloud examina las columnas de la tabla y crea previamente los controles de entrada del editor. Consulte Crear un editor de datos a partir de una tabla para ver los detalles.