Serwer Azure MCP umożliwia zarządzanie zasobami Azure Data Explorer przy użyciu monitów języka naturalnego. Możesz wyświetlać klastry, przeglądać bazy danych i wyszukiwać dane za pomocą zapytań w języku naturalnym. Możesz również użyć konkretnych zapytań KQL, aby uzyskać ukierunkowane odpowiedzi.
Azure Data Explorer to szybka, w pełni zarządzana usługa analizy danych na potrzeby analizy danych w czasie rzeczywistym na dużych ilościach danych przesyłanych strumieniowo z aplikacji, witryn internetowych, urządzeń IoT i innych. Usługa Azure Data Explorer ułatwia analizowanie dużych ilości różnorodnych danych z dowolnego źródła danych, takich jak witryny internetowe, aplikacje, urządzenia IoT i inne.
Uwaga / Notatka
Parametry narzędzia: narzędzia serwera MCP platformy Azure definiują parametry potrzebne do przetwarzania danych w celu realizacji zadań. Niektóre z tych parametrów są specyficzne dla każdego narzędzia i zostały opisane tutaj. Inne parametry są globalne i współużytkowane przez wszystkie narzędzia. Aby uzyskać więcej informacji, zobacz Parametry narzędzia.
Parametry warunkowe
Niektóre narzędzia usługi Azure Data Explorer wymagają jednego z następujących zestawów parametrów w kontekście konwersacji:
-
Opcja 1: Adres URI klastra
-
Opcja 2: Zarówno nazwa klastra i subskrypcja
Subskrypcja może zostać określona na podstawie skonfigurowanego kontekstu Azure podczas podawania nazwy klastra. Jeśli podasz URI klastra, narzędzie użyje tego URI; nazwa klastra i subskrypcja nie są wymagane. Grupa zasobów nie jest wymagana dla tych narzędzi płaszczyzny danych.
Klaster: Lista klastrów
Przykładowe polecenie CLI
azmcp kusto cluster list \
[--resource-group <resource-group>]
| Parametr |
Typ |
Wymagane |
Opis |
resource-group |
ciąg |
No |
Ogranicz klastry do tej grupy zasobów. Pozostaw to pole puste, aby wyświetlić listę klastrów w ramach subskrypcji. |
Przykładowe monity obejmują:
-
Wyświetlanie listy klastrów: "Pokaż mi wszystkie klastry usługi Azure Data Explorer w mojej subskrypcji".
-
Wyświetlanie klastrów: "Jakie klastry usługi Azure Data Explorer są dostępne?"
-
Sprawdź klastry: "Wyświetl listę wszystkich moich klastrów usługi Azure Data Explorer".
-
Klastry zapytań: "Pokaż moją organizację klastra usługi Azure Data Explorer".
-
Znajdź klastry: "Pobierz wszystkie klastry ADX w mojej subskrypcji platformy Azure".
| Parametr |
Wymagane lub opcjonalne |
Opis |
|
Grupa zasobów |
Opcjonalnie |
Ogranicz klastry do tej grupy zasobów. Nie podawaj go, aby wyświetlić listę klastrów w ramach subskrypcji. |
Wskazówki adnotacji narzędzi:
| Destrukcyjny |
Idempotentny |
Otwarty świat |
Tylko do odczytu |
Secret |
Wymagane lokalnie |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Klaster: pobieranie szczegółów klastra
Przykładowe polecenie CLI
azmcp kusto cluster get \
--cluster <cluster>
| Parametr |
Typ |
Wymagane |
Opis |
cluster |
ciąg |
Yes |
Nazwa klastra usługi Azure Data Explorer. |
Przykładowe monity obejmują:
-
Uzyskaj szczegóły: "Pokaż mi szczegóły klastra usługi Azure Data Explorer "analytics-cluster".
-
Wyświetl klaster: "Przekaż mi informacje o klastrze ADX "logs-prod".
-
Informacje o klastrze: "Jakie są szczegóły klastra usługi Azure Data Explorer "data-explorer-dev"?
-
Sprawdź konfigurację: "Pobierz szczegóły konfiguracji mojego klastra ADX „telemetry-cluster”."
-
Właściwości klastra: „Pokaż właściwości klastra Azure Data Explorer „analytics-cluster” w subskrypcji „my-sub”.”
| Parametr |
Wymagane lub opcjonalne |
Opis |
|
Klaster |
Wymagane |
Nazwa klastra usługi Azure Data Explorer. |
Wskazówki adnotacji narzędzi:
| Destrukcyjny |
Idempotentny |
Otwarty świat |
Tylko do odczytu |
Secret |
Wymagane lokalnie |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Baza danych: Lista baz danych
Przykładowe polecenie CLI
azmcp kusto database list \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| Parametr |
Typ |
Wymagane |
Opis |
cluster-uri |
ciąg |
No |
Identyfikator URI klastra usługi Azure Data Explorer. |
cluster |
ciąg |
No |
Nazwa klastra usługi Azure Data Explorer. |
Przykładowe monity obejmują:
-
Lista baz danych: "Pokaż mi wszystkie bazy danych w klastrze usługi Azure Data Explorer "analytics-cluster".
-
Wyświetlanie baz danych: "Jakie bazy danych mam w klastrze ADX "analytics-cluster"?"
-
Sprawdź bazy danych: "Wyświetl listę wszystkich baz danych w klastrze usługi Data Explorer "analytics-cluster".
-
Zapytanie baz danych: "Pokaż bazy danych w klastrze Azure Data Explorer pod URI 'https://mycluster.westus.kusto.windows.net'."
-
Znajdowanie baz danych: "Pobierz wszystkie bazy danych z klastra ADX "analytics-cluster".
| Parametr |
Wymagane lub opcjonalne |
Opis |
|
Identyfikator URI klastra |
Wymagane warunkowo |
Identyfikator URI klastra usługi Azure Data Explorer. |
|
Klaster |
Wymagane warunkowo |
Nazwa klastra usługi Azure Data Explorer. |
Wskazówki adnotacji narzędzi:
| Destrukcyjny |
Idempotentny |
Otwarty świat |
Tylko do odczytu |
Secret |
Wymagane lokalnie |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Tabela: Lista tabel
Przykładowe polecenie CLI
azmcp kusto table list \
--database <database> \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| Parametr |
Typ |
Wymagane |
Opis |
database |
ciąg |
Yes |
Nazwa bazy danych usługi Azure Data Explorer. |
cluster-uri |
ciąg |
No |
Identyfikator URI klastra usługi Azure Data Explorer. |
cluster |
ciąg |
No |
Nazwa klastra usługi Azure Data Explorer. |
Przykładowe monity obejmują:
-
Lista tabel: "Pokaż mi wszystkie tabele w bazie danych 'logs' klastra 'analytics-cluster' usługi Azure Data Explorer."
-
Wyświetlanie tabel: "Jakie tabele mam w bazie danych "telemetria" w klastrze ADX "analytics-cluster"?"
-
Sprawdź tabele: "Wyświetl listę wszystkich tabel w bazie danych usługi Azure Data Explorer "analytics" w klastrze "analytics-cluster".
-
Tabele zapytań: "Pokaż tabele w bazie danych „metrics” klastra Data Explorer „analytics-cluster”."
-
Znajdź tabele: "Pobierz wszystkie tabele z bazy danych "events" w klastrze usługi Azure Data Explorer "analytics-cluster".
| Parametr |
Wymagane lub opcjonalne |
Opis |
|
Identyfikator URI klastra |
Wymagane warunkowo |
Identyfikator URI klastra usługi Azure Data Explorer. |
|
Klaster |
Wymagane warunkowo |
Nazwa klastra usługi Azure Data Explorer. |
|
Baza danych |
Wymagane |
Nazwa bazy danych usługi Azure Data Explorer. |
Wskazówki adnotacji narzędzi:
| Destrukcyjny |
Idempotentny |
Otwarty świat |
Tylko do odczytu |
Secret |
Wymagane lokalnie |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Tabela: Pobieranie schematu tabeli
Przykładowe polecenie CLI
azmcp kusto table schema \
--table <table> \
--database <database> \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| Parametr |
Typ |
Wymagane |
Opis |
table |
ciąg |
Yes |
Nazwa tabeli usługi Azure Data Explorer. |
database |
ciąg |
Yes |
Nazwa bazy danych usługi Azure Data Explorer. |
cluster-uri |
ciąg |
No |
Identyfikator URI klastra usługi Azure Data Explorer. |
cluster |
ciąg |
No |
Nazwa klastra usługi Azure Data Explorer. |
Przykładowe monity obejmują:
-
Schemat widoku: "Pokaż schemat tabeli "Zdarzenia" w bazie danych "logs" w klastrze usługi Azure Data Explorer "analytics-cluster".
-
Pobierz strukturę: „Jakie kolumny ma tabela 'Metryki' w bazie danych 'telemetria' w klastrze ADX 'analytics-cluster'?”
-
Sprawdź schemat: "Opisz tabelę „Dzienniki” w bazie danych „logs” w klastrze „analytics-cluster” w usłudze Data Explorer."
-
Wyświetlanie kolumn: "Pokaż kolumny i typy dla tabeli "Telemetria" w bazie danych "telemetria" w klastrze usługi Azure Data Explorer "analytics-cluster".
-
Sprawdź tabelę: "Pobierz strukturę tabeli 'Traces' w bazie danych 'logs' w klastrze ADX 'analytics-cluster'."
| Parametr |
Wymagane lub opcjonalne |
Opis |
|
Identyfikator URI klastra |
Wymagane warunkowo |
Identyfikator URI klastra usługi Azure Data Explorer. |
|
Klaster |
Wymagane warunkowo |
Nazwa klastra usługi Azure Data Explorer. |
|
Baza danych |
Wymagane |
Nazwa bazy danych usługi Azure Data Explorer. |
|
Tabela |
Wymagane |
Nazwa tabeli. |
Wskazówki adnotacji narzędzi:
| Destrukcyjny |
Idempotentny |
Otwarty świat |
Tylko do odczytu |
Secret |
Wymagane lokalnie |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Przykładowe dane
Przykładowe polecenie CLI
azmcp kusto sample \
--table <table> \
--database <database> \
[--limit <limit>] \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| Parametr |
Typ |
Wymagane |
Opis |
table |
ciąg |
Yes |
Nazwa tabeli usługi Azure Data Explorer. |
database |
ciąg |
Yes |
Nazwa bazy danych usługi Azure Data Explorer. |
limit |
ciąg |
No |
Maksymalna liczba wyników do zwrócenia. Musi być dodatnią liczbą całkowitą z zakresu od 1 do 10000. Wartość domyślna to 10. |
cluster-uri |
ciąg |
No |
Identyfikator URI klastra usługi Azure Data Explorer. |
cluster |
ciąg |
No |
Nazwa klastra usługi Azure Data Explorer. |
Przykładowe monity obejmują:
-
Pobieranie przykładowych danych: "Pokaż mi przykład danych z tabeli "Zdarzenia" w bazie danych "logs" w klastrze usługi Azure Data Explorer "analytics-cluster".
-
Tabela podglądu: "Pokaż mi podgląd rekordów z tabeli „Logs” w bazie danych „logs” w klastrze ADX „analytics-cluster”."
-
Wyświetl przykłady danych: "Pokaż przykładowe wiersze z tabeli "Metryki" w bazie danych "telemetria" w klastrze usługi Data Explorer "analytics-cluster".
-
Sprawdź format danych: "Pobierz kilka przykładowych rekordów z tabeli "Telemetria" w bazie danych "telemetria" w klastrze usługi Azure Data Explorer "analytics-cluster", aby wyświetlić strukturę danych.
-
Eksploracja danych: "Zwracanie 10 przykładowych wierszy z tabeli "UserActivity" w bazie danych "logs" w klastrze ADX "analytics-cluster".
| Parametr |
Wymagane lub opcjonalne |
Opis |
|
Identyfikator URI klastra |
Wymagane warunkowo |
Identyfikator URI klastra usługi Azure Data Explorer. |
|
Klaster |
Wymagane warunkowo |
Nazwa klastra usługi Azure Data Explorer. |
|
Baza danych |
Wymagane |
Nazwa bazy danych usługi Azure Data Explorer. |
|
Tabela |
Wymagane |
Nazwa tabeli, z której mają być pobrane dane do próby. |
|
Ograniczenie |
Opcjonalnie |
Maksymalna liczba wierszy do zwrócenia w przykładowym zbiorze danych. |
Wskazówki adnotacji narzędzi:
| Destrukcyjny |
Idempotentny |
Otwarty świat |
Tylko do odczytu |
Secret |
Wymagane lokalnie |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Query
Przykładowe polecenie CLI
azmcp kusto query \
--query <query> \
--database <database> \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| Parametr |
Typ |
Wymagane |
Opis |
query |
ciąg |
Yes |
Zapytanie Języka zapytań Kusto (KQL) do wykonania. |
database |
ciąg |
Yes |
Nazwa bazy danych usługi Azure Data Explorer. |
cluster-uri |
ciąg |
No |
Identyfikator URI klastra usługi Azure Data Explorer. |
cluster |
ciąg |
No |
Nazwa klastra usługi Azure Data Explorer. |
Przykładowe monity obejmują:
-
Uruchom zapytanie: "Wykonaj 'Logs | gdzie znacznik czasu > ago(1h) | count' w bazie danych 'logs' w klastrze usługi Azure Data Explorer 'analytics-cluster'."
-
Dane zapytania: "Aby znaleźć wszystkie błędy z ostatnich 24 godzin w bazie danych 'logs' w klastrze ADX 'analytics-cluster', uruchom zapytanie KQL: 'Logs | where Level == \"Error\" and Timestamp > ago(24h)'."
-
Pobierz dane: "Pobierz ostatnie zdarzenia za pomocą zapytania 'Zdarzenia | pobierz 100' z bazy danych 'logs' w klastrze 'analytics-cluster' usługi Data Explorer."
-
Wyodrębnianie szczegółowych informacji: "Wykonywanie zapytań dotyczących wzorców aktywności użytkownika przy użyciu funkcji UserActivity | summarize count() by UserId" z bazy danych "logs" w klastrze usługi Azure Data Explorer "analytics-cluster".
-
Analizowanie dzienników: "Wykonaj zapytanie KQL 'Metrics | summarize avg(Duration) by Service', aby podsumować metryki wydajności według usługi w bazie danych 'telemetria' w klastrze ADX 'analytics-cluster'."
| Parametr |
Wymagane lub opcjonalne |
Opis |
|
Identyfikator URI klastra |
Wymagane warunkowo |
Identyfikator URI klastra usługi Azure Data Explorer. |
|
Klaster |
Wymagane warunkowo |
Nazwa klastra usługi Azure Data Explorer. |
|
Baza danych |
Wymagane |
Nazwa bazy danych usługi Azure Data Explorer. |
|
Zapytanie |
Wymagane |
Zapytanie KQL do wykonania. |
Wskazówki adnotacji narzędzi:
| Destrukcyjny |
Idempotentny |
Otwarty świat |
Tylko do odczytu |
Secret |
Wymagane lokalnie |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Treści powiązane