Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo, aprenderá a cambiar el nombre de las tablas y a editar el esquema de una tabla agregando, cambiando el nombre y quitando columnas. Se describen las implicaciones y dependencias de los cambios en el esquema de las tablas sobre los objetos y mapeos referenciados.
Precaución
- Las ingestas existentes, las asignaciones de ingesta, las políticas de actualización, las funciones, las exportaciones, las vistas materializadas y otras operaciones relacionadas pueden fallar después de editar el esquema de la tabla. Consulte Dependencias y asegúrese de editar la implementación de las asignaciones de ingestión, actualice las políticas, funciones, exportaciones y vistas materializadas en consecuencia.
Dependencias
La edición del esquema de tabla puede provocar errores de ingesta y consulta debido a dependencias que hacen referencia al nombre de la tabla o a las columnas de la tabla. Las implicaciones de las modificaciones de esquema se indican en la siguiente matriz.
| Edición del esquema | Dependencia |
|---|---|
| Cambiar el nombre de las tablas |
Vistas materializadas: * De forma predeterminada, todas las vistas materializadas que hacen referencia al nombre de tabla anterior se actualizan directamente para apuntar al nuevo nombre, de forma transaccional. * Si se hace referencia al nombre de la tabla desde una función almacenada invocada por la consulta de vista, debe actualizar manualmente la referencia de vista materializada mediante .alter materialized-view. |
| Cambiar el nombre de las columnas | * Renombrar una columna actualiza automáticamente todas las referencias a ella en los mapeos de ingesta. * Renombrar una columna preserva las transformaciones existentes en tus mapeos. |
| Adición de columnas | * Agregar una nueva columna no actualiza automáticamente los mapeos de ingesta. Si desea que se incluya la nueva columna, debe actualizar manualmente los mapeos.
* La edición del esquema no actualiza la asignación de datos entrantes a columnas de tabla durante la ingesta. * Después de agregar columnas, asegúrese de actualizar el mapeo para que los datos se importen correctamente. Para obtener más información sobre cómo actualizar la asignación de ingesta, vea Comando de asignación de ingesta .alter. |
| Tipo de columna | No se admite la edición de un tipo de columna mediante la opción Editar esquema de tabla, ya que cambiar un tipo de columna provocaría la pérdida de datos. |
| Quitar columnas | * Eliminar una columna la elimina de todos los mapeos de ingesta. * Eliminar una columna es irreversible y puede resultar en la pérdida de datos. No se pueden consultar datos en la columna quitada. * Cautela Si elimina una columna, guarde y vuelva a agregarla, los datos no se restaurarán. Se comporta como una nueva columna y las asignaciones de ingesta no se actualizan. Deberá actualizar manualmente los mapeos de ingesta. |
Prerrequisitos
- Un área de trabajo con una capacidad habilitada para Microsoft Fabric
- Una base de datos KQL con permisos de edición
- Las modificaciones de esquema de tabla no se admiten cuando hay una conexión oneLake activa. Deshabilite la disponibilidad de OneLake antes de cambiar el nombre de una tabla o editar columnas de tabla. Puede habilitarla más adelante y se guarda una nueva copia en OneLake.
Cambiar de nombre una tabla
Cambiar el nombre de una tabla actualiza automáticamente todas las referencias a ella en los mapas de ingesta. En algunos casos, las asignaciones de tablas y las referencias requieren una actualización manual. Revise Dependencias antes de cambiar el nombre de una tabla.
Vaya a la base de datos KQL deseada y, en el panel Explorador, expanda Tablas.
Seleccione una tabla de la lista y abra el menú Más [...].
En la ventana Editar esquema de tabla , edite el nombre de la tabla. Opcionalmente, edite la descripción de la tabla.
En la sección Dependencias , revise los objetos a los que se hace referencia.
De forma predeterminada, la actualización automática de vistas materializadas está habilitada. Puede ver las actualizaciones del comando en el Visor de comandos.
Si es necesario, deshabilite Actualización automática de vistas materializadas. Asegúrese de revisar las implicaciones en Dependencias y, si es necesario, actualice manualmente la asignación de ingesta de tablas.
Seleccione Actualizar y, en la ventana de confirmación, escriba de nuevo el nombre de la tabla y seleccione Editar esquema de tabla.
Edición de columnas de tabla
Cambiar el nombre y agregar columnas a una tabla actualiza automáticamente todas las referencias a ella en los mapeos de ingesta. En algunos casos, los mapeos de tablas y las referencias necesitan una actualización manual. Revise Dependencias antes de editar las columnas de la tabla.
Vaya a la base de datos KQL deseada y, en el panel del explorador, expanda Tablas.
Seleccione una tabla de la lista y abra el menú Más [...].
Para agregar una nueva columna, escriba un nombre de columna en la parte inferior de la lista de columnas. El nombre de columna debe comenzar con una letra y puede contener números, puntos, guiones o caracteres de subrayado.
Seleccione un tipo de datos para la columna. El tipo de columna predeterminado es
string, pero se puede modificar en el menú desplegable del campo Tipo de columna.Seleccione Agregar columna para agregar más columnas.
En la sección Dependencias , revise los objetos a los que se hace referencia.
De forma predeterminada, la actualización automática de asignaciones está habilitada. Puede ver las actualizaciones del comando de mapeo de ingesta en el visor de comandos.
Si es necesario, deshabilite Actualización automática de asignaciones. Asegúrese de revisar las implicaciones en Dependencias y, si es necesario, actualice manualmente la asignación de ingesta de tablas.
Si es necesario, actualice la asignación de ingesta de datos.
Contenido relacionado
- Creación de una tabla vacía
- Asignación de ingesta de datos mapeo