사용자 지정 함수는 M 수식 언어를 사용하고 입력값 집합을 가져온 다음 단일 출력 값을 반환합니다. 여러 번 다시 사용하거나 동일한 변환 집합을 다른 쿼리 또는 값에 적용하려는 논리가 있는 경우 사용자 지정 함수를 만든 다음 필요할 때 언제 어디서나 함수를 호출하는 것이 좋습니다. 사용자 지정 함수를 만드는 방법에는 여러 가지가 있습니다.
- 고급 편집기를 사용하여 고유한 let 문을 추가하고 처음부터 시작합니다.
- 사용자 지정 함수 호출 명령을 사용합니다.
- 함수 만들기 및 쿼리로 추가 명령을 포함하여 이 도움말 항목에서 설명하지 않은 함수를 만드는 추가 방법이 있습니다. 자세한 내용은 파워 쿼리 M 함수 이해 및 사용자 지정 함수 사용을 참조하세요.
고급 편집기를 사용하여 간단한 사용자 지정 함수 만들기 및 호출
다음 예제에서는 오랜 프로그래밍 전통을 따르는 간단한 사용자 지정 함수를 보여 줍니다.
빈 쿼리를 만듭니다.
엑셀데이터> 선택다른 원본>에서데이터> 가져오기빈 쿼리.
파워 쿼리 왼쪽의 쿼리 창에서 빈 곳을 마우스 오른쪽 단추로 클릭한 다음 새로 만들기 쿼리,>기타 원본>, 빈 쿼리를 선택합니다.
왼쪽의 쿼리 창에서 이름을 두 번 클릭한 다음 새 빈 쿼리의 이름을 로 바꿉니다.
HelloWorld새 쿼리를 선택한 다음 홈>고급 편집기를 선택합니다.
템플릿 시작 코드를 다음 코드로 바꿉니다.
let
HelloWorld = () => ("Hello World")
in
HelloWorld완료를 선택합니다.
쿼리 를
HelloWorld사용자 지정 함수로 변경했습니다. 왼쪽에 있는 기능 아이콘 기능
확인합니다.함수를 호출하려면 함수를 선택한 다음 데이터 미리 보기에서 호출 을 선택합니다.
함수의 결과가 데이터 미리 보기에 표시되고 쿼리 창에 기본 이름이 호출된 함수인 쿼리로 추가됩니다. 이름을 보다 의미 있는 이름(예
HelloWorldResult: )으로 바꿀 수 있습니다.해당 쿼리를 선택한 다음 홈>닫기 & 로드 를 선택하여 워크시트에서 결과를 확인합니다.
결과
고급 편집기를 사용하여 매개 변수가 있는 사용자 지정 함수 만들기 및 호출
다음 예제에서는 사용자 지정 함수에 매개 변수를 전달하여 10진수를 16진수로 변환하는 방법을 보여줍니다.
빈 쿼리를 만듭니다.
엑셀데이터> 선택다른 원본>에서데이터> 가져오기빈 쿼리.
파워 쿼리 왼쪽의 쿼리 창에서 빈 곳을 마우스 오른쪽 단추로 클릭한 다음 새로 만들기 쿼리,>기타 원본>, 빈 쿼리를 선택합니다.
왼쪽의 쿼리 창에서 새 빈 쿼리의 이름을 로 바꿉니다.
MyHex새 쿼리를 선택한 다음 홈>고급 편집기를 선택합니다.
템플릿 시작 코드를 다음 코드로 바꿉니다.
let
MyHex = (parameter1) => Number.ToText(parameter1,"X")
in
MyHex완료를 선택합니다.
쿼리 를
MyHex사용자 지정 함수로 변경했습니다. 왼쪽에 있는 기능 아이콘 기능 확인합니다.함수를 호출하려면 함수를 선택합니다. 데이터 미리 보기에서 매개 변수1 상자에 숫자를 입력하고 호출을 선택합니다.
함수의 결과가 데이터 미리 보기에 나타납니다. 파워 쿼리는 결과를 쿼리 창에 기본 이름인 호출된 함수를 가진 쿼리로 추가합니다. 이름을 보다 의미 있는 이름(예
MyHexResult: )으로 바꿀 수 있습니다.해당 쿼리를 선택한 다음 홈>닫기 & 로드 를 선택하여 워크시트에서 결과를 확인합니다.
결과
사용자 지정 함수를 호출하여 열 추가
하나 이상의 매개 변수를 사용하여 함수를 만드는 경우 사용자 지정 함수로 호출하여 테이블의 각 행에 대해 새 열과 새 값을 만들 수 있습니다.
쿼리를 열려면 Power Query 편집기에서 이전에 로드한 쿼리를 찾아 데이터에서 셀을 선택한 다음 쿼리>편집을 선택합니다. 자세한 내용은 Excel에서 쿼리 만들기, 편집 및 로드(파워 쿼리)를 참조하세요.
참고
이 예제의 경우 쿼리에 정수 데이터 형식의 열이 하나 이상 필요합니다.
고급 편집기를 사용하여 매개 변수가 있는 사용자 지정 함수 만들기 및 호출 섹션에 설명된 대로 사용자 지정 함수를
MyHex만듭니다.쿼리에서 열> 추가 사용자지정 함수 호출을 선택합니다. 사용자 지정 함수 호출 대화 상자가 나타납니다.
새 열 이름 상자에 새 열 이름(예:
HexConvert)을 입력합니다.함수 쿼리 드롭다운에서 미리 정의된 사용자 지정 함수의 이름을 선택합니다. 이 예에서는 를 선택합니다
MyHex.사용자 지정 함수가 매개 변수를 참조하므로 이제 매개 변수가 표시됩니다.
함수에 대한 매개 변수로 정 수 데이터 형식의 열을 선택합니다.
확인을 선택합니다.
결과
매개 변수로 입력한 정수 열의 16진수 값을 보여주는 새 열이 만들어집니다.
