. inserimento comando inline (push).ingest inline command (push)

Questo comando inserisce i dati in una tabella eseguendo il push dei dati incorporati inline nel testo del comando stesso.This command ingests data into a table by "pushing" the data that is embedded inline, in the command text itself.

Nota

Questo comando viene usato per il testing ad hoc manuale.This command's used for manual ad-hoc testing. Per l'uso in produzione, è consigliabile usare altri metodi di inserimento più adatti per il recapito in blocco di grandi quantità di dati, ad esempio l'inserimento dall'archiviazione.For production use, we recommended that you use other ingestion methods that are better for bulk delivery of huge amounts of data, such as ingest from storage.

SintassiSyntax

.ingest``inline into table TableName [ with ( IngestionPropertyName = IngestionPropertyValue [ , ...] ) ] <| Dati di.ingest inline into table TableName [with ( IngestionPropertyName = IngestionPropertyValue [, ...] )] <| Data

ArgomentiArguments

  • TableName è il nome della tabella in cui inserire i dati.TableName is the name of the table to ingest data into. Il nome è sempre correlato al database nel contesto.The name is always related to the database in context. Lo schema della tabella è lo schema che verrà utilizzato per i dati se non viene fornito alcun oggetto mapping di schema.The table schema is the schema that will be assumed for the data if no schema-mapping object is provided.

  • I dati sono il contenuto dei dati da inserire.Data is the data content to ingest. Se non diversamente modificato dalle proprietà di inserimento, questo contenuto viene analizzato come CSV.Unless otherwise modified by the ingestion properties, this content is parsed as CSV.

Nota

Diversamente dalla maggior parte dei comandi e delle query di controllo, il testo della parte di dati del comando non deve seguire le convenzioni sintattiche del linguaggio.Unlike most control commands and queries, the text of the Data part of the command doesn't have to follow the syntactic conventions of the language. Ad esempio, gli spazi vuoti sono importanti o la // combinazione non viene considerata come un commento.For example, whitespace characters are important, or the // combination isn't treated as a comment.

  • IngestionPropertyName, IngestionPropertyValue: un numero qualsiasi di proprietà di inserimento che influiscono sul processo di inserimento.IngestionPropertyName, IngestionPropertyValue: Any number of ingestion properties that affect the ingestion process.

RisultatiResults

Il risultato è una tabella con un numero di record pari al numero di partizioni di dati generate ("extent").The result is a table with as many records as the number of generated data shards ("extents"). Se non viene generata alcuna partizione di dati, viene restituito un singolo record con un ID di extent vuoto (con valore zero).If no data shards are generated, a single record is returned with an empty (zero-valued) extent ID.

NomeName TypeType DescrizioneDescription
ExtentIdExtentId guid Identificatore univoco per la partizione di dati generata dal comando.The unique identifier for the data shard that was generated by the command

esempiExamples

Il seguente comando inserisce i dati in una tabella ( Purchases ) con due colonne, SKU (di tipo string ) e Quantity (di tipo long ).The following command ingests data into a table (Purchases) with two columns, SKU (of type string) and Quantity (of type long).

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