Partilhar via

Comando .ingest inline (push)

  • Artigo

Este comando insere dados numa tabela ao enviar os dados incluídos no comando para a tabela.

Nota

Este método de ingestão destina-se a exploração e prototipagem. Não o utilize em cenários de produção ou de volume elevado.

Permissões

Tem de ter, pelo menos, permissões de Ingestor de Tabelas para executar este comando.

Syntax

.ingestinlineintotableTableName [with(IngestionPropertyName=IngestionPropertyValue [, ...] )] <|Dados

.ingestinlineintotableTableName [with(IngestionPropertyName=IngestionPropertyValue [, ...] )] [Dados]

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
TableName string ✔️ O nome da tabela para ingerir dados. O nome da tabela é sempre relativo à base de dados em contexto e o respetivo esquema é o esquema que será assumido para os dados se não for fornecido nenhum objeto de mapeamento de esquema.
Dados string ✔️ O conteúdo de dados a ingerir. Salvo modificação em contrário pelas propriedades de ingestão, este conteúdo é analisado como CSV.
IngestionPropertyName, IngestionPropertyValue string Qualquer número de propriedades de ingestão que afetam o processo de ingestão.

Nota

Ao contrário da maioria dos comandos e consultas de gestão, o texto da parte Dados do comando não tem de seguir as convenções sintaticas do idioma. Por exemplo, os carateres de espaço em branco são importantes ou a // combinação não é tratada como um comentário.

Devoluções

O resultado é uma tabela com tantos registos como o número de partições horizontais de dados geradas ("extensões"). Se não forem geradas partições horizontais de dados, é devolvido um único registo com um ID de extensão vazio (valor zero).

Nome Tipo Description
ExtentId guid O identificador exclusivo da partição horizontal de dados que foi gerada pelo comando

Exemplos

Ingerir com <| sintaxe

O seguinte comando ingere dados numa tabela Purchases com duas colunas: SKU (do tipo string) e Quantity (do tipo long).

.ingest inline into table Purchases <|
    Shoes,1000
    Wide Shoes,50
    "Coats black",20
    "Coats with ""quotes""",5

Ingerir com sintaxe entre parênteses

O seguinte comando ingere dados numa tabela Logs com duas colunas: Date (do tipo datetime) e EventDetails (do tipo dynamic).

.ingest inline into table Logs
    [2015-01-01,"{""EventType"":""Read"", ""Count"":""12""}"]
    [2015-01-01,"{""EventType"":""Write"", ""EventValue"":""84""}"]

Conteúdo relacionado