Udostępnij za pośrednictwem


Zarządzanie rozszerzeniami języka w klastrze usługi Azure Data Explorer

Funkcja rozszerzeń języka umożliwia korzystanie z wtyczek rozszerzeń języka w celu zintegrowania innych języków z zapytaniami KQL w usłudze Azure Data Explorer. Środowisko uruchomieniowe wtyczki jest hostowane w piaskownicy, izolowanym i bezpiecznym środowisku uruchomionym w węzłach klastra. W tym artykule zarządzasz wtyczką rozszerzeń językowych w klastrze usługi Azure Data Explorer w witrynie Azure Portal.

Wymagania wstępne

Włączanie rozszerzeń językowych w klastrze

Wykonaj następujące kroki, aby włączyć rozszerzenie języka w klastrze:

  1. W witrynie Azure Portal przejdź do klastra usługi Azure Data Explorer.

  2. Wybierz Ustawienia.

  3. W obszarze Konfiguracje znajdź rozszerzenie języka, którego chcesz użyć, a następnie wybierz pozycję Włączone.

    Zrzut ekranu przedstawiający stronę konfiguracji klastra usługi Azure Data Explorer z opcjami włączania rozszerzenia języka.

  4. W polu Python wybierz żądany obraz z listy. Obraz może być zarządzany lub obraz niestandardowy.

  5. Wybierz pozycję Zapisz.

Uwaga

Włączenie rozszerzenia języka może potrwać do 60 minut. Proces nie ma wpływu na dostępność klastra.

Zmienianie obrazu rozszerzeń języka Python w klastrze

Wykonaj następujące kroki, aby edytować obraz rozszerzenia języka Python w klastrze:

  1. W witrynie Azure Portal przejdź do klastra usługi Azure Data Explorer.
  2. Wybierz Ustawienia.
  3. W obszarze Konfiguracje wybierz żądany obraz języka Python z listy.
  4. Wybierz pozycję Zapisz.

Uwaga

Aktualizowanie procesu obrazu może potrwać do 60 minut. Proces nie ma wpływu na dostępność klastra.

Tworzenie obrazu niestandardowego

  1. W witrynie Azure Portal przejdź do klastra usługi Azure Data Explorer.

  2. Wybierz Ustawienia.

  3. W obszarze Konfiguracje wybierz pozycję + Dodaj obraz niestandardowy (wersja zapoznawcza)

  4. W otwartym okienku podaj następujące informacje:

    • Nazwa obrazu niestandardowego: nazwa obrazu niestandardowego.
    • Rozpocznij od: wybierz aparat języka Python lub istniejący obraz.
      • Aparat języka Python:
        1. Wprowadź prawidłowy numer wersji języka Python.
        2. Dodaj plik wymagań.
      • Istniejący obraz:
        1. Wybierz istniejący obraz z listy rozwijanej.
        2. Dodaj plik wymagań.
  5. Wybierz OK

    Zrzut ekranu przedstawiający stronę konfiguracji klastra usługi Azure Data Explorer z wyświetlonym okienkiem tworzenia obrazu niestandardowego.

Uwaga

Podczas aktualizowania nowego obrazu klaster nie można wprowadzać dalszych zmian w klastrze.

Po utworzeniu obrazu można go edytować lub usunąć.

Plik wymagań

Obsługiwane pliki wymagań są w formacie pip requirements.txt i mogą zawierać dowolny pakiet języka Python. Każdy wiersz zawiera nazwę pakietu, po którym opcjonalnie następuje numer pakietu. Na przykład:

annotated-types==0.6.0
anytree
arrow==1.3.0
attrs==23.2.0

Wyłączanie rozszerzeń języka w klastrze

Uwaga

Wyłączenie procesu obrazu może potrwać do 30 minut. Proces nie ma wpływu na dostępność klastra.

Wykonaj następujące kroki, aby wyłączyć rozszerzenia języka w klastrze:

  1. W witrynie Azure Portal przejdź do klastra usługi Azure Data Explorer.
  2. W obszarze Ustawienia wybierz pozycję Konfiguracje.
  3. W okienku Konfiguracje wybierz pozycję Wył. , aby wyłączyć rozszerzenie języka.
  4. Wybierz pozycję Zapisz.

Ograniczenia

  • Piaskownica środowiska uruchomieniowego rozszerzeń języka przydziela miejsce na dysku, nawet jeśli żadne zapytanie nie jest uruchamiane w zakresie odpowiedniego języka. Aby uzyskać bardziej szczegółowe ograniczenia, zobacz piaskownice.