Power BI에서 데이터 함수 만들기 단추(미리 보기)

2025-05-19

적용 대상: Power BI Desktop Power BI 서비스

Power BI Desktop 및 Power BI 서비스에서 데이터 함수 단추를 만들 수 있습니다. 이 단추는 사용자의 입력을 받아 함수를 호출하여 작업을 수행합니다.

비고

변환 및 분석 통합 작업 흐름 기능은 현재 공개 미리 보기 상태로 제공됩니다.

필수 조건

Power BI 및 Fabric에서 필요한 미리 보기 기능을 사용하도록 설정합니다.
Fabric에서 사용자 데이터 함수를 만듭니다. 예제는 Translytical 작업 흐름 예제를 참조하세요.

중요합니다

데이터 함수 단추를 사용하려면 참조 함수가 문자열을 반환해야 합니다.

사용자 데이터 함수에 대한 모범 사례

Translytical 작업 흐름 시나리오에 대한 고유한 함수를 작성하는 경우 다음 모범 사례를 따라 품질이 좋은 최종 사용자 환경을 보장합니다.

각 매개 변수에 대한 입력 유효성 검사 논리를 작성합니다. 이 메서드를 fn.UserThrownError() 사용하여 Power BI 보고서에 예상되는 오류 응답을 보냅니다. 다음은 그 예입니다.
```
if (discount < 0):
    raise fn.UserThrownError("Discount cannot be negative.")
```
모든 실행 데이터베이스 호출에 try/catch 문을 사용합니다. 데이터베이스가 오프라인이거나 연결할 수 없는 경우를 처리하는 친숙한 메시지를 반환합니다.
SQL 문이 SQL 삽입 공격에 취약하지 않은지 확인합니다.
최종 사용자에게 작업이 성공했음을 알리는 친숙한 성공 메시지를 작성합니다.

함수 매개 변수에 대한 입력 구성

사용자 데이터 함수가 입력으로 사용하는 각 매개 변수는 Power BI 보고서의 요소에 매핑해야 합니다. 이 요소는 단추, 목록 또는 텍스트 슬라이서일 수 있습니다. 데이터 필드; 또는 측정값입니다.

입력 컨트롤로 사용하는 슬라이서

지원되는 세 가지 슬라이서 유형(단추, 목록 및 텍스트)은 모두 새 슬라이서라고도 하는 미리 보기 기능입니다. 필수 구성 요소에 설명된 대로 사용하도록 설정해야 합니다.

단추 또는 목록 슬라이서를 매개 변수로 사용하려면 데이터 창의 데이터 필드에 연결해야 합니다. 버튼 슬라이서 또는 목록 슬라이서를 입력 제어로만 사용하고 데이터를 필터링하지 않으려면 편집 상호 작용을 통해 모든 시각적 상호 작용을 제거합니다. 상호 작용 편집에 대한 자세한 내용은 Power BI 보고서에서 시각적 개체가 상호 작용하는 방식 변경을 참조하세요.

텍스트 슬라이서를 매개 변수로 사용하려면 데이터 필드에 연결하는 것은 선택 사항입니다. 보고서에서 데이터를 필터링하려는 경우에만 데이터 필드에 연결합니다. 그렇지 않으면 데이터 창에서 데이터 필드를 사용하지 않고 만듭니다.

입력 컨트롤로서의 데이터 필드 또는 측정값

데이터 필드 및 측정값을 매개 변수로 연결할 수도 있습니다. 입력 매개 변수 형식과 일치하는 필드만 선택할 수 있습니다.

편집/삭제 작업을 위해 CustomerID와 같은 데이터 함수에 단일 기본 키를 전달해야 하는 경우 식을 사용할 SELECTEDVALUE DAX 수 있습니다.

다음은 그 예입니다.

SelectedCustomerID = SELECTEDVALUE(Customer[CustomerID])

자세한 내용은 데이터 분석을 위한 측정값 만들기를 참조하세요.

데이터 기능 버튼 설정

데이터 함수 단추를 만들고 보고서 요소 또는 사용자 입력을 사용자 데이터 함수에 연결하도록 구성합니다.

