Redash의 Azure 데이터 탐색기에서 데이터 시각화Visualize data from Azure Data Explorer in Redash

Redash 는 데이터 원본을 연결 하 고 쿼리하고 데이터를 시각화 하 고 동료와 공유할 수 있는 대시보드를 작성 합니다.Redash connects and queries your data sources, builds dashboards to visualize data and share them with peers. 이 문서에서는 Redash에 대 한 데이터 원본으로 Azure 데이터 탐색기를 설정 하 고 데이터를 시각화 하는 방법에 대해 알아봅니다.In this article, you learn how to set up Azure Data Explorer as a data source for Redash, and then visualize data.

전제 조건Prerequisites

  1. 클러스터 및 데이터베이스를 만듭니다.Create cluster and database.
  2. Azure 데이터 탐색기에 샘플 데이터 수집에 설명 된 대로 데이터를 수집 합니다.Ingest data as explained in ingest sample data into Azure Data Explorer. 수집 옵션에 대 한 자세한 내용은 수집 개요를 참조 하세요.For more ingestion options, see ingestion overview.

데이터 원본 구성Configure the data source

다음 단계를 수행 하 여 Azure 데이터 탐색기를 대시보드 도구의 데이터 원본으로 구성 합니다.You perform the following steps to configure Azure Data Explorer as a data source for your dashboard tool. 이 섹션에서 이 단계를 더 자세히 다룹니다.We'll cover these steps in more detail in this section:

  1. Azure Active Directory(Azure AD) 서비스 주체를 만듭니다.Create an Azure Active Directory (Azure AD) service principal. 서비스 주체는 대시보드 도구에서 Azure 데이터 탐색기 서비스에 액세스 하는 데 사용 됩니다.The service principal is used by your dashboard tool to access the Azure Data Explorer service.

  2. Azure AD 서비스 주체를 Azure Data Explorer 데이터베이스에서 뷰어 역할에 추가합니다.Add the Azure AD service principal to the viewers role in the Azure Data Explorer database.

  3. Azure AD 서비스 주체의 정보에 따라 대시보드 도구 연결 속성을 지정 하 고 연결을 테스트 합니다.Specify your dashboard tool connection properties based on information from the Azure AD service principal, then test the connection.

서비스 주체 만들기Create a service principal

Azure CLI 명령줄 환경을 사용하여 또는 Azure Portal에 서비스 주체를 만들 수 있습니다.You can create the service principal in the Azure portal or using the Azure CLI command-line experience. 어떤 방법을 사용하든 서비스 주체를 만든 후 이후 단계에서 사용하는 네 가지 연결 속성에 대한 값을 가져옵니다.Regardless of which method you use, after creation you get values for four connection properties that you'll use in later steps.

Azure portalAzure portal

  1. 서비스 주체를 만들려면 Azure Portal 설명서의 지침을 따릅니다.To create the service principal, follow the instructions in the Azure portal documentation.

    1. 역할에 애플리케이션 할당 섹션에서 Reader 역할 유형을 Azure Data Explorer 클러스터에 할당합니다.In the Assign the application to a role section, assign a role type of Reader to your Azure Data Explorer cluster.

    2. 로그인에 사용할 값 가져오기 섹션에서 디렉터리 ID (테 넌 트 Id), 응용 프로그램 id암호단계에서 설명 하는 세 가지 속성 값을 복사 합니다.In the Get values for signing in section, copy the three property values covered in the steps: Directory ID (tenant ID), Application ID, and Password.

  2. Azure Portal에서 구독을 선택한 다음, 서비스 주체를 만든 구독에 대한 ID를 복사합니다.In the Azure portal, select Subscriptions then copy the ID for the subscription in which you created the service principal.

    구독 ID - Portal

Azure CLIAzure CLI

  1. 서비스 주체를 생성합니다.Create a service principal. reader의 해당 범위 및 역할 유형을 설정합니다.Set an appropriate scope and a role type of reader.

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

    자세한 내용은 Azure CLI을 사용하여 Azure 서비스 주체 만들기를 참조하세요.For more information, see Create an Azure service principal with Azure CLI.

  2. 명령은 다음과 같이 결과 집합을 반환합니다.The command returns a result set like the following. 세 가지 속성 값 appID, 암호테넌트를 복사합니다.Copy the three property values: appID, password, and 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. 구독 목록을 가져옵니다.Get a list of your subscriptions.

    az account list --output table
    

    해당 구독 ID를 복사합니다.Copy the appropriate subscription ID.

    구독 ID - CLI

