Erfassen aus Abfrage (.set, .append, .set-or-append, .set-or-replace)

Wechseln Von Diensten mithilfe der Dropdownliste "Version ". Weitere Informationen zur Navigation.
Gilt für: ✅ Microsoft Fabric ✅ Azure Data Explorer

Diese Befehle führen eine Abfrage oder einen Verwaltungsbefehl aus und nehmen die Ergebnisse der Abfrage in eine Tabelle ein. Der Unterschied zwischen diesen Befehlen besteht darin, wie vorhandene oder nicht vorhandene Tabellen und Daten behandelt werden.

Informationen zum Abbrechen eines Abrufs aus dem Abfragebefehl finden Sie unter cancel operation.

Berechtigungen

Um unterschiedliche Aktionen für eine Tabelle auszuführen, benötigen Sie bestimmte Berechtigungen:

• Zum Hinzufügen von Zeilen zu einer vorhandenen Tabelle mit dem .append Befehl benötigen Sie mindestens die Berechtigungen "Table Ingestor".
• Um eine neue Tabelle mit den verschiedenen .set Befehlen zu erstellen, benötigen Sie mindestens berechtigungen für Datenbankbenutzer.
• Um Zeilen in einer vorhandenen Tabelle mithilfe des .set-or-replace Befehls zu ersetzen, benötigen Sie mindestens die Berechtigungen des Tabellenadministrators.

Weitere Informationen zu Berechtigungen finden Sie unter Kusto rollenbasierte Zugriffssteuerung.

Syntax

(.set | .append | .set-or-append | .set-or-replace) [async] with [( ...]] =

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Leistungstipps

• Legen Sie die distributed Eigenschaft fest, true wenn die Menge der von der Abfrage erzeugten Daten groß ist, ein Gigabyte (GB) überschreitet und keine Serialisierung erfordert. Anschließend können mehrere Knoten die Ausgabe parallel erzeugen. Verwenden Sie dieses Flag nicht, wenn Abfrageergebnisse klein sind, da es möglicherweise viele kleine Datenshards ohne Weiteres generiert.
• Die Datenaufnahme ist ein ressourcenintensiver Vorgang, der sich auf gleichzeitige Aktivitäten in der Datenbank auswirken kann, einschließlich der Ausführung von Abfragen. Vermeiden Sie die gleichzeitige Ausführung zu vieler Aufnahmebefehle.
• Beschränken Sie die Daten für die Aufnahme auf weniger als ein GB pro Aufnahmevorgang. Verwenden Sie bei Bedarf mehrere Aufnahmebefehle.

Unterstützte Erfassungseigenschaften

Schemaüberlegungen

• .set-or-replace behält das Schema bei, es sei denn, eine der extend_schema Eigenschaften für recreate_schema die Aufnahme ist auf true.
• .set-or-append und .append Befehle behalten das Schema bei, es sei denn, die extend_schema Aufnahmeeigenschaft ist auf true.
• Der Abgleich mit dem Resultsetschema der Zieltabelle basiert auf den Spaltentypen. Es erfolgt kein Abgleichen der Spaltennamen. Stellen Sie sicher, dass sich die Spalten des Abfrageergebnisschemas in der gleichen Reihenfolge wie die Tabelle befinden, andernfalls werden Daten in die falschen Spalten aufgenommen.

Zeichenbeschränkung

Der Befehl schlägt fehl, wenn die Abfrage einen Entitätsnamen mit dem $ Zeichen generiert. Die Entitätsnamen müssen den Benennungsregeln entsprechen, sodass das $ Zeichen entfernt werden muss, damit der Aufnahmebefehl erfolgreich ausgeführt werden kann.

In der folgenden Abfrage generiert der search Operator beispielsweise eine Spalte $table. Zum Speichern der Abfrageergebnisse verwenden Sie die Projektumbenennung , um die Spalte umzubenennen.

.set Texas <| search State has 'Texas' | project-rename tableName=$table

Rückkehr

Gibt Informationen zu den Erweiterungen zurück, die aufgrund des .set- oder .append-Befehls erstellt wurden.

