Comando .alter-merge table
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer
El comando .alter-merge table:
- Protege los datos de las columnas existentes
- Agrega nuevas columnas,
docstring, y carpeta a una tabla existente - Debe ejecutarse en el contexto de una base de datos específica que tenga como ámbito el nombre de la tabla.
Permisos
Debe tener al menos permisos de administrador de tablas para ejecutar este comando.
Sintaxis
.alter-mergetable 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. |
Nota:
Si intenta modificar un tipo de columna, se producirá un error en el comando. En su lugar, use .alter column.
Sugerencia
Use .show table [tableName] cslschema para obtener el esquema de columna 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 no se modificarán ni eliminarán.
- Se agregarán nuevas columnas al final del esquema.
- Se supone que los datos de las nuevas columnas son NULL
Ejemplos
.alter-merge table MyTable (ColumnX:string, ColumnY:int)
.alter-merge table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")
Contenido relacionado
Use el .alter comando table cuando desee volver a definir aún más la configuración de la tabla. Para obtener más información, vea .alter table.