Comando .alter table
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 tableriesgos 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 tablecomando . - 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
- Use
.alter-mergecuando desee mantener la configuración de la tabla e invalidar o expandir solo determinadas columnas. Para obtener más información, vea .alter-merge table. - Para cambiar la directiva de retención de tablas, consulte .alter table policy retention.
- Para cambiar la directiva de almacenamiento en caché de tablas, consulte .alter table policy caching(Almacenamiento en caché de directivas de .alter table).
- Para cambiar la directiva de actualización de tablas, consulte .alter table policy update.
- Para cambiar la directiva de combinación de tablas, consulte .alter table policy merge.