Insights-Verwaltungsbefehle

Mit Insights-Verwaltungsbefehlen können Benutzer mehr Kontrolle über ihr Datensystem ausdrücken oder zusätzliche Informationen sammeln. Die Befehle lassen sich in zwei Hauptkategorien einteilen:

1. Verwaltung: Mit diesen Befehlen können Benutzer weitere Informationen zu Abfragen, Befehlen und Aufbewahrung anzeigen sowie die Aufbewahrung ändern.
2. Datensteuerung: Mit diesen Befehlen können Benutzer benutzerdefinierte Tabellen erstellen und löschen, lokale und Clouddaten erfassen und Daten aus ihrer Datenbank bereinigen.

Einige Befehle sind im Auswertungsmodus nicht verfügbar.

Kategorie	Befehle
Verwaltung	.show-Abfragen Ausführen von .show-Abfragen .show commands-and-queries Aufbewahrung von .show-Tabellenrichtlinien Aufbewahrung von .alter-Tabellenrichtlinien
Datensteuerelement	CREATE-Tabelle DROP-Tabelle .Festgelegt .Anfügen .set-or-append .set-or-replace .ingest in table .purge table

Verwaltung

.show-Abfragen
Gibt eine Liste der aktuell ausgeführten Abfragen des Benutzers, eines anderen Benutzers oder aller Benutzer zurück.
Verwendung: .show queries
Beispiel: .show queries | where StartedOn > ago(1d)
Hier werden alle Abfragen angezeigt, die am letzten Tag ausgeführt wurden.

Ausführen von .show-Abfragen
Zeigt alle aktuell ausgeführten Abfragen an
Verwendung: .show running queries
Beispiel: .show running queries
Dies zeigt alle derzeit ausgeführten Abfragen an.

ZWISCHENSPEICHERN von .show-Datenbankrichtlinien
Zeigt die aktuelle Zwischenspeicherungsrichtlinie für die Datenbank an.
Verwendung: .show database DatabaseName policy caching
Beispiel: .show database myDatabase policy caching
Dies zeigt die aktuelle Zwischenspeicherungsrichtlinie für die angegebene Datenbank an.

Zwischenspeichern von .show-Tabellenrichtlinien
Zeigt die aktuelle Zwischenspeicherungsrichtlinie für die Tabelle an.
Verwendung: .show database DatabaseName.TableName policy caching
Beispiel: .show database myDatabase.myTable policy caching
Dies zeigt die aktuelle Zwischenspeicherungsrichtlinie für die angegebene Tabelle an.

.show commands-and-queries
Gibt eine Tabelle mit Administratorbefehlen und Abfragen zurück, die einen endgültigen Zustand erreicht haben. Diese Befehle und Abfragen können 30 Tage lang abfragen.
Verwendung: .show commands-and-queries
Beispiel: .show commands-and-queries | where StartedOn > ago(1d) | where State != "Completed"
Hier werden alle Befehle und Abfragen angezeigt, die am letzten Tag fehlgeschlagen sind.

Aufbewahrung von .show-Tabellenrichtlinien
Zeigt die effektive Aufbewahrungsrichtlinie für Tabellen unter Berücksichtigung von Cluster- und Datenbankregeln an.
Verwendung: .show table(s) (<table_name> [, ...]) policy retention
Beispiel: .show table ['events.all'] policy retention
Hier wird die aktuelle Aufbewahrungsrichtlinie für die Tabelle "events.all" angezeigt.

Aufbewahrung von .alter-Tabellenrichtlinien (beschränkt auf Konten mit verbrauchsbasiertem Preismodell)
Ändern Sie die aktuelle Aufbewahrungsrichtlinie für Tabellen in <retention_policy>
Verwendung: .alter tables (<table_name> [, ...]) policy retention <retention_policy>
Beispiel: .alter table ['events.all'] policy retention softdelete = 90d
Dadurch werden Daten in der Tabelle "events.all" festgelegt, die nach 90 Tagen aus der Tabelle entfernt werden sollen.

Datensteuerelement