뷰어 역할에 서비스 주체 추가Add the service principal to the viewers role

서비스 주체를 만들었으므로, 이제 Azure Data Explorer 데이터베이스에서 뷰어 역할에 추가합니다.Now that you have a service principal, you add it to the viewers role in the Azure Data Explorer database. 관리 명령을 사용하여 Azure Portal의 사용 권한 또는 쿼리에서 이 작업을 수행할 수 있습니다.You can perform this task under Permissions in the Azure portal, or under Query by using a management command.

Azure Portal - 사용 권한Azure portal - Permissions

  1. Azure Portal에서 Azure Data Explorer 클러스터로 이동합니다.In the Azure portal, go to your Azure Data Explorer cluster.

  2. 개요 섹션에서 StormEvents 샘플 데이터를 사용하여 데이터베이스를 선택합니다.In the Overview section, select the database with the StormEvents sample data.

    데이터베이스 선택

  3. 권한을 선택한 다음, 추가를 선택합니다.Select Permissions then Add.

    데이터베이스 사용 권한

  4. 데이터베이스 권한 추가에서 뷰어 역할을 선택한 다음, 주체 선택을 선택합니다.Under Add database permissions, select the Viewer role then Select principals.

    데이터베이스 권한 추가

  5. 만든 서비스 사용자를 검색 합니다.Search for the service principal you created. 주체를 선택한 다음, 선택을 클릭합니다.Select the principal, then Select.

    Azure Portal 새 보안 주체 창의 스크린샷 선택 단추와 판독할 수 없는 서비스 사용자 속성의 두 필드가 강조 표시 됩니다.

  6. 저장을 선택합니다.Select Save.

    Azure Portal 새 보안 주체 창의 스크린샷 선택 단추와 판독할 수 없는 서비스 사용자 속성의 두 필드가 강조 표시 됩니다.

관리 명령 - 쿼리Management command - Query

  1. Azure Portal에서 Azure Data Explorer 클러스터로 이동한 다음, 쿼리를 선택합니다.In the Azure portal, go to your Azure Data Explorer cluster, and select Query.

    Azure Portal 새 보안 주체 창의 스크린샷 선택 단추와 판독할 수 없는 서비스 사용자 속성의 두 필드가 강조 표시 됩니다.

  2. 쿼리 창에서 다음 명령을 실행합니다.Run the following command in the query window. Azure Portal 또는 CLI에서 애플리케이션 ID 및 테넌트 ID를 사용합니다.Use the application ID and tenant ID from the Azure portal or CLI.

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

    명령은 다음과 같이 결과 집합을 반환합니다.The command returns a result set like the following. 이 예제에서 첫 번째 행은 데이터베이스에서 기존 사용자를 사용되며 두 번째 행은 방금 추가된 서비스 주체를 위해 사용됩니다.In this example, the first row is for an existing user in the database, and the second row is for the service principal that was just added.

    결과 집합

Redash에서 Azure 데이터 탐색기 커넥터 만들기Create Azure Data Explorer Connector in Redash

  1. Redash에 로그인 합니다.Sign in to Redash. 시작 을 선택 하 여 계정을 만듭니다.Select Get Started to create an account.

  2. 시작 하기에서 데이터 원본 연결을 선택 합니다.Under Let's get started, Select Connect a Data Source.

    데이터 원본에 연결

  3. 새 데이터 원본 만들기 창에서 Azure 데이터 탐색기 (kusto) 를 선택 하 고 만들기를 선택 합니다.In Create a New Data Source window, select Azure Data Explorer (Kusto), then select Create.

    Azure 데이터 탐색기 데이터 원본 선택

  4. Azure 데이터 탐색기 (Kusto) 창에서 다음 양식을 작성 하 고 만들기를 선택 합니다.In Azure Data Explorer (Kusto) window, complete the following form and select Create.

    Azure 데이터 탐색기 (Kusto) 설정 창

  5. 설정 창에서 연결 저장테스트 를 선택 하 여 Azure 데이터 탐색기 (kusto) 데이터 원본 연결을 테스트 합니다.In Settings window, select Save and Test Connection to test your Azure Data Explorer (Kusto) data source connection.

