Comando .alter-merge table

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.