Wizualizowanie danych z usługi Azure Data Explorer w narzędziu Redash

Narzędzie Redash łączy się ze źródłami danych i wysyła do nich zapytania, tworzy pulpity nawigacyjne w celu wizualizacji danych i udostępniania ich elementom równorzędnym. Z tego artykułu dowiesz się, jak skonfigurować usługę Azure Data Explorer jako źródło danych dla funkcji Redash, a następnie wizualizować dane.

Wymagania wstępne

Konfigurowanie źródła danych

Wykonaj następujące kroki, aby skonfigurować usługę Azure Data Explorer jako źródło danych dla narzędzia pulpitu nawigacyjnego. Te kroki zostaną szczegółowo omówione w tej sekcji:

  1. Utwórz jednostkę usługi Microsoft Entra. Jednostka usługi jest używana przez narzędzie pulpitu nawigacyjnego do uzyskiwania dostępu do usługi Azure Data Explorer.

  2. Dodaj jednostkę usługi Microsoft Entra do roli osoby przeglądających w bazie danych usługi Azure Data Explorer.

  3. Określ właściwości połączenia narzędzia pulpitu nawigacyjnego na podstawie informacji z jednostki usługi Microsoft Entra, a następnie przetestuj połączenie.

Tworzenie nazwy głównej usługi

Jednostkę usługi można utworzyć w Azure Portal lub za pomocą interfejsu wiersza polecenia platformy Azure. Niezależnie od używanej metody po utworzeniu uzyskasz wartości dla czterech właściwości połączenia, które będą używane w kolejnych krokach.

Azure Portal

  1. Aby utworzyć jednostkę usługi, postępuj zgodnie z instrukcjami w dokumentacji Azure Portal.

    1. W sekcji Przypisywanie aplikacji do roli przypisz typ roli Czytelnik do klastra usługi Azure Data Explorer.

    2. W sekcji Pobieranie wartości logowania skopiuj trzy wartości właściwości opisane w krokach: Identyfikator katalogu (identyfikator dzierżawy), Identyfikator aplikacji i Hasło.

  2. W Azure Portal wybierz pozycję Subskrypcje, a następnie skopiuj identyfikator subskrypcji, w której utworzono jednostkę usługi.

    Identyfikator subskrypcji — portal.

