Insights-Verwaltungsbefehle

Insights-Verwaltungsbefehle ermöglichen Es Benutzern, mehr Kontrolle über ihr Datensystem auszudrücken oder zusätzliche Informationen zu sammeln. Die Befehle lassen sich in zwei Hauptkategorien einteilen:

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

Notiz

PlayFab Insights Management wurde am 11. Dezember 2023 eingestellt. Es wird empfohlen, Azure Data Explorer -Verbindungen (ADX) zu verwenden, um Ihre Leistung und Ihre Kosten in Zukunft zu verwalten. Wenn Ihr Titel immer noch Insights verwendet, lesen Sie diesen Artikel, um Details zu Verwaltungsbefehlen zu erhalten. Weitere Informationen finden Sie im Blog zur Veraltung von Insights.

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 .Garnitur .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)
Dieser Befehl zeigt alle Abfragen an, 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
Dieser Befehl 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
Dieser Befehl zeigt die aktuelle Cacherichtlinie 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
Dieser Befehl zeigt die aktuelle Cacherichtlinie 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"
Dieser Befehl zeigt alle Befehle und Abfragen an, 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
Dieser Befehl zeigt die aktuelle Aufbewahrungsrichtlinie für die Tabelle "events.all" an.

Aufbewahrung von .alter-Tabellenrichtlinien (beschränkt auf Konten mit verbrauchsbasiertem Preismodell)
Ändern Sie die aktuelle Aufbewahrungsrichtlinie für eine oder mehrere Tabellen in <retention_policy>
Verwendung: .alter tables (<table_name> [, ...]) policy retention <retention_policy>
Beispiel: .alter table ['events.all'] policy retention softdelete = 90d
Dieser Befehl legt fest, dass Daten in der Tabelle "events.all" 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 erfolgreich zurück.
Verwendung: .create table TableName ([columnName:columnType], ...)
Beispiel: .create table ['custom.logs'] (Level:string, Timestamp:datetime, Id:string, Message:string)
Dieser Befehl erstellt eine neue Tabelle namens "custom.logs" mit vier Spalten. WICHTIG Benutzerdefinierte Tabellen müssen mit "custom." beginnen.

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

.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)
Dieser Befehl erstellt eine Tabelle "custom.recentEvents", 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)
Dieser Befehl fügt die vorhandene Tabelle "custom.recentEvents" mit den Ergebnissen der obigen Abfrage hinzu.

.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)
Dieser Befehl fügt Daten aus der obigen Abfrage an die Tabelle "custom.weekEvents" an. 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, erfolgt die Änderung vor der eigentlichen Datenerfassung in der eigenen Transaktion, sodass ein Fehler beim Erfassen der Daten nicht bedeutet, 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)
Dieser Befehl ersetzt die Daten in der Tabelle "custom.dayEvents" durch die obige Abfrage.

.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)
Dieser Befehl pusht Daten aus Ihrem Cloudspeicher, der in der URL aufgeführt ist, in die Tabelle "custom.myData".

.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
Dieser Befehl löscht alle Daten aus der Tabelle "custom.toPurge" und löscht sie endgültig aus Ihrem Datensystem.