쿼리 기반 매개 변수 사용
이 문서에서는 쿼리 기반 매개 변수를 사용하는 대화형 대시보드를 만드는 단계를 안내합니다. Azure Databricks에서 대시보드를 빌드하는 기본적인 지식이 있다고 가정합니다. 대시보드 만들기에 대한 기본 지침은 시작을 참조하세요.
요구 사항
- Azure Databricks 작업 영역에 로그인합니다.
- 해당 작업 영역에서 SQL 자격이 있습니다.
- 하나 이상의 SQL 웨어하우스에 대한 액세스를 사용할 수 있습니다.
데이터 세트 대시보드 만들기
이 자습서에서는 Azure Databricks의 샘플 카탈로그에서 생성된 데이터를 사용합니다.
사이드바에서
새로 만들기를 클릭하고 대시보드를 선택합니다.데이터 탭을 클릭합니다.
쿼리 편집기에 다음 쿼리를 붙여 넣고 SQL에서 만들기를 클릭합니다. 그런 다음 실행을 클릭하여 결과를 반환합니다.
SELECT * FROM samples.tpch.customer새로 정의된 데이터 세트는 제목 없는 데이터 세트라는 이름으로 자동 저장됩니다. 제목을 두 번 클릭한 다음 마케팅 세그먼트의 이름을 바꿉니다.
매개 변수 추가
이 데이터 세트에 매개 변수를 추가하여 반환된 값을 필터링할 수 있습니다. 이 예제의 매개 변수는 :segment입니다. 매개 변수 구문에 대한 자세한 내용은 대시보드 매개 변수 작업을 참조하세요.
쿼리의 맨 아래에 다음
WHERE절을 붙여넣습니다.segment매개 변수 이름이 있는 텍스트 필드가 쿼리 아래에 표시됩니다.WHERE c_mktsegment = :segment쿼리 아래의 텍스트 필드에
BUILDING을(를) 입력하여 매개 변수의 기본값을 설정합니다.쿼리를 다시 실행하여 결과를 검사합니다.
시각화 위젯 구성
다음 단계를 완료하여 캔버스에서 데이터 세트에 대한 시각화를 추가합니다.
- 캔버스 탭을 클릭합니다.
시각화 추가를 클릭하여 시각화 위젯을 추가하고 마우스를 사용하여 캔버스에 배치합니다.
X축 설정
- 필요한 경우 시각화 드롭다운 메뉴에서 막대를 선택합니다.
을 클릭하여 X축을 따라 표시되는 데이터를 선택합니다. 검색 막대를 사용하여 이름별 필드를 검색할 수 있습니다. c_nationkey를 선택합니다.- 선택한 필드 이름을 클릭하여 추가 구성 옵션을 봅니다.
- 배율 유형으로 범주를 선택합니다.
- 변환 선택 영역의 경우 없음을 선택합니다.
Y축 설정
- Y축 옆의 을 클릭한 다음 c_acctbal을 선택합니다.
- 선택한 필드 이름을 클릭하여 추가 구성 옵션을 봅니다.
- 배율 유형으로 정량적을 선택합니다.
- 변환 선택 영역의 경우 SUM을 선택합니다.
시각화는 구성할 때 자동으로 업데이트됩니다. 표시된 데이터에는 segment이(가) BUILDING인 레코드만 포함됩니다.
필터 추가
대시보드 뷰어에서 집중할 마케팅 세그먼트를 제어할 수 있도록 필터를 설정합니다.
필터 추가(필드/매개 변수)를 클릭하여 필터 위젯을 추가합니다. 캔버스에 놓습니다.- 구성 패널의 필터 드롭다운 메뉴에서 단일 값을 선택합니다.
- 필터 위젯에 제목 필드를 표시하려면 제목 확인란을 선택합니다.
- 위젯에서 자리 표시자 제목을 클릭하고 세그먼트를 입력하여 필터를 다시 입력합니다.
- 구성 패널에서 매개 변수 옆의 을 클릭합니다.
- 마케팅 세그먼트 데이터 세트에서 세그먼트를 선택합니다.
구성된 필터 위젯에는 데이터 세트의 기본 매개 변수 값이 표시됩니다.
값 선택 정의
만든 필터는 작동하지만 선택 영역을 입력하기 전에 뷰어가 사용 가능한 선택 범위를 알고 있어야 합니다. 또한 사용자가 원하는 매개 변수 값을 입력할 때 대/소문자와 맞춤법을 일치해야 합니다.
뷰어가 사용 가능한 옵션 목록에서 매개 변수를 선택할 수 있도록 드롭다운 목록을 만들려면 새 데이터 세트를 만들어 가능한 값 목록을 정의합니다.
데이터 탭을 클릭합니다.
SQL에서 만들기를 클릭하여 새 데이터 세트를 만듭니다.
다음을 복사하여 편집기에 붙여넣습니다.
SELECT DISTINCT c_mktsegment FROM samples.tpch.customer쿼리를 실행하고 결과를 검사합니다. 테이블의 5개 마케팅 세그먼트가 결과에 표시됩니다.
자동으로 생성된 제목을 두 번 클릭한 다음 이 데이터 세트 세그먼트 선택 항목의 이름을 바꿉니다.
필터 업데이트
사용자가 선택할 수 있는 값의 드롭다운 목록을 채우기 위해 방금 만든 데이터 세트를 사용하도록 기존 필터를 업데이트합니다.
- Canvas를 클릭합니다. 그런 다음 이전 단계에서 만든 필터 위젯을 클릭합니다.
- 필드 옆의 을 클릭합니다.
- 세그먼트 선택을 클릭한 다음
c_mktsegment필드 이름을 클릭합니다.
구성을 변경하면 필터 위젯이 업데이트됩니다. 필터 위젯의 필드를 클릭하여 드롭다운 메뉴에서 사용 가능한 선택 항목을 확인합니다.
참고 항목
이 자습서에는 쿼리 기반 매개 변수를 사용하는 방법을 보여 주는 간소화된 사용 사례가 포함되어 있습니다. 이 대시보드를 만드는 다른 방법은 c_mktsegment 필드에 필터를 적용하는 것입니다.
다음 단계
다음 문서를 사용하여 대시보드를 사용하는 방법을 계속 알아봅니다.
- 필터링 적용에 대해 자세히 알아보기 필터를 참조하세요.
- 대시보드 매개 변수에 대해 자세히 알아봅니다. 대시보드 매개 변수 작업을 참조하세요.
- 대시보드 게시 및 공유 대시보드 게시를 참조하세요.