Commande .ingest inline (push)
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
Cette commande insère des données dans une table en envoyant (push) les données incluses dans la commande vers la table.
Remarque
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é.
Remarque
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é. Pour plus d’informations sur les options d’ingestion, consultez vue d’ensemble de l’ingestion des données.
autorisations
Vous devez disposer au moins des autorisations d’ingestion de table pour exécuter cette commande.
Syntaxe
.ingest
inline
into
table
TableName [(
=
IngestionPropertyValue [,
...] ] )
<|
Données
.ingest
inline
into
table
TableName [(
=
IngestionPropertyValue [,
...] ] )
[
Données]
En savoir plus sur les conventions de syntaxe.
Paramètres
Nom | Type | Requise | 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 des 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. |
Remarque
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 de la langue. 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’extension vide (zéro valeur).
Nom | Type | Description |
---|---|---|
ExtentId | guid |
Identificateur unique de la partition de données 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
Ingestion 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""}"]