Redash에서 쿼리 만들기Create queries in Redash

  1. Redash의 왼쪽 위에서 쿼리 만들기를 선택 > Query합니다.On top left of Redash, select Create > Query. 새 쿼리 를 클릭 하 고 쿼리 이름을 바꿉니다.Click on New Query and rename the query.

    쿼리 만들기

  2. 위쪽 편집 창에 쿼리를 입력 하 고 저장실행을 선택 합니다.Type your query in the top editing pane and select Save and Execute. 게시 를 선택 하 여 나중에 사용 하기 위해 쿼리를 게시 합니다.Select Publish to publish query for future use.

    쿼리 저장 및 실행

    왼쪽 창에서 드롭다운 메뉴의 데이터 원본 연결 이름 (Github 커넥터 )과 선택한 데이터베이스의 테이블을 볼 수 있습니다.In the left pane, you can see the data source connection name (Github connector in our flow) in the drop-down menu, and the tables in the selected database.

  3. 아래쪽 가운데 창에서 쿼리 결과를 확인 합니다.View the query results in the bottom central pane. 새 시각화 단추를 선택 하 여 쿼리와 함께 이동 하는 시각화를 만듭니다.Create a visualization to go with the query by selecting the New Visualization button.

    새 시각화

  4. 시각화 화면에서 시각화 유형X 열Y 열과 같은 관련 필드를 선택 합니다.In the visualization screen, select the Visualization Type and the relevant fields such as X Column and Y Column. 시각화를 저장 합니다.Save the visualization.

    시각화 구성 및 저장

매개 변수를 사용 하 여 쿼리 만들기Create a query using a parameter

  1. 만들기 > 새 쿼리를 만들기 위한 쿼리입니다 .Create > Query to create a new query. {} 중괄호를 사용 하 여 매개 변수를 추가 {} 합니다.Add a parameter to it using {{}} curly brackets. { {} } 를 선택 하 여 매개 변수 추가 창을 엽니다.Select {{}} to open Add Parameter window. 설정 아이콘 을 선택 하 여 기존 매개 변수의 특성을 수정 하 고 <parameter_name> 창으로 열 수도 있습니다.You can also select the settings icon to modify the attributes of an existing parameter and open the <parameter_name> window.

    매개 변수 삽입

  2. 매개 변수의 이름을로 합니다.Name your parameter. 드롭다운 메뉴에서 유형: 쿼리 기반 드롭다운 목록 을 선택 합니다.Select Type: Query Based Dropdown List from dropdown menu. 확인을 선택합니다.Select OK

    쿼리 기반 드롭다운 목록

    참고

    쿼리에서는 여러 값을 사용 하므로 다음 구문을 포함 해야 합니다 | where Type in ((split('{{Type}}', ','))) .The query uses multiple values, therefore you must include the following syntax | where Type in ((split('{{Type}}', ','))). 자세한 내용은 in 연산자를 참조 하십시오.For more information, see in operator. 그러면 redash app의 여러 쿼리 매개 변수 옵션이 생성 됩니다.This results in multiple query parameter options in redash app

Redash에서 대시보드 만들기Create a dashboard in Redash

  1. 대시보드를 만들려면 대시보드를 만듭니다 > Dashboard.To create your dashboard, Create > Dashboard. 또는 기존 대시보드를 선택 하 > 대시보드 를 선택 하 고 목록에서 대시보드를 선택 합니다.Alternatively, select existing dashboard, Dashboards > select a dashboard from the list.

    대시보드 만들기

  2. 새 대시보드 창에서 대시보드 이름을로 선택 하 고 저장을 선택 합니다.In New Dashboard window, name your dashboard and select Save. <Dashboard_name> 창에서 위젯 추가 를 선택 하 여 새 위젯을 만듭니다.In <Dashboard_name> window, select Add Widget to create a new widget.

  3. 위젯 추가 창에서 쿼리 이름을 선택 하 고 시각화를 선택한 다음 매개 변수를 선택 합니다.In Add Widget window, select query name, Choose Visualization, and Parameters. 대시보드에 추가를 선택 합니다 .Select Add to Dashboard

    시각화를 선택 하 고 대시보드에 추가

  4. 편집 완료 를 선택 하 여 대시보드 만들기를 완료 합니다.Select Done Editing to complete dashboard creation.

  5. 대시보드 편집 모드에서 대시보드 수준 필터 사용 을 선택 하 여 이전에 정의 된 형식 매개 변수를 사용 합니다.In the dashboard edit mode, select Use Dashboard Level Filters to use the Type parameter previously defined.

    대시보드 만들기 완료

다음 단계Next steps