Share via

Commande inline .ingest (push)

  • Article

Cette commande insère des données dans une table en transmettant les données incluses dans la commande à la table.

Notes

Cette méthode d’ingestion est destinée à l’exploration et au prototypage. Ne l’utilisez pas dans des scénarios de production ou de volume élevé.

Autorisations

Vous devez disposer d’au moins des autorisations d’ingestion de table pour exécuter cette commande.

Syntax

.ingestinlineintotableTableName [with(IngestionPropertyName=IngestionPropertyValue [, ...] )] <|Données

.ingestinlineintotableTableName [with(IngestionPropertyName=IngestionPropertyValue [, ...] )] [Données]

Découvrez les conventions de syntaxe.

Paramètres

Nom Type Obligatoire Description
TableName string ✔️ Nom de la table dans laquelle ingérer des données. Le nom de la table est toujours relatif à la base de données en contexte, et son schéma est celui qui sera utilisé pour les données si aucun objet de mise en correspondance du schéma n’est fourni.
Données string ✔️ Contenu des données à ingérer. Sauf modification contraire par les propriétés d’ingestion, ce contenu est analysé au format CSV.
IngestionPropertyName, IngestionPropertyValue string Nombre de propriétés d’ingestion qui affectent le processus d’ingestion.

Notes

Contrairement à la plupart des commandes et requêtes de gestion, le texte de la partie Données de la commande n’a pas besoin de suivre les conventions syntaxiques du langage. Par exemple, les espaces blancs sont importants ou la // combinaison n’est pas traitée comme un commentaire.

Retours

Le résultat est une table avec autant d’enregistrements que le nombre de partitions de données générées (« étendues »). Si aucune partition de données n’est générée, un enregistrement unique est retourné avec un ID d’étendue vide (valeur nulle).

Nom Type Description
ExtentId guid Identificateur unique de la partition de données qui a été générée par la commande

Exemples

Ingérer avec <| la syntaxe

La commande suivante ingère des données dans une table Purchases avec deux colonnes : SKU (de type string) et Quantity (de type long).

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

Ingérer avec la syntaxe entre crochets

La commande suivante ingère des données dans une table Logs avec deux colonnes : Date (de type datetime) et EventDetails (de type dynamic).

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

Contenu connexe