CREATE-Tabelle (beschränkt auf Leistungsstufe 2 und höher)
Erstellt eine neue leere Tabelle. Der Befehl muss im Kontext einer bestimmten Datenbank ausgeführt werden. Wenn die Tabelle bereits vorhanden ist, gibt der Befehl den Erfolg zurück.
Verwendung: .create table TableName ([columnName:columnType], ...)
Beispiel: .create table ['custom.logs'] (Level:string, Timestamp:datetime, Id:string, Message:string)
Dadurch wird eine neue Tabelle namens "custom.logs" mit vier Spalten erstellt. WICHTIG Benutzerdefinierte Tabellen müssen mit "custom." beginnen.

DROP-Tabelle (beschränkt auf Leistungsstufe 2 und höher)
Löscht die angegebene Tabelle. Hinweis: Dies kann nicht rückgängig werden.
Verwendung: .drop table TableName [ifexists]
Beispiel: .drop table ['custom.logs']
Dadurch wird die Tabelle mit dem Namen "custom.logs" gelöscht.

.set (auf Leistungsstufe 2 und höher beschränkt)
Erstellt eine Tabelle mit Ergebnissen der Abfrage oder des Befehls
Verwendung: .set TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
Beispiel: .set [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
Dadurch wird eine Tabelle "custom.recentEvents" erstellt, die die Ergebnisse der obigen Abfrage enthält.

.append (beschränkt auf Leistungsstufe 2 und höher)
Fügt eine vorhandene Tabelle mit Ergebnissen von QueryOrCommand an
Verwendung: .append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
Beispiel: .append [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
Dadurch wird die vorhandene Tabelle "custom.recentEvents" mit den Ergebnissen der obigen Abfrage hinzugefügt.

.set-or-append (beschränkt auf Leistungsstufe 2 und höher)
Erstellen oder Anfügen an eine Tabelle mit Ergebnissen von QueryOrCommand
Verwendung: .set-or-append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
Beispiel: .set-or-append [‘custom.weekEvents’] <| [‘events.all’] | where Timestamp > now() – time(7d)
Dadurch werden Daten aus der obigen Abfrage an die Tabelle "custom.weekEvents" angefügt. Wenn die Tabelle nicht vorhanden ist, erstellen Sie sie.

.set-or-replace (beschränkt auf Leistungsstufe 2 und höher)
Ersetzt die Daten der Tabelle, sofern vorhanden (löscht die vorhandenen Datenshards), oder erstellt die Zieltabelle, wenn sie noch nicht vorhanden ist. Das Tabellenschema wird beibehalten, es sei denn, eine der extend_schema- oder recreate_schema Erfassungseigenschaft ist auf true festgelegt. Wenn das Schema geändert wird, geschieht dies vor der eigentlichen Datenerfassung in der eigenen Transaktion. Ein Fehler beim Erfassen der Daten bedeutet also nicht, dass das Schema nicht geändert wurde.
Verwendung: .set-or-replace TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
Beispiel: .set-or-replace [‘custom.dayEvents’] <| [‘events.all’] | where Timestamp > now() – time(1d)
Dadurch werden die Daten in der Tabelle "custom.dayEvents" durch die obige Abfrage ersetzt.

.ingest in (beschränkt auf Leistungsstufe 2 und höher)
Erfasst Daten in einer Tabelle, indem die Daten aus einem oder mehreren Cloudspeicherartefakten "abgerufen" werden.
Verwendung: .ingest into table TableName SourceDataLocator [with ( IngestionPropertyName = IngestionPropertyValue [, ...] )]
Beispiel: .ingest into table [‘custom.myData’] (h’<your url here>’) with(ignoreFirstRecord=true)
Dadurch werden Daten aus Ihrem Cloudspeicher, der in der URL aufgeführt ist, in die Tabelle "custom.myData" gepusht.

.purge-Tabelle (auf Leistungsstufe 2 und höher beschränkt)
Dauerhaftes Löschen von Daten in der Tabelle aus der Datenbank
Verwendung: .purge table [TableName] in database [DatabaseName] allrecords with (noregrets='true')
Beispiel: .purge table [‘custom.toPurge’] in database MyDatabase allrecords
Dadurch werden alle Daten aus der Tabelle "custom.toPurge" gelöscht und endgültig aus Ihrem Datensystem gelöscht.