Visualisera data från Azure Data Explorer i Redash

Redash ansluter och frågar dina datakällor, skapar instrumentpaneler för att visualisera data och dela dem med peer-användare. I den här artikeln får du lära dig hur Azure Data Explorer konfigureras som en datakälla för Redash och sedan visualiserar data.

Förutsättningar

Konfigurera datakällan

Du utför följande steg för att konfigurera Azure Data Explorer som en datakälla för ditt instrumentpanelsverktyg. Vi går in mer ingående på de här stegen i det här avsnittet:

  1. Skapa ett Azure Active Directory (Azure AD) för tjänstens huvudnamn. Tjänstens huvudnamn används av ditt instrumentpanelsverktyg för att komma åt Azure Data Explorer tjänsten.

  2. Lägg till Azure AD-tjänstens huvudnamn till tittarrollen i Azure Data Explorer databasen.

  3. Ange anslutningsegenskaper för instrumentpanelsverktyget baserat på information från Azure AD-tjänstens huvudnamn och testa sedan anslutningen.

Skapa ett huvudnamn för tjänsten

Du kan skapa tjänstens huvudnamn i Azure Portal eller använda Azure CLI-kommandoradsupplevelsen. Oavsett vilken metod du använder får du efter skapandet värden för fyra anslutningsegenskaper som du ska använda i senare steg.

Azure Portal

  1. Skapa tjänstens huvudnamn genom att följa anvisningarna i Azure Portal dokumentationen.

    1. I avsnittet Tilldela programmet till en roll tilldelar du rolltypen Läsare till ditt Azure Data Explorer kluster.

    2. I avsnittet Hämta värden för inloggning kopierar du de tre egenskapsvärdena som ingår i stegen: Katalog-ID (klient-ID), Program-IDoch Lösenord.

  2. I den Azure Portal väljer du Prenumerationer och kopierar sedan ID:t för den prenumeration där du skapade tjänstens huvudnamn.

    Prenumerations-ID – portalen.

Azure CLI

  1. Skapa ett huvudnamn för tjänsten. Ange ett lämpligt omfång och en rolltyp för reader .

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

    Mer information finns i Skapa ett huvudnamn för Azure-tjänsten med Azure CLI.

  2. Kommandot returnerar en resultatuppsättning som liknar följande. Kopiera de tre egenskapsvärdena: appID,passwordoch 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. Hämta en lista över dina prenumerationer.

    az account list --output table
    

    Kopiera lämpligt prenumerations-ID.

    Prenumerations-ID – CLI.

Lägga till tjänstens huvudnamn till tittarrollen

Nu när du har ett huvudnamn för tjänsten kan du lägga till det i tittarrollen i Azure Data Explorer databasen. Du kan utföra den här uppgiften under Behörigheter i Azure Portal eller under Fråga med hjälp av ett hanteringskommando.

Azure Portal – Behörigheter

  1. I Azure Portal du till ditt Azure Data Explorer kluster.

  2. I avsnittet Översikt väljer du databasen med StormEvents-exempeldata.

    Välj databas.

  3. Välj Behörigheter och sedan Lägg till.

    Databasbehörigheter.

  4. Under Lägg till databasbehörigheterväljer du rollen Läsare och sedan Välj huvudnamn.

    Lägg till databasbehörigheter.

  5. Sök efter tjänstens huvudnamn som du skapade. Välj huvudnamn och sedan Välj.

    Skärmbild av fönstret Azure Portal Nya huvudnamn. Knappen Välj och två fält med inchiffrbara egenskaper för tjänstens huvudnamn är markerade.

  6. Välj Spara.

    Skärmbild av fönstret Lägg till databasbehörigheter i Azure Portal. Knappen Spara är markerad.

Hanteringskommando – Fråga

  1. I Azure Portal du till ditt Azure Data Explorer kluster och väljer Fråga.

    Skärmbild av ett Azure Data Explorer kluster i Azure Portal. Frågeobjektet är markerat.

  2. Kör följande kommando i frågefönstret. Använd program-ID och klientorganisations-ID från Azure Portal eller CLI.

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

    Kommandot returnerar en resultatuppsättning som liknar följande. I det här exemplet är den första raden för en befintlig användare i databasen och den andra raden är för tjänstens huvudnamn som precis har lagts till.

    Resultatuppsättning.

Skapa Azure Data Explorer-anslutning i Redash

  1. Logga in på Redash. Välj Kom igång för att skapa ett konto.

  2. Under Låt oss komma igång väljerdu Anslut en datakälla.

    Anslut en datakälla.

  3. I fönstret Skapa en ny datakälla väljer du Azure Data Explorer (Kusto)och sedan Skapa.

    Välj Azure Data Explorer datakälla.

  4. I Azure Data Explorer (Kusto) fyller du i följande formulär och väljer Skapa.

    Azure Data Explorer (Kusto) inställningsfönster.

  5. I Inställningar väljer du Spara och testa anslutningen för att testa Azure Data Explorer (Kusto)-datakällsanslutningen.

Skapa frågor i Redash

  1. Längst upp till vänster i Redash väljer du Skapafråga. Klicka på Ny fråga och byt namn på frågan.

    Skapa fråga.

  2. Skriv frågan i det övre redigeringsfönstret och välj Spara och kör. Välj Publicera för att publicera frågan för framtida användning.

    Spara och kör fråga.

    I den vänstra rutan kan du se anslutningsnamnet för datakällan(Github-anslutningsappen i vårt flöde) i den nedrullningsbar menyn och tabellerna i den valda databasen.

  3. Visa frågeresultaten i det nedre centrala fönstret. Skapa en visualisering för att använda frågan genom att välja knappen Ny visualisering.

    Ny visualisering.

  4. På visualiseringsskärmen väljer du Visualiseringstyp och relevanta fält som X-kolumn och Y-kolumn. Spara visualiseringen.

    Konfigurera och spara visualisering.

Skapa en fråga med en parameter

  1. SkapaFråga för att skapa en ny fråga. Lägg till en parameter till den med hjälp av { {} } klammerparenteser. Välj { } för att öppna fönstret Lägg till parameter. Du kan också välja inställningsikonen för att ändra attributen för en befintlig parameter och öppna parameter_name fönstret.

    insert-parametern.

  2. Ge parametern ett namn. Välj Typ:Frågebaserad listmeny i listrutan. Välj OK

    frågebaserad listrutan.

    Anteckning

    Frågan använder flera värden, och därför måste du inkludera följande syntax | where Type in ((split('{{Type}}', ','))) . Mer information finns i i operatorn. Detta resulterar i flera alternativ för frågeparametrar i redash-appen

Skapa en instrumentpanel i Redash

  1. Skapa instrumentpanelen genom att skapainstrumentpanelen. Du kan också välja befintlig instrumentpanel, instrumentpaneler och välja en instrumentpanel i listan.

    Skapa instrumentpanel.

  2. I fönstret Ny instrumentpanel ger du instrumentpanelen ett namn och väljer Spara. I Dashboard_name > väljer du Lägg > att skapa en ny widget.

  3. I fönstret Lägg till widget väljer du frågenamn, Välj visualiseringoch Parametrar. Välj Lägg till på instrumentpanelen

    Välj visualiseringar och lägg till på instrumentpanelen.

  4. Välj Klar redigering för att slutföra skapandet av instrumentpanelen.

  5. I redigeringsläget för instrumentpanelen väljer du Använd filter på instrumentpanelsnivå för att använda parametern Typ som definierats tidigare.

    Slutför skapandet av instrumentpanelen.

Nästa steg