Comando .create table based-on
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
Cria uma nova tabela vazia com base em uma tabela existente. Esse comando deve ser executado no contexto de um banco de dados específico.
Observação
Todas as propriedades da tabela de origem são copiadas para a nova tabela, com as seguintes exceções:
- Política de atualização
- Entidades autorizadas: ao usar o
.create table based-on
comando, a entidade atual é adicionada aos administradores da tabela.
Permissões
Você deve ter pelo menos permissões de administrador de banco de dados para executar esse comando.
Sintaxe
.create
table
nome_da_based-on
tabela otherTable [ifnotexists
] [with
(
nome_da_=
propriedade propertyValue [,
...]])
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Digitar | Obrigatória | Descrição |
---|---|---|---|
ifnotexists |
string |
Se especificada, a tabela só será criada se ainda não existir. | |
tableName | string |
✔️ | O nome da tabela a ser criada. O nome case-senestive deve ser exclusivo no banco de dados. |
otherTable | string |
✔️ | O nome de uma tabela existente a ser usada como origem para as colunas, docstring e pasta da tabela que está sendo criada. |
propertyName, propertyValue | string |
Uma lista separada por vírgulas de pares de propriedades chave-valor. Consulte as propriedades suportadas. |
Propriedades aceitas
Nome | Tipo | Descrição |
---|---|---|
docstring |
string |
Texto livre que descreve a entidade a ser adicionada. Essa cadeia de caracteres é apresentada em várias configurações de experiência do usuário ao lado dos nomes das entidades. O valor padrão é Created com base em <tableName>. |
folder |
string |
O nome da pasta onde adicionar a tabela. O padrão é a mesma pasta que tableName. |
Devoluções
Esse comando retorna o esquema da nova tabela no formato JSON, semelhante à execução do seguinte comando:
.show table MyLogs schema as json
Observação
- Se a tabela já existir:
- Se
ifnotexists
flag for especificado, o comando será ignorado (nenhuma alteração aplicada). - Se
ifnotexists
o sinalizador NÃO for especificado, um erro será retornado.
- Se
Exemplo
.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")