Power BI Desktop에서 보고서에 단추를 추가합니다.
서식 단추 창에서 작업 메뉴를 확장합니다. 작업 스위치를 켜기로 설정하지 않았다면 설정합니다.
형식 드롭다운 메뉴에서 데이터 함수를 선택합니다.

데이터 함수 옵션을 선택하면 작업 영역, 함수 집합 및 데이터 함수 매개 변수가 나타납니다.

팁 (조언)

데이터 함수 옵션이 표시되지 않으면 Power BI 데스크톱에서 Translytical 작업 흐름 미리 보기 기능을 사용하도록 설정해야 합니다.

단추에 대해 다음 값을 제공합니다.

매개 변수	가치
작업 공간	사용자 데이터 함수가 포함된 작업 영역을 선택합니다.
함수 집합	데이터 함수가 포함된 함수 집합을 선택합니다.
데이터 함수	데이터 함수를 선택합니다.

팁 (조언)

사용하려는 사용자 데이터 함수가 표시되지 않으면 데이터 함수가 문자열을 반환하는지 확인합니다.

데이터 함수를 선택하면 함수가 사용하는 매개 변수를 나타내는 다른 매개 변수가 나타납니다. 각 매개 변수에 대해 다음 중 하나를 수행할 수 있습니다.
- 드롭다운 메뉴를 사용하여 보고서에서 슬라이서를 선택하세요.
- 조건부 서식(fx) 단추를 선택하여 보고서에서 데이터 필드 또는 측정값을 선택합니다.

보고서 인터페이스 사용자 지정

보고서에서 슬라이서, 데이터 필드 및 단추의 조합을 사용하여 사용자 지정된 대화형 시각적 개체를 만들 수 있습니다. 다음 섹션에서는 예제 및 권장 사항을 제공합니다.

슬라이서와 인터페이스하기

보고서 페이지에서 다른 시각적 개체와 상호 작용하지 않는 슬라이서로 구성된 섹션을 생성하여, 이 슬라이서는 오직 입력 컨트롤로만 작동하도록 할 수 있습니다. 아래쪽에 단추를 놓고 해당 동작을 Data 함수로 설정하여 슬라이서와 매개 변수에 연결합니다. 원하는 방식으로 이 섹션을 디자인할 수 있지만 핵심은 보고서 콘텐츠에서 눈에 띄는 실행 가능한 섹션처럼 보이게 하는 것입니다.

다음 예제에서는 세 가지 요소가 있는 대화형 섹션을 보여줍니다.

새 주문 ID를 입력하는 텍스트 슬라이서
세 가지 옵션 중 하나에서 주문 상태를 선택하는 단추 슬라이서
슬라이서에서 사용자 데이터 함수로 입력을 제출하는 단추

각각에 입력 값을 추가하여 단추가 슬라이서와 제대로 연결되어 있는지 테스트할 수 있습니다. 매개 변수가 허용되는 경우 단추의 스타일이 변경됩니다. 단추 스타일을 사용자 지정하여 상태를 더욱 매력적으로 만듭니다. Power BI Desktop에서는 보고서가 게시될 때까지 작업을 트리거할 수 없습니다.

데이터 필드 및 측정값과 연동

보고서 페이지에서 데이터 함수 작업과 함께 보고서 시각적 개체와 단추를 사용하여 매개 변수를 데이터 필드에 연결할 수 있습니다.

다음 예제에서는 두 요소가 있는 대화형 섹션을 보여 있습니다.

행을 주문 ID 입력으로 선택할 수 있는 테이블
테이블 행을 사용자 데이터 함수에 대한 입력으로 제출하는 단추

행을 클릭하여 단추가 테이블과 제대로 연결되어 있는지 테스트할 수 있습니다. 매개 변수가 수락되면 단추의 스타일이 변경됩니다. 단추 스타일을 사용자 지정하여 상태를 더욱 매력적으로 만듭니다. Power BI Desktop에서는 보고서가 게시될 때까지 작업을 트리거할 수 없습니다.

혼합 입력을 사용하는 인터페이스

슬라이서와 데이터 필드/측정값을 혼합하여 가장 창의적인 환경을 만들 수 있습니다. 데이터 함수에 정의된 각 매개 변수를 올바른 옵션으로 연결합니다. 이 옵션은 페이지에 있는 슬라이서 또는 표시되는 데이터 필드 또는 측정값일 수 있습니다.