매개 변수를 사용하면 쿼리가 실행될 때마다 쿼리의 필터 또는 계산과 함께 사용할 값을 묻는 메시지를 표시할 수 있습니다. 런타임에 이러한 값을 설정하면 실행될 때마다 계정, 지역 또는 기간과 같은 다른 컨텍스트에서 쿼리를 사용할 수 있습니다. 특정 쿼리에 사용할 매개 변수를 만들거나 작업 영역 소유자의 경우 여러 쿼리에 사용할 전역 매개 변수를 만들 수 있습니다.
쿼리 매개 변수 생성
Builder 또는 SQL 편집기로 쿼리 매개 변수를 만들 수 있습니다. 매개 변수를 만들 때 쿼리에서 여러 필터 및 계산과 함께 사용할 수 있습니다.
1단계. 매개 변수 생성
- 매개 변수 패널에서 추가를 클릭하고 새 매개 변수 만들기를 선택합니다.
- 매개 변수를 쉽게 식별하려면 영숫자 문자만 사용하고 공백 없이 고유한 이름을 입력합니다.
- 필터 유형에서 필터링할 데이터 유형(예: 텍스트 또는 정수)을 선택합니다.
2단계. 매개 변수 값 설정
쿼리가 실행될 때 해당 매개 변수는 데이터 유형에 따라 자유 형식 값을 허용하거나 선택할 특정 값 목록을 제공할 수 있습니다.
- 자유 형식 값을 허용하려면 기본값(해당되는 경우)을 입력하고 만들기를 클릭합니다.
- 특정 값 목록을 제공하려면:
- 선택 목록을 활성화합니다.
- 매개 변수에 대해 여러 값을 활성화하려면 다중 선택을 선택합니다.
- 목록 옵션에서 선택할 값을 입력하고 입력할 때마다 Enter를 누릅니다.
참고: 날짜 또는 타임스탬프 매개 변수의 경우 각 옵션을
YYYY-MM-dd형식으로 입력합니다. - 매개 변수의 기본값을 선택하고 만들기를 클릭합니다.
참고: 다중 선택 매개 변수의 경우 하나 이상의 기본값을 선택합니다.
3단계. 쿼리에서 매개 변수 사용
매개 변수 값을 쿼리에 적용하려면 필터 또는 계산에서 사용합니다.
- 빌더의 매개 변수를 기반으로 필터 값을 설정하려면 필터 속성 오른쪽 패널에서 필터를 정의할 때 선택합니다.
참고: 다중 선택 매개 변수의 경우 필터 탭에서 목록에 있음(Is In List) 또는 목록에 없음(Is Not In List)의 필터 연산자를 선택합니다.
- SQL 편집기의 필터와 함께 매개 변수를 사용하거나 계산에서 해당 값을 참조하려면 SQL 문에서 콜론(
:) 뒤에 이름을 입력합니다(예::ReportingPeriod).
쿼리에서 전역 매개 변수 사용
작업 공간 소유자는 여러 쿼리와 함께 사용된 공통 값에 대해 전역 매개 변수를 구성할 수 있습니다. 쿼리에서 전역 매개 변수를 사용하려면:
- 매개 변수 패널에서 추가를 클릭하고 전역 매개 변수 선택을 선택합니다.
- 쿼리에 사용할 전역 매개 변수를 선택하고 추가를 클릭합니다.
- 전역 매개 변수를 편집하려면 해당 매개 변수를 선택하고 쿼리에 필요한 이름 또는 값을 업데이트합니다.
참고: 일관된 분석을 보장하기 위해 작업 공간 소유자는 값이 편집되지 않도록 전역 매개 변수를 잠글 수 있습니다.
-
전역 매개 변수 값을 쿼리에 적용하려면 필터 또는 계산에서 사용합니다.
- 빌더의 매개 변수를 기반으로 필터 값을 설정하려면 필터 속성 오른쪽 패널에서 필터를 정의할 때 선택합니다.
참고: 다중 선택 매개 변수의 경우 필터 탭에서 목록에 있음(Is In List) 또는 목록에 없음(Is Not In List)의 필터 연산자를 선택합니다.
- SQL 편집기에서 매개 변수를 참조하려면, SQL 문에서 콜론(
:) 뒤에 이름을 입력합니다 (예::ReportingPeriod). - 계산의 SQL 문에 매개 변수의 값을 참조하려면 매개 변수 메뉴에서 매개 변수를 선택합니다.
- 빌더의 매개 변수를 기반으로 필터 값을 설정하려면 필터 속성 오른쪽 패널에서 필터를 정의할 때 선택합니다.
쿼리 매개 변수 편집
매개 변수의 세부 사항을 조정 또는 관리하려면:
- 매개 변수 패널에서 편집할 매개 변수를 선택합니다.
- 필요에 따라 매개 변수의 이름, 데이터 유형 또는 값을 편집합니다.
- 적용을 클릭합니다.
쿼리 매개 변수 제거
매개 변수가 더 이상 필요하지 않은 경우 쿼리에서 제거할 수 있습니다. 매개 변수 패널에서 매개 변수의 삭제 를 클릭하고 저장 을 클릭합니다.