Compartir a través de

Comando .alter table

  • Artículo

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

El comando .alter table:

  • Protege los datos en columnas "conservadas"
  • Reordena columnas de tabla
  • Establece un nuevo esquema de columna, docstring, y carpeta en una tabla existente, sobrescribir el esquema de columna existente, docstring, y la carpeta
  • Debe ejecutarse en el contexto de una base de datos específica que tenga como ámbito el nombre de la tabla.

Advertencia

El uso incorrecto del .alter comando puede provocar la pérdida de datos.

Permisos

Debe tener al menos permisos de administrador de tablas para ejecutar este comando.

Sintaxis

.altertable tableName (columnName:columnType [ ...]) [with (, propertyName = propertyValue [, ...]])

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
tableName string ✔️ Nombre de la tabla que se va a modificar.
columnName, columnType string ✔️ Nombre de una columna existente o nueva asignada al tipo de datos de esa columna. La lista de estas asignaciones define el esquema de columna de salida.
propertyName, propertyValue string Lista separada por comas de pares de propiedades clave-valor. Consulte las propiedades admitidas.

Advertencia

Las columnas existentes que no se especifican en el comando se quitarán. Esto podría provocar una pérdida de datos inesperada.

Sugerencia

Use .show table [tableName] cslschema para obtener el esquema de tabla existente antes de modificarlo.

Propiedades admitidas

Nombre Escribir Descripción
docstring string Texto libre que describe la entidad que se va a agregar. Esta cadena se presenta en varias configuraciones de experiencia del usuario junto a los nombres de entidad.
folder string Nombre de la carpeta que se va a agregar a la tabla.

Cómo afecta el comando a los datos

  • Los datos existentes en columnas enumeradas en el comando no se modificarán
  • Se eliminarán los datos existentes en columnas que no aparecen en el comando.
  • Se agregarán nuevas columnas al final del esquema.
  • Se supone que los datos de las nuevas columnas son NULL
  • La tabla tendrá las mismas columnas, en el mismo orden, que se especificó.

Nota:

Si intenta modificar un tipo de columna, se producirá un error en el comando. En su lugar, use .alter column.

Advertencia

  • Ingesta de datos que ignora el orden de las columnas y se produce en paralelo con .alter table riesgos para ingerir datos en las columnas incorrectas. Para evitar esto, asegúrese de que la ingesta usa un objeto de asignación o detiene la ingesta mientras se ejecuta el .alter table comando .
  • La ingesta de datos puede modificar el esquema de columna de una tabla. Tenga cuidado de no quitar accidentalmente las columnas deseadas que se agregaron durante la ingesta.

Ejemplos

.alter table MyTable (ColumnX:string, ColumnY:int) 
.alter table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")

Contenido relacionado