Gegevens uit Azure Data Explorer in Redash visualiseren

  • Artikel
  • 4 minuten om te lezen

Redash verbindt uw gegevensbronnen en vraagt deze op, bouwt dashboards om gegevens te visualiseren en te delen met collega's. In dit artikel leert u hoe u een Azure Data Explorer als een gegevensbron voor Redash in te stellen en vervolgens gegevens te visualiseren.

Vereisten

De gegevensbron configureren

U voert de volgende stappen uit om de Azure Data Explorer als gegevensbron voor uw dashboardhulpprogramma te configureren. Deze stappen worden in deze sectie uitgebreider beschreven:

  1. Maak een Azure Active Directory service-principal (Azure AD). De service-principal wordt door uw dashboardhulpprogramma gebruikt om toegang te krijgen tot Azure Data Explorer service.

  2. Voeg de Azure AD-service-principal toe aan de rol viewers in de Azure Data Explorer database.

  3. Geef de verbindingseigenschappen van uw dashboardhulpprogramma op op basis van gegevens van de Azure AD-service-principal en test vervolgens de verbinding.

Een service-principal maken

U kunt de service-principal maken in Azure Portal of met behulp van de Azure CLI-opdrachtregelervaring. Ongeacht welke methode u gebruikt, nadat u deze hebt gemaakt, krijgt u waarden voor vier verbindingseigenschappen die u in latere stappen gaat gebruiken.

Azure Portal

  1. Als u de service-principal wilt maken, volgt u de instructies in de Azure Portal documentatie.

    1. Wijs in de sectie De toepassing toewijzen aan een rol het roltype Lezer toe aan uw Azure Data Explorer cluster.

    2. Kopieer in de sectie Get values for signing in de drie eigenschapswaarden die in de stappen worden behandeld: Directory-id (tenant-id), Toepassings-iden Wachtwoord.

  2. Selecteer in Azure Portal abonnementen en kopieer vervolgens de id voor het abonnement waarin u de service-principal hebt gemaakt.

    Abonnements-id - portal.

Azure CLI

  1. Een service-principal maken. Stel een geschikt bereik en een roltype van reader in.

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

    Zie Een Azure-service-principalmaken met Azure CLI voor meer informatie.

  2. De opdracht retourneert een resultatenset zoals de volgende. Kopieer de drie eigenschapswaarden: appID,passworden 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. Haal een lijst met uw abonnementen op.

    az account list --output table

    Kopieer de juiste abonnements-id.

    Abonnements-id - CLI.

De service-principal toevoegen aan de rol viewers

Nu u een service-principal hebt, voegt u deze toe aan de rol viewers in Azure Data Explorer database. U kunt deze taak uitvoeren onder Machtigingen in de Azure Portal of onder Query met behulp van een beheeropdracht.

Azure Portal - Machtigingen

  1. Ga in Azure Portal naar uw Azure Data Explorer cluster.

  2. Selecteer in de sectie Overzicht de database met de StormEvents-voorbeeldgegevens.

    Selecteer database.

  3. Selecteer Machtigingen en vervolgens Toevoegen.

    Databasemachtigingen.

  4. Selecteer onder Databasemachtigingen toevoegende rol Kijker en vervolgens Principals selecteren.

    Voeg databasemachtigingen toe.

  5. Zoek de service-principal die u hebt gemaakt. Selecteer de principal en selecteer vervolgens.

    Schermopname van Azure Portal deelvenster Nieuwe principals. De knop Selecteren en twee velden met niet-versleutelbare service-principal-eigenschappen zijn gemarkeerd.

  6. Selecteer Opslaan.

    Schermopname van het deelvenster Databasemachtigingen toevoegen in Azure Portal. De knop Opslaan is gemarkeerd.