Beispiele

Tabelle aus Abfragequelle erstellen und aktualisieren

Die folgende Abfrage erstellt die RecentErrors Tabelle mit demselben Schema wie LogsTable. Es wird mit allen Fehlerprotokollen aus RecentErrors der letzten Stunde aktualisiertLogsTable.

.set RecentErrors <|
   LogsTable
   | where Level == "Error" and Timestamp > now() - time(1h)

Erstellen und Aktualisieren einer Tabelle aus der Abfragequelle mithilfe des verteilten Flags

Im folgenden Beispiel wird eine neue Tabelle erstellt, die in der Datenbank asynchron aufgerufen wird OldExtents . Das Dataset wird voraussichtlich größer als ein GB (mehr als eine Million Zeilen) sein, sodass das verteilte Flag verwendet wird. Es wird mit OldExtents Einträgen aus der Tabelle aktualisiertExtentId, die MyExtents vor mehr als 30 Tagen erstellt wurden.

.set async OldExtents with(distributed=true) <|
   MyExtents 
   | where CreatedOn < now() - time(30d)
   | project ExtentId

An Tabelle angefügte Daten

Im folgenden Beispiel werden Einträge in der Tabelle gefiltert ExtentId , die MyExtents vor mehr als 30 Tagen erstellt wurden, und fügt die Einträge an die OldExtents Tabelle mit zugeordneten Tags an.

.append OldExtents with(tags='["TagA","TagB"]') <| 
   MyExtents 
   | where CreatedOn < now() - time(30d) 
   | project ExtentId

Erstellen oder Anfügen einer Tabelle mit möglicherweise vorhandenen markierten Daten

Im folgenden Beispiel wird entweder die OldExtents Tabelle asynchron angefügt oder erstellt. Es filtert ExtentId Einträge in der Tabelle, die MyExtents vor mehr als 30 Tagen erstellt wurden, und gibt die Tags an, die an die neuen Erweiterungen angefügt werden sollen.ingest-by:myTag Der ingestIfNotExists Parameter stellt sicher, dass die Erfassung nur auftritt, wenn die Daten nicht bereits in der Tabelle mit dem angegebenen Tag vorhanden sind.

.set-or-append async OldExtents with(tags='["ingest-by:myTag"]', ingestIfNotExists='["myTag"]') <|
   MyExtents
   | where CreatedOn < now() - time(30d)
   | project ExtentId

Erstellen einer Tabelle oder Ersetzen von Daten durch zugeordnete Daten

Die folgende Abfrage ersetzt die Daten in der OldExtents Tabelle oder erstellt die Tabelle, sofern sie noch nicht vorhanden ist, durch ExtentId Einträge in der Tabelle, die MyExtents vor mehr als 30 Tagen erstellt wurden. Markieren Sie das neue Ausmaß mit ingest-by:myTag , wenn die Daten noch nicht in der Tabelle mit dem angegebenen Tag vorhanden sind.

.set-or-replace async OldExtents with(tags='["ingest-by:myTag"]', ingestIfNotExists='["myTag"]') <| 
   MyExtents 
   | where CreatedOn < now() - time(30d) 
   | project ExtentId

Anfügen von Daten mit zugeordneten Daten

Im folgenden Beispiel werden Daten asynchron an die OldExtents Tabelle angefügt, wobei ExtentId Einträge aus der Tabelle verwendet werden, die MyExtents vor mehr als 30 Tagen erstellt wurden. Es legt eine bestimmte Erstellungszeit für die neuen Ausmaße fest.

.append async OldExtents with(creationTime='2017-02-13T11:09:36.7992775Z') <| 
   MyExtents 
   | where CreatedOn < now() - time(30d) 
   | project ExtentId     

Beispielausgabe

Im Folgenden finden Sie ein Beispiel für den Ausgabetyp, den Sie möglicherweise aus Ihren Abfragen sehen.

Verwandte Inhalte

• Unterstützte Datenformate für die Einspeisung
• Inlineaufnahme
• Aufnahme aus Dem Speicher