Freigeben über


Azure Data Explorer-Tools für die Übersicht über den Azure MCP-Server

Mit dem Azure MCP-Server können Sie Azure Data Explorer-Ressourcen mithilfe von Eingabeaufforderungen in natürlicher Sprache verwalten. Sie können Cluster auflisten, Datenbanken anzeigen, Abfragedaten mit natürlicher Sprache abfragen. Sie können auch bestimmte KQL-Abfragen für gezielte Antworten verwenden.

Azure Data Explorer ist ein schneller, vollständig verwalteter Data Analytics-Dienst für Echtzeitanalysen für große Datenmengen, die von Anwendungen, Websites, IoT-Geräten und mehr gestreamt werden. Azure Data Explorer hilft Ihnen, große Datenmengen aus einer beliebigen Datenquelle zu analysieren, z. B. Websites, Anwendungen, IoT-Geräte und vieles mehr.

Hinweis

Toolparameter: Die Azure MCP Server-Tools definieren Parameter für Daten, die sie zum Ausführen von Aufgaben benötigen. Einige dieser Parameter sind für jedes Tool spezifisch und werden unten dokumentiert. Andere Parameter sind global und werden von allen Tools gemeinsam genutzt. Weitere Informationen finden Sie unter Toolparameter.

Bedingte Parameter

Einige der Azure Data Explorer-Tools erfordern einen der folgenden Parametersätze innerhalb des Unterhaltungskontexts:

  • Option 1: Cluster-URI
  • Option 2: Clustername und Abonnement

Stellen Sie nicht alle drei Parameter (Cluster-URI, Clustername und Abonnement) zusammen bereit, da dadurch widersprüchliche Eingaben entstehen.

Cluster: Auflisten von Clustern

Der Azure MCP-Server listet alle Azure Data Explorer-Cluster in einem Abonnement auf.

Beispiele für Prompts:

  • Listencluster: "Alle Azure Data Explorer-Cluster in meinem Abonnement anzeigen".
  • Anzeigen von Clustern: "Welche Azure Data Explorer-Cluster habe ich verfügbar?"
  • Überprüfen Sie Cluster: "Alle meine Azure Data Explorer-Cluster auflisten".
  • Abfragecluster: "Meine Azure Data Explorer-Clusterorganisation anzeigen".
  • Suchen Sie Cluster: "Alle ADX-Cluster in meinem Azure-Abonnement abrufen".

Hinweise zur Toolanmerkung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheimnis: ❌ | Lokal erforderlich: ❌

Cluster: Abrufen von Clusterdetails

Der Azure MCP-Server ruft Details für einen bestimmten Azure Data Explorer-Cluster ab.

Beispiele für Prompts:

  • Details abrufen: "Details zu meinem Azure Data Explorer-Cluster "Analytics-Cluster" anzeigen."
  • Anzeigen des Clusters: "Geben Sie mir Informationen zu meinem ADX-Cluster "logs-prod".
  • Clusterinformationen: "Was sind die Details des Azure Data Explorer-Clusters 'data-explorer-dev'?"
  • Überprüfen Sie die Konfiguration: "Abrufen von Konfigurationsdetails meines ADX-Clusters "Telemetriecluster".
  • Clustereigenschaften: "Eigenschaften meines Azure Data Explorer-Clusters im Abonnement "my-sub" anzeigen."
Parameter Erforderlich oder optional BESCHREIBUNG
Cluster Erforderlich Der Name des Azure Data Explorer-Clusters.

Hinweise zur Toolanmerkung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheimnis: ❌ | Lokal erforderlich: ❌

Datenbank: Auflisten von Datenbanken

Der Azure MCP-Server listet alle Datenbanken in einem Azure Data Explorer-Cluster auf.

