.ingest inline-opdracht (push)
Van toepassing op: ✅Microsoft Fabric✅Azure Data Explorer-
Met deze opdracht worden gegevens in een tabel ingevoegd door de gegevens in de opdracht naar de tabel te pushen.
Notitie
Deze opnamemethode is bedoeld voor verkenning en prototypen. Gebruik deze niet in productie- of grote volumescenario's.
Notitie
Deze opnamemethode is bedoeld voor verkenning en prototypen. Gebruik deze niet in productie- of grote volumescenario's. Zie Overzicht van gegevensopnamevoor meer informatie over opnameopties.
Machtigingen
U moet ten minste Table Ingestor machtigingen hebben om deze opdracht uit te voeren.
Syntaxis
.ingest
inline
into
table
TableName [with
(
IngestionPropertyName=
IngestionPropertyValue [,
...] )
] <|
Data
.ingest
inline
into
table
TableName [with
(
IngestionPropertyName=
IngestionPropertyValue [,
...] )
] [
Data]
Meer informatie over syntaxisconventies.
Parameters
Naam | Type | Vereist | Beschrijving |
---|---|---|---|
TableName- | string |
✔️ | De naam van de tabel waarin gegevens moeten worden opgenomen. De tabelnaam is altijd relatief ten opzichte van de database in context en het bijbehorende schema is het schema dat wordt aangenomen voor de gegevens als er geen schematoewijzingsobject is opgegeven. |
Data | string |
✔️ | De gegevensinhoud die moet worden opgenomen. Tenzij anders gewijzigd door de opname-eigenschappen, wordt deze inhoud geparseerd als CSV. |
IngestionPropertyName, IngestionPropertyValue | string |
Een willekeurig aantal opname-eigenschappen die van invloed zijn op het opnameproces. |
Notitie
In tegenstelling tot de meeste beheeropdrachten en query's hoeft de tekst van de Data deel van de opdracht niet de syntactische conventies van de taal te volgen. Witruimtetekens zijn bijvoorbeeld belangrijk of de combinatie van //
wordt niet behandeld als opmerking.
Retourneert
Het resultaat is een tabel met zo veel records als het aantal gegenereerde gegevensshards ('extents'). Als er geen gegevensshards worden gegenereerd, wordt één record geretourneerd met een lege (nulwaarde)-id.
Naam | Type | Beschrijving |
---|---|---|
ExtentId | guid |
De unieke id voor de gegevensshard die is gegenereerd door de opdracht |
Voorbeelden
Opnemen met <|
syntaxis
Met de volgende opdracht worden gegevens opgenomen in een tabel Purchases
met twee kolommen: SKU
(van het type string
) en Quantity
(van het type long
).
.ingest inline into table Purchases <|
Shoes,1000
Wide Shoes,50
"Coats black",20
"Coats with ""quotes""",5
Opnemen met syntaxis van haakjes
Met de volgende opdracht worden gegevens opgenomen in een tabel Logs
met twee kolommen: Date
(van het type datetime
) en EventDetails
(van het type dynamic
).
.ingest inline into table Logs
[2015-01-01,"{""EventType"":""Read"", ""Count"":""12""}"]
[2015-01-01,"{""EventType"":""Write"", ""EventValue"":""84""}"]