Compartilhar via


Gerenciamento de tabelas

Este tópico discute o ciclo de vida das tabelas e os comandos de gerenciamento associados que são úteis para explorar, criar e alterar tabelas.

Selecione os links na tabela abaixo para obter mais informações sobre eles.

Para obter informações sobre como otimizar o esquema de tabela, consulte Práticas recomendadas de otimização de esquema.

Comandos Operação
.alter table docstring, .alter table folder Gerenciar propriedades de exibição de tabela
.create ingestion mapping, .show ingestion mappings, .alter ingestion mapping, .drop ingestion mapping Gerenciar mapeamento de ingestão
.create tables, .create table, .alter table, .alter-merge table, .drop tables, .drop table, .undo drop table, .rename table Criar/modificar/descartar tabelas
.show tables .show table details.show table schema Enumerar tabelas em um banco de dados
.ingest, .set, .append, .set-or-append (consulte Visão geral da ingestão de dados). Ingestão de dados em uma tabela
.clear table data Limpa todos os dados de uma tabela

Convenções de nomenclatura CRUD para tabelas

(Confira detalhes completos nas seções vinculadas à tabela acima.)

Sintaxe de comando Semântica
.create entityType entityName ... Se existir uma entidade desse tipo e nome, retornará a entidade. Caso contrário, crie a entidade.
.create-merge entityType entityName... Se existir uma entidade desse tipo e nome, mescle a entidade existente com a entidade especificada. Caso contrário, crie a entidade.
.alter entityType entityName ... Se uma entidade desse tipo e nome não existir, erro. Caso contrário, substitua-a pela entidade especificada.
.alter-merge entityType entityName ... Se uma entidade desse tipo e nome não existir, erro. Caso contrário, mescle-o com a entidade especificada.
.drop entityType entityName ... Se uma entidade desse tipo e nome não existir, erro. Caso contrário, solte-o.
.drop entityType entityName ifexists ... Se uma entidade desse tipo e nome não existir, retorne. Caso contrário, solte-o.

Observação

"Merge" é uma mesclagem lógica de duas entidades:

  • Se uma propriedade for definida para uma entidade, mas não para a outra, ela aparecerá com seu valor original na entidade mesclada.
  • Se uma propriedade for definida para ambas as entidades e tiver o mesmo valor em ambas, ela aparecerá uma vez com esse valor na entidade mesclada.
  • Se uma propriedade for definida para ambas as entidades, mas tiver valores diferentes, um erro será gerado.