Beispiele für Prompts:

  • Datenbanken auflisten: "Zeige mir alle Datenbanken im Azure Data Explorer-Cluster „analytics-cluster“."
  • Datenbanken anzeigen: "Welche Datenbanken habe ich in meinem ADX-Cluster 'Analytics-Cluster'?"
  • Überprüfen Sie Datenbanken: "Auflisten aller Datenbanken im Daten-Explorer-Cluster "Analytics-Cluster".
  • Abfragedatenbanken: "Datenbanken im Azure Data Explorer-Cluster-URI 'https://mycluster.westus.kusto.windows.net'" anzeigen.
  • Finden Sie Datenbanken: "Erhalten Sie alle Datenbanken aus dem ADX-Cluster 'analytics-cluster'."
Parameter Erforderlich oder optional BESCHREIBUNG
Cluster-URI Bedingt erforderlich Der URI des Azure Data Explorer-Clusters.
Cluster Bedingt erforderlich Der Name des Azure Data Explorer-Clusters.

Hinweise zur Toolanmerkung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheimnis: ❌ | Lokal erforderlich: ❌

Tabelle: Listentabellen

Der Azure MCP-Server listet alle Tabellen in einer bestimmten Azure Data Explorer-Datenbank auf.

Beispiele für Prompts:

  • Listentabelle: "Zeigen Sie mir alle Tabellen in der 'logs'-Datenbank des Azure Data Explorer Clusters 'analytics-cluster' an."
  • Tabellen anzeigen: "Welche Tabellen habe ich in der Datenbank "Telemetrie" im ADX-Cluster "Analytics-Cluster"?"
  • Prüfen Sie Tabellen: "Listen Sie alle Tabellen in der Azure Data Explorer-Datenbank 'analytics' im Cluster 'analytics-cluster' auf."
  • Abfragetabellen: "Tabellen in der Datenbank 'Metriken' des Data Explorer-Clusters 'analytics-cluster' anzeigen".
  • Finden Sie Tabellen: "Abrufen aller Tabellen aus der Datenbank "Events" im Azure Data Explorer-Cluster "Analytics-Cluster".
Parameter Erforderlich oder optional BESCHREIBUNG
Cluster-URI Bedingt erforderlich Der URI des Azure Data Explorer-Clusters.
Cluster Bedingt erforderlich Der Name des Azure Data Explorer-Clusters.
Datenbank Erforderlich Der Name der Azure Data Explorer-Datenbank.

Hinweise zur Toolanmerkung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheimnis: ❌ | Lokal erforderlich: ❌

Tabelle: Tabellenschema abrufen

Der Azure MCP-Server ruft das Schema einer bestimmten Tabelle in einer Azure Data Explorer-Datenbank ab.

Beispiele für Prompts:

  • Ansichtsschema: "Zeigt mir das Schema der Tabelle "Ereignisse" in Datenbankprotokollen im Azure Data Explorer-Cluster "Analytics-Cluster".
  • Struktur abrufen: "Welche Spalten hat die Tabelle "Metriken" in der Datenbank "Telemetrie" im ADX-Cluster "Analytics-Cluster"?"
  • Überprüfen Sie das Schema: "Beschreiben Sie die Tabelle 'Logs' in der Datenbank 'logs' im Data Explorer-Cluster 'analytics-cluster'."
  • Ansichtsspalten: "Spalten und Typen für die Telemetrietabelle in der Datenbank "Telemetrie" im Azure Data Explorer-Cluster "Analytics-Cluster" anzeigen."
  • Untersuchen Sie die Tabelle: "Abrufen der Struktur der Tabelle 'Traces' in der Datenbank 'logs' im ADX-Cluster 'analytics-cluster'."
Parameter Erforderlich oder optional BESCHREIBUNG
Cluster-URI Bedingt erforderlich Der URI des Azure Data Explorer-Clusters.
Cluster Bedingt erforderlich Der Name des Azure Data Explorer-Clusters.
Datenbank Erforderlich Der Name der Azure Data Explorer-Datenbank.
Table Erforderlich Der Name der Tabelle.