Beheeropdracht - Query

  1. Ga in Azure Portal naar uw Azure Data Explorer cluster en selecteer Query uitvoeren.

    Schermopname van Azure Data Explorer cluster in de Azure Portal. Het item Query is gemarkeerd.

  2. Voer de volgende opdracht uit in het queryvenster. Gebruik de toepassings-id en tenant-id van de Azure Portal of CLI.

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

    De opdracht retourneert een resultatenset zoals de volgende. In dit voorbeeld is de eerste rij voor een bestaande gebruiker in de database en de tweede rij voor de service-principal die zojuist is toegevoegd.

    Resultatenset.

Een Azure Data Explorer-connector maken in Redash

  1. Meld u aan bij Redash. Selecteer Aan de slag om een account te maken.

  2. Selecteer onder Aan de slagde optie Verbinding maken een gegevensbron.

    Verbinding maken een gegevensbron.

  3. Selecteer in het venster Een nieuwe gegevensbron maken Azure Data Explorer (Kusto)en selecteer vervolgens Maken.

    Selecteer Azure Data Explorer gegevensbron.

  4. Vul Azure Data Explorer formulier in het venster Kusto (Kusto) in en selecteer Maken.

    Azure Data Explorer (Kusto)-instellingenvenster.

  5. Selecteer Instellingen het venster Save andTest Connection om de verbinding met uw Azure Data Explorer (Kusto) te testen.

Query's maken in Redash

  1. Selecteer query maken linksboven in Redash. Klik op Nieuwe query en wijzig de naam van de query.

    Query maken.

  2. Typ uw query in het bovenste bewerkingsvenster en selecteer Opslaan en uitvoeren. Selecteer Publiceren om de query te publiceren voor toekomstig gebruik.

    Sla de query op en voer deze uit.

    In het linkerdeelvenster ziet u de naam van de gegevensbronverbinding(Github-connector in onze stroom) in de vervolgkeuzelijst en de tabellen in de geselecteerde database.

  3. Bekijk de queryresultaten in het onderste centrale deelvenster. Maak een visualisatie voor de query door de knop Nieuwe visualisatie te selecteren.

    Nieuwe visualisatie.

  4. Selecteer in het visualisatiescherm het Visualisatietype en de relevante velden, zoals X-kolom en Y-kolom. Sla de visualisatie op.

    Visualisatie configureren en opslaan.

Een query maken met behulp van een parameter

  1. MakenEen query uitvoeren om een nieuwe query te maken. Voeg er een parameter aan toe met behulp van { {} } vierkante haken. Selecteer { } om het venster Parameter toevoegen te openen. U kunt ook het instellingenpictogram selecteren om de kenmerken van een bestaande parameter te wijzigen en het venster parameter_name openen.

    parameter invoegen.

  2. Noem uw parameter. Selecteer Type:Vervolgkeuzelijst op basis van query's in het vervolgkeuzemenu. Selecteer OK

    vervolgkeuzelijst op basis van query's.

    Notitie

    De query maakt gebruik van meerdere waarden. Daarom moet u de volgende syntaxis | where Type in ((split('{{Type}}', ','))) opnemen. Zie in operator voor meer informatie. Dit resulteert in meerdere opties voor queryparameters in de Redash-app

Een dashboard maken in Redash

  1. Maak dashboard om uw dashboard temaken. U kunt ook bestaand dashboard selecteren. Dashboards selecteren een dashboard in de lijst.

    Dashboard maken.

  2. In het venster Nieuw dashboard geeft u uw dashboard een naam en selecteert u Opslaan. Selecteer Dashboard_name > het venster Widget > een nieuwe widget te maken.

  3. Selecteer in het venster Widget toevoegen de querynaam, Kies Visualisatieen Parameters. Toevoegen aan dashboard selecteren

    Kies visualisaties en voeg toe aan het dashboard.

  4. Selecteer Klaar met bewerken om het maken van het dashboard te voltooien.

  5. Selecteer in de bewerkingsmodus van het dashboard Filters op dashboardniveau gebruiken om de eerder gedefinieerde typeparameter te gebruiken.

    Voltooi het maken van het dashboard.

Volgende stappen