매개변수를 사용하여 사용자가 제공 데이터와 상호작용할 수 있습니다. 예를 들어 보고서 사용자의 입력을 포함하는 계산된 필드를 만들거나 데이터 소스에서 사용되는 SQL 쿼리로 값을 반환할 수 있습니다. 매개변수를 사용하면 상호작용 기능이 더 강화된 보고서를 만들 수 있습니다. 매개변수를 사용하여 보고서 템플릿을 만들 수도 있습니다.
이 도움말에서는 다음 내용을 다룹니다.매개변수 작동 원리
매개변수는 프로그래밍 언어의 변수처럼 작동합니다. 매개변수의 주요 용도는 다음 3가지입니다.
- 계산된 필드의 매개변수를 사용하여 사용자 입력에 기반한 결과를 표시할 수 있습니다.
- 매개변수를 BigQuery 데이터 소스의 맞춤 SQL 쿼리로 반환할 수 있습니다.
- 매개변수를 커뮤니티 커넥터로 반환할 수 있습니다.
매개변수는 다음 위치에서 데이터를 가져올 수 있습니다.
- 매개변수에 대해 정의된 기본값에서
- 구성요소 속성 패널에서
- 보고서에 배치된 컨트롤에서
- 보고서 링크에서
매개변수는 보고서 및 데이터 소스 편집기의 필드 목록 하단에서 찾을 수 있습니다. 매개변수는 보라색 필드로 표시됩니다.
보고서에서 매개변수가 데이터를 공유하는 방식
보고서 및 데이터 소스의 수정 권한 사용자는 매개변수로 관리되는 모든 데이터에 액세스할 수 있습니다.
매개변수를 사용하면 보고서 수정 권한 사용자가 기본값과 다른 데이터를 요청할 수 있습니다. 데이터 소스에 대한 매개변수를 사용 설정하기 전에 매개변수 값 변경이 보고서의 데이터에 어떤 영향을 미치는지 이해해야 합니다. 일부 매개변수는 새로운 언어로 된 날씨와 같이 상대적으로 '안전한' 데이터만 반환할 수도 있습니다. 그러나 사용자가 완전히 새로운 데이터 세트를 요청하도록 허용하는 매개변수도 있습니다. 예를 들어 계정 번호 매개변수 또는 데이터베이스 표의 이름을 사용하면 공유하고 싶지 않은 데이터를 반환하거나 보고서의 기존 차트와 호환되지 않는 다른 스키마를 반환할 수 있습니다.
매개변수 만들기
다음 위치에서 매개변수를 만들 수 있습니다.
데이터 소스
- 데이터 소스를 수정합니다.
- 오른쪽 상단에서 매개변수 추가를 클릭합니다.
보고서를 수정하는 동안 구성요소를 선택한 다음 오른쪽 하단의 매개변수 추가를 클릭하여 매개변수를 만들 수도 있습니다. 원하는 데이터 소스를 기반으로 구성요소를 선택해야 합니다. - 매개변수의 옵션 및 기본값을 구성합니다(아래 참고).
BigQuery 커넥터
BigQuery 커넥터에서 맞춤 SQL 쿼리에 매개변수를 전달할 수 있습니다. BigQuery 커넥터는 보고서의 시작일 및 종료일과 사용자의 이메일 주소(사용 가능한 경우)를 전달하는 여러 표준 매개변수를 정의합니다. 맞춤 매개변수를 전달할 수도 있습니다. 자세히 알아보기
매개변수 및 커뮤니티 커넥터
커뮤니티 커넥터는 재정의 가능한 매개변수를 포함할 수 있고, 이를 통해 보고서 수정 권한 사용자가 데이터 소스의 기본값을 수정할 수 있습니다. 커뮤니티 커넥터로 구축된 데이터 소스의 연결을 수정할 수 있는 경우 보고서 수정 권한 사용자가 변경할 수 있는 매개변수를 지정할 수 있습니다.
- 데이터 소스를 수정합니다.
- 왼쪽 상단에서 연결 수정을 클릭합니다.
- 커넥터가 수정 가능한 매개변수를 제공하는 경우 페이지 하단에 표시됩니다. 맞춤 매개변수를 정의할 수 있는 커넥터의 경우는 페이지에 안내가 포함됩니다.
- 보고서에서 <매개변수 이름>을 수정하도록 허용 체크박스를 사용하여 보고서에서 매개변수 수정을 허용하거나 허용하지 않습니다.
- 오른쪽 상단에서 재연결을 클릭합니다.
커뮤니티 커넥터에서 데이터 소스를 만들면 해당 커넥터의 매개변수 변경사항이 데이터 소스에 자동으로 표시되지 않습니다. 새 매개변수, 삭제된 매개변수 또는 변경된 매개변수를 보려면 데이터 소스를 다시 연결해야 합니다.
기존 매개변수 수정
기존 매개변수의 구성을 변경하려면 다음 단계를 따르세요.
- 매개변수가 포함된 데이터 소스를 수정합니다.
- 필드 목록에서 매개변수를 찾습니다.
- 매개변수 이름 오른쪽에 있는 @ 기호를 클릭합니다.
- 변경한 다음, 오른쪽 하단에서 저장을 클릭합니다.
매개변수 구성
다음 옵션을 사용하여 데이터 소스에서 매개변수를 구성합니다. BigQuery 커넥터 및 커뮤니티 커넥터 매개변수에 대해서는 위에 참조된 자료를 참고하세요.
매개변수 이름: 보고서 및 데이터 소스의 필드 목록에 이 이름이 표시됩니다. 또한 계산된 필드에서 이 매개변수를 참조하는 데 사용할 이름입니다.
매개변수 ID: 기본값으로 설정됩니다. 매개변수 ID는 Looker Studio에서 내부적으로 매개변수를 식별하는 데 사용됩니다. 보고서 보기 권한 사용자는 볼 수 없습니다.
데이터 유형: 매개변수는 텍스트, 숫자 또는 불리언(참/거짓) 값을 저장할 수 있습니다.
허용되는 값: 사용자가 입력할 수 있는 값을 지정합니다.
값 목록을 지정하려면 해당 옵션을 선택한 후 선택사항인 표시 이름과 함께 허용 가능한 값을 입력합니다. 옵션 추가를 클릭하여 목록에 항목을 추가합니다.
허용되는 값의 범위를 지정하려면 범위의 최솟값 및 최댓값을 입력합니다.
기본값: 매개변수의 시작 값을 지정합니다.
매개변수 값 설정
다음의 방법으로 매개변수 값을 설정할 수 있습니다.
매개변수의 기본값 설정하기
매개변수를 만들 때 기본값을 설정할 수 있습니다. 기본값을 조정하려면 위의 단계에 따라 매개변수를 수정합니다.
컨트롤을 사용하여 사용자 입력 가져오기
사용자는 컨트롤을 사용하여 보고서와 상호작용할 수 있습니다. 매개변수에 사용자 입력을 저장하려면 해당 매개변수를 컨트롤의 컨트롤 필드 속성에 추가합니다.
- 보고서를 수정합니다.
- 상단에서
컨트롤 추가를 클릭합니다.
- 추가할 컨트롤 유형을 선택합니다.
속성 패널에서 설정 탭을 선택합니다.
- 컨트롤 필드에 매개변수를 추가합니다.
컨트롤 추가를 클릭합니다.컨트롤에 대해 자세히 알아보세요.
구성요소의 기본 매개변수 값 재정의하기
보고서에서 개별 구성요소를 수정하여 매개변수의 기본값을 재정의할 수 있습니다.
- 보고서를 수정합니다.
- 매개변수가 포함된 데이터 소스를 기준으로 구성요소를 선택합니다.
- 구성요소의 데이터 탭 하단에서 기본 매개변수 값을 수정합니다.
보고서 및 페이지 수준에서 매개변수를 수정할 수도 있습니다.
- 보고서를 수정합니다.
- 파일 > 보고서 설정 또는 페이지 > 현재 페이지 설정을 선택합니다.
- 매개변수 값을 수정합니다.
매개변수 상속
매개변수는 필터 속성과 동일한 상속 규칙을 따릅니다. 특히 우선순위가 높은 구성요소의 매개변수가 우선 순위가 낮은 구성요소의 매개변수를 재정의합니다. 우선순위(오름차순)는 다음과 같습니다.
- 데이터 소스(기본값)
- 보고서
- 페이지
- 그룹
- 개별 차트 또는 컨트롤
보고서 링크를 통해 매개변수 수정하기
보고서 URL을 통해 매개변수를 설정하면 개발자와 고급 사용자가 프로그래매틱 방식으로 구성할 수 있는 보고서를 생성할 수 있습니다.
Looker Studio 보고서 매개변수와 해당 값은 'params' 쿼리 매개변수를 사용하여 보고서 URL에 추가되는 URL 인코딩 JSON 문자열로 전달됩니다.
개발자 가이드에서 자세히 알아보세요.
보고서 URL 매개변수 관리
보고서의 매개변수는 기본적으로 보고서 URL을 통해 수정할 수 없습니다.
보고서 사용자가 변경할 수 있는 매개변수를 선택하려면 다음의 단계를 따르세요.
- 보고서를 수정합니다.
- 리소스 > 보고서 URL 매개변수 관리를 선택합니다.
- 보고서 URL을 통해 설정 허용 열에서 허용할 매개변수를 확인합니다.
이 페이지에는 각 매개변수의 URL 매개변수도 표시됩니다. 인코딩된 매개변수 객체를 구성할 때 매개변수 이름이 아닌 이 이름이 사용됩니다. 수정 연필을 클릭하여 이 이름을 수정할 수 있습니다. 보고서의 모든 URL 매개변수는 고유해야 합니다.
URL 매개변수 이름을 수정해도 보고서에서 매개변수가 사용되는 방식에는 영향을 주지 않습니다.
매개변수 사용
생성된 매개변수는 측정기준 및 측정항목과 마찬가지로 계산된 필드 및 보고서 구성요소에서 사용할 수 있습니다.
계산된 필드에서 매개변수 사용
계산된 필드에서 측정기준 또는 측정항목을 사용할 때와 마찬가지로 매개변수를 사용할 수 있습니다.
매개변수가 있는 계산된 필드 예시
예를 들어 사용자가 지난 분기의 판매 배율을 입력할 수 있도록 함으로써 예측 판매액을 시각화한다고 가정해 보겠습니다.
먼저 예측 배율을 보존할 매개변수를 만듭니다.
- Looker Studio에 로그인합니다.
- 데이터 소스를 수정합니다.
- 오른쪽 상단에서 매개변수 추가를 클릭합니다.
- 매개변수의 이름을 지정합니다(예: '예측 배율').
- 데이터 유형을 숫자로 설정합니다.
- 편의상 허용된 값 옵션을 모든 값으로 둡니다.
다른 옵션을 사용하여 사용자가 값 목록에서 선택하거나 항목의 범위를 특정 값으로 제한할 수 있습니다. - 기본값을 1로 설정합니다.
- 저장을 클릭합니다.
- 데이터 소스 필드 목록으로 돌아가려면 왼쪽에 있는 모든 필드를 클릭합니다.
그런 다음 계산된 필드를 만듭니다.
- 오른쪽 상단에서 필드 추가를 클릭합니다.
- 필드 이름을 지정합니다(예: '매개변수가 있는 예상 판매액').
- 수식에서 데이터 소스의 '판매액' 필드와 예상 배율 매개변수를 곱합니다. 예를 들어 데이터 소스에 수익이라는 필드가 있는 경우
수익 * 예상 배율을 입력합니다. - 저장을 클릭합니다.
그런 다음 컨트롤을 추가하여 사용자의 입력을 수집합니다.
- 보고서를 수정하거나 작성합니다.
- 필요한 경우 보고서에 데이터 소스를 추가합니다.
- 상단에서
- 입력 상자 컨트롤을 선택합니다.
입력 상자 컨트롤을 사용하면 매개변수 값을 직접 입력할 수 있습니다. 다른 유형의 컨트롤을 사용하면 목록에서 선택하거나, 슬라이더를 사용하거나, 불리언 값을 체크박스로 전환할 수 있습니다. - 오른쪽의 데이터 속성에서 이전에 만든 예상 배율 매개변수를 추가합니다.
마지막으로 차트에서 매개변수화된 계산된 필드를 시각화합니다.
- 상단에서
차트 추가를 클릭합니다.
- 편의상 스코어카드를 선택합니다.
- 오른쪽의 데이터 속성에서 매개변수가 있는 판매액 예측 계산된 필드를 측정항목으로 추가합니다.
차트 추가를 클릭합니다.이제 사용해 보세요.
- 오른쪽 상단에서 보기를 클릭합니다.
- 예측 배율 컨트롤에 숫자를 입력한 다음 Enter를 누릅니다.
- 스코어카드의 값이 기존 값에 입력한 값을 곱한 값으로 변경되어 표시됩니다.
시각화에 매개변수 사용하기
측정기준 또는 측정항목과 마찬가지로 차트에 매개변수를 추가할 수 있습니다. 숫자 매개변수를 측정항목으로 사용하는 경우 값이 집계됩니다.
보고서에서 매개변수 표시 및 숨기기
데이터 소스에서 만든 매개변수를 표시하거나 숨길 수 있습니다.
- 데이터 소스를 수정합니다.
- 매개변수를 찾습니다.
- 매개변수 오른쪽에서
옵션을 클릭합니다.
- 표시(매개변수가 현재 숨겨진 경우) 또는 숨기기(매개변수가 현재 표시된 경우)를 클릭합니다.
옵션을 클릭합니다.매개변수가 있는 구성요소 복사
구성요소를 복사하면 속성 패널에서 설정된 매개변수 값이 복사됩니다. 구성요소를 수정하여 사본의 매개변수를 재정의할 수 있습니다.
잘못된 매개변수 수정
커넥터에서 매개변수 구성이 변경되면 해당 매개변수를 사용하는 차트가 손상될 수 있습니다. 예를 들어 커넥터의 개발자가 매개변수 값을 재정의하는 기능을 삭제할 수 있으며 보고서에서 제공한 값이 더 이상 유효한 데이터를 반환하지 않습니다. 이 경우 해당 변경의 영향을 받는 차트에 오류 메시지가 표시됩니다.
이 문제를 해결하려면 현재 잘못된 매개변수가 포함된 구성 요소를 찾습니다. 그런 다음 해당 구성요소 데이터 속성의 매개변수 섹션에서 잘못된 값 수정을 클릭합니다.
매개변수는 보고서, 페이지 및 그룹 수준뿐만 아니라 개별 차트에서도 설정할 수 있으므로 오류를 찾아 수정하려면 여러 곳을 살펴볼 필요가 있습니다.