Hinweise zur Toolanmerkung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheimnis: ❌ | Lokal erforderlich: ❌

Beispieldaten

Der Azure MCP-Server ruft ein Beispiel von Daten aus einer angegebenen Azure Data Explorer-Tabelle ab.

Beispiele für Prompts:

  • Beispieldaten abrufen: "Beispieldaten aus der Tabelle "Ereignisse" in Datenbankprotokollen im Azure Data Explorer-Cluster "Analytics-Cluster" anzeigen."
  • Vorschautabelle: "Geben Sie mir eine Vorschau von Datensätzen aus der Tabelle "Protokolle" in Datenbankprotokollen im ADX-Cluster "Analytics-Cluster".
  • Zeigen Sie Datenbeispiele an: „Beispielzeilen aus der Tabelle „Metriken“ in der Datenbank „Telemetrie“ im Daten-Explorer-Cluster „Analysecluster“ anzeigen.“
  • Überprüfen Sie das Datenformat: "Abrufen einiger Beispieldatensätze aus der Tabelle "Telemetrie" in der Datenbank "Telemetrie" im Azure Data Explorer-Cluster "Analytics-Cluster", um die Datenstruktur anzuzeigen."
  • Datenerkundung: "Geben Sie 10 Beispielzeilen aus der Tabelle 'UserActivity' in der Datenbank 'logs' im ADX-Cluster 'analytics-cluster' zurück."
Parameter Erforderlich oder optional BESCHREIBUNG
Cluster-URI Bedingt erforderlich Der URI des Azure Data Explorer-Clusters.
Cluster Bedingt erforderlich Der Name des Azure Data Explorer-Clusters.
Datenbank Erforderlich Der Name der Azure Data Explorer-Datenbank.
Table Erforderlich Der Name der Tabelle, aus der Beispieldaten stammen.
Begrenzung Wahlfrei Die maximale Anzahl von Zeilen, die im Beispiel zurückgegeben werden sollen.

Hinweise zur Toolanmerkung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheimnis: ❌ | Lokal erforderlich: ❌

Query

Der Azure MCP-Server führt eine KQL-Abfrage für eine Azure Data Explorer-Datenbank aus.

Beispiele für Prompts:

  • Abfrage ausführen: "Execute 'Logs | where Timestamp > ago(1h) | count' in der Datenbank 'logs' im Azure Data Explorer Cluster 'analytics-cluster'."
  • Abfragedaten: "Führen Sie die KQL-Abfrage 'Protokolle | where Level == "Error" and Timestamp > ago(24h)' aus, um alle Fehler in den letzten 24 Stunden in der Datenbank 'logs' im ADX-Cluster 'analytics-cluster' zu finden."
  • Abrufen von Daten: "Abrufen der letzten Ereignisse mit der Abfrage 'Ereignisse | take 100' aus der Datenbank 'logs' im Data Explorer-Cluster 'analytics-cluster'."
  • Extrahieren von Erkenntnissen: "Abfrage von Benutzeraktivitätsmustern mit 'UserActivity | summarize count() by UserId' aus der Datenbank 'logs' im Azure Data Explorer Cluster 'analytics-cluster'."
  • Analysieren von Protokollen: "KQL 'Metriken | zusammenfassen avg(Duration) nach Dienst' ausführen, um Leistungsmetriken nach Dienst in der Datenbank 'telemetry' im ADX-Cluster 'analytics-cluster' zusammenzufassen."
Parameter Erforderlich oder optional BESCHREIBUNG
Cluster-URI Bedingt erforderlich Der URI des Azure Data Explorer-Clusters.
Cluster Bedingt erforderlich Der Name des Azure Data Explorer-Clusters.
Datenbank Erforderlich Der Name der Azure Data Explorer-Datenbank.
Abfrage Erforderlich Die auszuführende KQL-Abfrage.

Hinweise zur Toolanmerkung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheimnis: ❌ | Lokal erforderlich: ❌