Comando .alter-merge table

O comando .alter-merge table:

• Protege dados em colunas existentes
• Adiciona novas colunas, docstringe pastas a uma tabela existente
• Tem de ser executada no contexto de uma base de dados específica que defina o âmbito do nome da tabela

Permissões

Tem de ter, pelo menos, permissões de Administração tabela para executar este comando.

Syntax

.alter-mergetabletableName(columnName:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Necessário	Descrição
tableName	string	✔️	O nome da tabela a alterar.
columnName, columnType	string	✔️	O nome de uma coluna existente ou nova mapeada para o tipo de dados nessa coluna. A lista destes mapeamentos define o esquema da coluna de saída.
propertyName, propertyValue	string		Uma lista separada por vírgulas de pares de propriedades chave-valor. Veja as propriedades suportadas.

Nota

Se tentar alterar um tipo de coluna, o comando falhará. Em vez disso, utilize .alter column.

Dica

Utilize .show table [tableName] cslschema para obter o esquema de coluna existente antes de alterá-lo.

Propriedades suportadas

Nome	Tipo	Description
docstring	string	Texto livre que descreve a entidade a adicionar. Esta cadeia é apresentada em várias definições de UX junto aos nomes das entidades.
folder	string	O nome da pasta a adicionar à tabela.

Como o comando afeta os dados

• Os dados existentes não serão modificados ou eliminados
• Serão adicionadas novas colunas ao fim do esquema
• Os dados em novas colunas são considerados nulos

Exemplos

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

Conteúdo relacionado

Utilize o .alter comando de tabela quando quiser redefinir ainda mais as definições da tabela. Para obter mais informações, consulte .alter table.