Interfejs wiersza polecenia platformy Azure

  1. Tworzenie jednostki usługi. Ustaw odpowiedni zakres i typ readerroli .

    az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                             --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
    

    Aby uzyskać więcej informacji, zobacz Tworzenie jednostki usługi platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure.

  2. Polecenie zwraca zestaw wyników podobny do poniższego. Skopiuj trzy wartości właściwości: appID, password i tenant.

    {
      "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "displayName": "{UrlToYourDashboard}:{PortNumber}",
      "name": "https://{UrlToYourDashboard}:{PortNumber}",
      "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
    
  3. Pobierz listę subskrypcji.

    az account list --output table
    

    Skopiuj odpowiedni identyfikator subskrypcji.

    Identyfikator subskrypcji — interfejs wiersza polecenia.

Dodawanie jednostki usługi do roli osoby przeglądających

Teraz, gdy masz jednostkę usługi, dodaj ją do roli osoby przeglądające w bazie danych usługi Azure Data Explorer. To zadanie można wykonać w obszarze Uprawnienia w Azure Portal lub w obszarze Zapytanie przy użyciu polecenia zarządzania.

Azure Portal — uprawnienia

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

  2. W sekcji Przegląd wybierz bazę danych z przykładowymi danymi StormEvents.

    Wybierz bazę danych.

  3. Wybierz pozycję Uprawnienia , a następnie pozycję Dodaj.

    Uprawnienia bazy danych.

  4. W obszarze Dodawanie uprawnień bazy danych wybierz rolę Osoby przeglądająca , a następnie Wybierz podmioty zabezpieczeń.

    Dodaj uprawnienia bazy danych.

  5. Wyszukaj utworzoną jednostkę usługi. Wybierz podmiot zabezpieczeń, a następnie wybierz.

    Zrzut ekranu przedstawiający okienko Azure Portal Nowe podmioty zabezpieczeń. Przycisk Wybierz i dwa pola z niezdecydowalnymi właściwościami jednostki usługi są wyróżnione.

  6. Wybierz pozycję Zapisz.

    Zrzut ekranu przedstawiający okienko Dodawanie uprawnień bazy danych w Azure Portal. Przycisk Zapisz został wyróżniony.

Polecenie zarządzania — zapytanie

  1. W Azure Portal przejdź do klastra usługi Azure Data Explorer i wybierz pozycję Zapytanie.

    Zrzut ekranu przedstawiający klaster usługi Azure Data Explorer w Azure Portal. Element Zapytanie jest wyróżniony.

  2. Uruchom następujące polecenie w oknie zapytania. Użyj identyfikatora aplikacji i identyfikatora dzierżawy z Azure Portal lub interfejsu wiersza polecenia.

    .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
    

    Polecenie zwraca zestaw wyników podobny do poniższego. W tym przykładzie pierwszy wiersz dotyczy istniejącego użytkownika w bazie danych, a drugi wiersz dotyczy jednostki usługi, która została właśnie dodana.

    Zestaw wyników.

Tworzenie łącznika usługi Azure Data Explorer w powłoce redash

  1. Zaloguj się do programu Redash. Wybierz pozycję Rozpocznij , aby utworzyć konto.

  2. W obszarze Rozpocznijmy wybierz pozycję Połącz źródło danych.

    Łączenie źródła danych.

  3. W oknie Tworzenie nowego źródła danych wybierz pozycję Azure Data Explorer (Kusto), a następnie wybierz pozycję Utwórz.

    Wybierz pozycję Azure Data Explorer źródło danych.

  4. W oknie usługi Azure Data Explorer (Kusto) wypełnij następujący formularz i wybierz pozycję Utwórz.

    Okno ustawień usługi Azure Data Explorer (Kusto).

  5. W oknie Ustawienia wybierz pozycję Zapisz i przetestuj połączenie, aby przetestować połączenie ze źródłem danych usługi Azure Data Explorer (Kusto).

Tworzenie zapytań w powłoce redash

  1. W lewym górnym rogu pozycji Redash (Redash) wybierz pozycję CreateQuery (Utwórz> zapytanie). Kliknij pozycję Nowe zapytanie i zmień nazwę zapytania.

    Utwórz zapytanie.

  2. Wpisz zapytanie w górnym okienku edycji i wybierz pozycję Zapisz i wykonaj. Wybierz pozycję Publikuj , aby opublikować zapytanie do użycia w przyszłości.

    Zapisz i wykonaj zapytanie.

    W okienku po lewej stronie nazwa połączenia ze źródłem danych (łącznik Github w naszym przepływie) jest widoczna w menu rozwijanym oraz w tabelach w wybranej bazie danych.

  3. Wyświetl wyniki zapytania w dolnym okienku centralnym. Utwórz wizualizację, aby przejść do zapytania, wybierając przycisk Nowa wizualizacja .

    Nowa wizualizacja.

  4. Na ekranie wizualizacji wybierz typ wizualizacji i odpowiednie pola, takie jak kolumna X i kolumna Y. Zapisz wizualizację.

    Konfigurowanie i zapisywanie wizualizacji.

Tworzenie zapytania przy użyciu parametru

  1. Utworzyć>Zapytanie w celu utworzenia nowego zapytania. Dodaj do niego parametr przy użyciu nawiasów klamrowych {{}}. Wybierz pozycję {{}} , aby otworzyć okno Dodawanie parametru . Możesz również wybrać ikonę ustawień , aby zmodyfikować atrybuty istniejącego parametru i otworzyć <okno parameter_name> .

    wstaw parametr.

  2. Nadaj nazwę parametrowi. Wybierz pozycję Typ: Lista rozwijana oparta na zapytaniach z menu rozwijanego. Wybierz przycisk OK.

    lista rozwijana oparta na zapytaniach.

    Uwaga

    Zapytanie używa wielu wartości, dlatego należy uwzględnić następującą składnię | where Type in ((split('{{Type}}', ','))). Aby uzyskać więcej informacji, zobacz operator in. Powoduje to wyświetlenie wielu opcji parametrów zapytania w aplikacji redash

Tworzenie pulpitu nawigacyjnego w powłoce redash

  1. Aby utworzyć pulpit nawigacyjny, utwórz>pulpit nawigacyjny. Alternatywnie wybierz istniejący pulpit nawigacyjny, pulpity> nawigacyjne wybierz pulpit nawigacyjny z listy.

    Tworzenie pulpitu nawigacyjnego.

  2. W oknie Nowy pulpit nawigacyjny nadaj pulpitowi nawigacyjnemu nazwę i wybierz pozycję Zapisz. W <oknie Dashboard_name> wybierz pozycję Dodaj widżet , aby utworzyć nowy widżet.

  3. W oknie Dodawanie widżetu wybierz pozycję Nazwa zapytania, Wybierz wizualizację i Parametry. Wybierz pozycję Dodaj do pulpitu nawigacyjnego

    Wybierz wizualizacje i dodaj do pulpitu nawigacyjnego.

  4. Wybierz pozycję Gotowe edytowanie , aby ukończyć tworzenie pulpitu nawigacyjnego.

  5. W trybie edycji pulpitu nawigacyjnego wybierz pozycję Użyj filtrów na poziomie pulpitu nawigacyjnego , aby użyć wcześniej zdefiniowanego parametru Type .

    Kończenie tworzenia pulpitu nawigacyjnego.