쿼리 기반 매개 변수 사용

이 문서에서는 쿼리 기반 매개 변수를 사용하는 대화형 대시보드를 만드는 단계를 안내합니다. Azure Databricks에서 대시보드를 빌드하는 기본적인 지식이 있다고 가정합니다. 대시보드 만들기에 대한 기본 지침은 시작을 참조하세요.

요구 사항

• Azure Databricks 작업 영역에 로그인합니다.
• 해당 작업 영역에 SQL 자격이 있습니다.
• 하나 이상의 SQL 웨어하우스에 대해 최소한 CAN USE 액세스 권한이 있습니다.

데이터 세트 대시보드 만들기

이 자습서에서는 Azure Databricks의 샘플 카탈로그에서 생성된 데이터를 사용합니다.

1. 사이드바에서 새로 만들기를 클릭하고 메뉴뉴에서 대시보드를 선택합니다.

2. 데이터 탭을 클릭합니다.

3. SQL에서 만들기를 클릭하고 다음 쿼리를 편집기에 붙여넣습니다. 그런 다음 실행을 클릭하여 결과를 반환합니다.

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. 새로 정의된 데이터 세트는 제목 없는 데이터 세트라는 이름으로 자동 저장됩니다. 제목을 두 번 클릭한 후 이름을 마케팅 세그먼트로 변경합니다.

매개 변수 추가

이 데이터 세트에 매개 변수를 추가하여 반환된 값을 필터링할 수 있습니다. 이 예제의 매개 변수는 :segment입니다. 매개 변수 구문에 대한 자세한 내용은 대시보드 매개 변수 작업을 참조하세요.

1. 쿼리의 맨 아래에 다음 WHERE 절을 붙여넣습니다. segment 매개 변수 이름이 있는 텍스트 필드가 쿼리 아래에 표시됩니다.

   WHERE
     c_mktsegment = :segment
   

2. 쿼리 아래의 텍스트 필드에 BUILDING을 입력하여 매개 변수의 기본값을 설정합니다.

3. 쿼리를 다시 실행하여 결과를 검사합니다.

시각적 개체 위젯 구성

다음 단계를 완료하여 캔버스에서 데이터 세트의 시각적 개체를 추가합니다.

1. 캔버스 탭을 클릭합니다.
2. 시각적 개체 추가를 클릭하여 시각적 개체 위젯을 추가하고 마우스를 사용하여 캔버스에 배치합니다.

X축 설정

1. 필요한 경우 시각적 개체 드롭다운 메뉴에서 막대를 선택합니다.
2. 을 클릭하여 X축을 따라 표시되는 데이터를 선택합니다. 검색 창을 사용하여 이름으로 필드를 검색할 수 있습니다. c_nationkey를 선택합니다.
3. 선택한 필드 이름을 클릭하여 추가 구성 옵션을 봅니다.
   • 스케일링 유형으로 범주를 선택합니다.
   • 변환 선택 영역에 없음을 선택합니다.

Y축 설정

1. Y축 옆의 을 클릭한 다음 c_acctbal을 선택합니다.
2. 선택한 필드 이름을 클릭하여 추가 구성 옵션을 봅니다.
   • 스케일링 유형으로 양적을 선택합니다.
   • 변환 선택 영역에 합계를 선택합니다.

시각적 개체는 구성할 때 자동으로 업데이트됩니다. 표시된 데이터에는 segment가 BUILDING인 레코드만 포함됩니다.

필터 추가

어떤 마케팅 세그먼트에 집중해야 할지 제어할 수 있도록 필터를 설정합니다.

1. 필터 추가(필드/매개 변수)를 클릭하여 필터 위젯을 추가합니다. 캔버스에 놓습니다.
2. 구성 패널의 필터 드롭다운 메뉴에서 단일 값을 선택합니다.
3. 필터 위젯에 제목 필드를 표시하려면 제목 확인란을 선택합니다.
4. 위젯의 자리 표시자 제목을 클릭하고 세그먼트를 입력하여 필터 제목을 변경합니다.
5. 구성 패널에서 매개 변수 옆의 을 클릭합니다.
6. 마케팅 세그먼트 데이터 세트에서 세그먼트를 선택합니다.

구성된 필터 위젯에는 데이터 세트의 기본 매개 변수 값이 표시됩니다.

값 선택 정의

만든 필터는 작동하지만 선택 영역을 입력하기 전에 뷰어가 사용 가능한 선택 범위를 알고 있어야 합니다. 또한 사용자가 원하는 매개 변수 값을 입력할 때 대/소문자와 맞춤법이 일치해야 합니다.

뷰어가 사용 가능한 옵션 목록에서 매개 변수를 선택할 수 있도록 드롭다운 목록을 만들려면 새 데이터 세트를 만들어 가능한 값 목록을 정의합니다.

1. 데이터 탭을 클릭합니다.

2. SQL에서 만들기를 클릭하여 새 데이터 세트를 만듭니다.

3. 다음을 복사하여 편집기에 붙여넣습니다.

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. 쿼리를 실행하고 결과를 검사합니다. 테이블의 5개 마케팅 세그먼트가 결과에 표시됩니다.

5. 자동으로 생성된 제목을 두 번 클릭한 다음 이 데이터 세트의 이름을 세그먼트 선택으로 변경합니다.

필터 업데이트

방금 만든 데이터 세트를 사용하여 기존 필터를 업데이트하여 사용자가 선택할 수 있는 값의 드롭다운 목록을 채웁니다.

1. 캔버스스를 클릭합니다. 그런 다음 이전 단계에서 만든 필터 위젯을 클릭합니다.
2. 필드 옆의 을 클릭합니다.
3. 세그먼트 선택을 클릭한 다음 c_mktsegment 필드 이름을 클릭합니다.

구성을 변경하면 필터 위젯이 업데이트됩니다. 필터 위젯의 필드를 클릭하여 드롭다운 메뉴에서 사용 가능한 선택 항목을 확인합니다.

참고 항목

이 자습서에는 쿼리 기반 매개 변수를 사용하는 방법을 보여 주는 간소화된 사용 사례가 포함되어 있습니다. 이 대시보드를 만드는 다른 방법은 c_mktsegment 필드에 필터를 적용하는 것입니다.

다음 단계

다음 문서에서 대시보드를 사용하는 방법을 계속 알아봅니다.

• 필터 적용에 대해 자세히 알아보기 필터 사용을 참조 하세요.
• 대시보드 매개 변수에 대해 자세히 알아봅니다. 대시보드 매개 변수 작업을 참조하세요.
• 대시보드 게시 및 공유 대시보드 게시를 참조하세요.