Edición de un esquema de tabla

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. Detalla las implicaciones y las dependencias de los cambios en el esquema de la tabla sobre los objetos y las asignaciones a los que se hace referencia.

Precaución

  • Las ingestas existentes, las asignaciones de ingesta, las directivas de actualización, las funciones, las exportaciones, las vistas materializadas y otras operaciones relacionadas podrían producir un error después de editar el esquema de la tabla. Consulte Dependencias y asegúrese de editar la implementación de los mapeos de ingesta, las directivas de actualización, las funciones, la exportación y las vistas materializadas, según corresponda.

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. La matriz siguiente indica las implicaciones de las modificaciones del esquema.

Edición del esquema Dependencia
Cambiar el nombre de las tablas Vistas materializadas:
* De forma predeterminada, todas las vistas materializadas que hacen referencia directamente al nombre de tabla anterior se actualizan 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 * Añadir 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. Debe actualizar manualmente las asignaciones de ingesta.

Prerrequisitos

Cambiar de nombre una tabla

Al cambiar el nombre de una tabla, todas las referencias a esa tabla en las asignaciones de ingesta se actualizan automáticamente. En algunos casos, es necesario actualizar manualmente las asociaciones de tablas y las referencias. Antes de cambiar el nombre de una tabla, revise Dependencias.

  1. Vaya a la base de datos KQL deseada y, en el panel Explorador, expanda Tablas.

  2. Seleccione una tabla de la lista y abra el menú Más [...].

    Captura de pantalla del menú de opciones adicionales de la tabla con Modificar esquema resaltado.

  3. En la ventana Editar esquema de tabla , edite el nombre de la tabla. Opcionalmente, edite la descripción de la tabla.

    Captura de pantalla del esquema de edición de la tabla con el campo nombre de tabla resaltado.

  4. 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.

    Captura de pantalla del visor de comandos y la sección de dependencias con el interruptor de Actualizar automáticamente las vistas materializadas resaltado.

  5. Seleccione Actualizar y, en la ventana de confirmación, escriba de nuevo el nombre de la tabla y seleccione Editar esquema de tabla.

    Captura de pantalla de la ventana de confirmación con el campo nombre de tabla resaltado.

Edición de columnas de tabla

Al cambiar el nombre o agregar columnas a una tabla, todas las referencias a esa tabla de las asignaciones de ingesta se actualizan automáticamente. En algunos casos, es necesario actualizar manualmente las asignaciones de tabla y las referencias. Antes de editar las columnas de tabla, revise Dependencias.

  1. Navegue hasta la base de datos KQL deseada. En el panel del explorador, expanda Tablas.

  2. Seleccione una tabla de la lista y abra el menú Más [...].

    Captura de pantalla del menú de opciones adicionales de la tabla con Modificar esquema resaltado.

  3. 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.

  4. Seleccione un tipo de datos para la columna. El tipo de columna predeterminado es string pero puede cambiarlo en el menú desplegable del campo Tipo de columna.

  5. Seleccione Agregar columna para agregar más columnas.

  6. 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.

    Captura de pantalla del visualizador de comandos con asignaciones de actualización automática habilitadas en la sección de dependencias.

  7. Si es necesario, actualice la asignación de ingesta de datos.

Contenido relacionado

  • Last updated on