R 스크립트 실행 구성 요소

아티클
09/01/2024

이 문서에서는 R 스크립트 실행 구성 요소를 사용하여 Azure Machine Learning 디자이너 파이프라인에서 R 코드를 실행하는 방법을 설명합니다.

R을 사용하면 다음과 같이 기존 구성 요소에서 지원되지 않는 작업을 수행할 수 있습니다.

사용자 지정 데이터 변환 만들기
고유한 메트릭을 사용하여 예측 평가
디자이너에서 독립 실행형 구성 요소로 구현되지 않는 알고리즘을 사용하여 모델 빌드

R 버전 지원

Azure Machine Learning 디자이너는 R의 CRAN(광범위한 R 보관 네트워크) 배포를 사용합니다. 현재 사용되는 버전은 CRAN 3.5.1입니다.

지원되는 R 패키지

R 환경은 100개 이상의 패키지와 함께 미리 설치됩니다. 전체 목록은 사전 설치된 R 패키지 섹션 을 참조하세요.

R 스크립트 실행 구성 요소에 다음 코드를 추가하여 설치된 패키지를 볼 수도 있습니다.

azureml_main <- function(dataframe1, dataframe2){
  print("R script run.")
  dataframe1 <- data.frame(installed.packages())
  return(list(dataset1=dataframe1, dataset2=dataframe2))
}

참고 항목

파이프라인에 사전 설치된 목록에 없는 패키지를 필요로 하는 R 스크립트 실행 구성 요소가 여러 개 있는 경우 각 구성 요소에 해당 패키지를 설치합니다.

R 패키지 설치

추가 R 패키지를 설치하려면 이 메서드를 install.packages() 사용합니다. 패키지는 각 R 스크립트 실행 구성 요소에 대해 설치됩니다. 다른 R 스크립트 실행 구성 요소에서 공유되지 않습니다.

참고 항목

스크립트 번들에서 R 패키지를 설치하는 것은 권장하지 않습니다. 스크립트 편집기에서 직접 패키지를 설치하는 것이 좋습니다. 패키지를 설치할 때 CRAN 리포지토리를 지정합니다(예: install.packages("zoo",repos = "https://cloud.r-project.org").).

Warning

R 스크립트 실행 구성 요소는 JAVA를 필요로 하는 qdap 패키지와 C++를 필요로 하는 drc 패키지와 같이 네이티브 컴파일이 필요한 패키지 설치를 지원하지 않습니다. 이 구성 요소는 비관리자 권한으로 사전 설치된 환경에서 실행되기 때문입니다. 디자이너 구성 요소가 Ubuntu에서 실행되고 있으므로 Windows에 사전 빌드된 패키지를 설치하지 마세요. 패키지가 Windows에서 미리 빌드되었는지 확인하려면 CRAN으로 이동하여 패키지를 검색하고, OS에 따라 하나의 이진 파일을 다운로드하고, DESCRIPTION 파일의 기본 제공 부분을 확인할 수 있습니다. 다음은 예제입니다.

이 샘플에서는 Zoo를 설치하는 방법을 보여 줍니다.

# R version: 3.5.1
# The script MUST contain a function named azureml_main,
# which is the entry point for this component.

# Note that functions dependent on the X11 library,
# such as "View," are not supported because the X11 library
# is not preinstalled.

# The entry point function MUST have two input arguments.
# If the input port is not connected, the corresponding
# dataframe argument will be null.
#   Param<dataframe1>: a R DataFrame
#   Param<dataframe2>: a R DataFrame
azureml_main <- function(dataframe1, dataframe2){
  print("R script run.")
  
  if(!require(zoo)) install.packages("zoo",repos = "https://cloud.r-project.org")
  library(zoo)
  # Return datasets as a Named List
  return(list(dataset1=dataframe1, dataset2=dataframe2))
}

참고 항목

패키지를 설치하기 전에 설치를 반복하지 않도록 이미 있는지 확인합니다. 설치를 반복하면 웹 서비스 요청 시간이 초과될 수 있습니다.

등록된 데이터 세트에 대한 액세스

다음 샘플 코드를 참조하여 작업 영역에 등록된 데이터 세트에 액세스할 수 있습니다.

azureml_main <- function(dataframe1, dataframe2){
  print("R script run.")
  run = get_current_run()
  ws = run$experiment$workspace
  dataset = azureml$core$dataset$Dataset$get_by_name(ws, "YOUR DATASET NAME")
  dataframe2 <- dataset$to_pandas_dataframe()
  # Return datasets as a Named List
  return(list(dataset1=dataframe1, dataset2=dataframe2))
}

R 스크립트 실행을 구성하는 방법

R 스크립트 실행 구성 요소에는 시작하는 데 도움이 되는 샘플 코드가 포함되어 있습니다.

R 구성 요소에 대한 입력 다이어그램

이 구성 요소를 사용하여 로드하면 디자이너에 저장된 데이터 세트가 자동으로 R 데이터 프레임으로 변환됩니다.

파이프라인에 R 스크립트 실행 구성 요소를 추가합니다.
스크립트에 필요한 모든 입력을 연결합니다. 입력은 선택 사항이며 데이터 및 추가 R 코드를 포함할 수 있습니다.
- Dataset1: 첫 번째 입력을 .로 dataframe1참조합니다. 입력 데이터 세트는 CSV, TSV 또는 ARFF 파일 형식으로 지정해야 합니다. 또는 Azure Machine Learning 데이터 세트를 연결할 수 있습니다.
- 데이터 세트2: 두 번째 입력을 dataframe2로 참조합니다. 또한 이 데이터 세트는 CSV, TSV 또는 ARFF 파일 또는 Azure Machine Learning 데이터 세트로 포맷되어야 합니다.
- 스크립트 번들: 세 번째 입력은 .zip 파일을 허용합니다. 압축된 파일은 여러 파일 및 여러 파일 형식을 포함할 수 있습니다.
R 스크립트 텍스트 상자에 유효한 R 스크립트를 입력하거나 붙여넣습니다.

참고 항목

스크립트를 작성할 때 주의해야 합니다. 선언되지 않은 변수 또는 가져오지 않은 구성 요소나 함수를 사용하는 것과 같은 구문 오류가 없는지 확인합니다. 이 문서의 끝에 미리 설치된 패키지 목록에 주의하세요. 나열되지 않은 패키지를 사용하려면 스크립트에 설치합니다. 예제는 install.packages("zoo",repos = "https://cloud.r-project.org")입니다.

R 스크립트 텍스트 상자에는 편집하거나 바꿀 수 있는 샘플 코드가 미리 채워집니다.
```
# R version: 3.5.1
# The script MUST contain a function named azureml_main,
# which is the entry point for this component.

# Note that functions dependent on the X11 library,
# such as "View," are not supported because the X11 library
# is not preinstalled.

# The entry point function MUST have two input arguments.
# If the input port is not connected, the corresponding
# dataframe argument will be null.
#   Param<dataframe1>: a R DataFrame
#   Param<dataframe2>: a R DataFrame
azureml_main <- function(dataframe1, dataframe2){
print("R script run.")

# If a .zip file is connected to the third input port, it's
# unzipped under "./Script Bundle". This directory is added
# to sys.path.

# Return datasets as a Named List
return(list(dataset1=dataframe1, dataset2=dataframe2))
}
```
진입점 함수는 입력 인수 Param<dataframe1> 및 Param<dataframe2>를 포함해야 하며 함수에 이러한 인수가 사용되지 않은 경우에도 마찬가지입니다.

참고 항목

R 스크립트 실행 구성 요소에 전달되는 데이터는 dataframe1 및 dataframe2로 참조되며 Azure Machine Learning 디자이너(dataset1, dataset2로 디자이너 참조)와는 다릅니다. 입력 데이터가 스크립트에서 올바르게 참조되는지 확인합니다.

참고 항목

디자이너 파이프라인에서 실행하려면 기존 R 코드를 약간 변경해야 할 수 있습니다. 예를 들어 CSV 형식으로 제공하는 입력 데이터는 코드에서 사용하기 전에 명시적으로 데이터 세트로 변환되어야 합니다. R 언어로 사용되는 데이터 및 열 형식도 디자이너에서 사용되는 데이터 및 열 형식과는 몇 가지 면에서 다릅니다.
스크립트가 16KB보다 큰 경우 스크립트 번들 포트를 사용하여 CommandLine이 16597자 제한을 초과하는 등의 오류를 방지합니다.
1. 스크립트 및 기타 사용자 지정 리소스를 zip 파일에 번들로 묶습니다.
2. zip 파일을 파일 데이터 세트로 스튜디오에 업로드합니다.
3. 디자이너 작성 페이지의 왼쪽 구성 요소 창에 있는 데이터 세트 목록에서 데이터 세트 구성 요소를 끌어옵니다.
4. 데이터 세트 구성 요소를 R 스크립트 실행 구성 요소의 스크립트 번들 포트에 연결합니다.
다음은 스크립트 번들에서 스크립트를 사용하는 샘플 코드입니다.
```
azureml_main <- function(dataframe1, dataframe2){
# Source the custom R script: my_script.R
source("./Script Bundle/my_script.R")

# Use the function that defined in my_script.R
dataframe1 <- my_func(dataframe1)

sample <- readLines("./Script Bundle/my_sample.txt")
return (list(dataset1=dataframe1, dataset2=data.frame("Sample"=sample)))
}
```
임의 시드의 경우 R 환경 내에서 임의 시드 값으로 사용할 값을 입력합니다. 이 매개 변수는 R 코드에서 호출 set.seed(value) 하는 것과 같습니다.
파이프라인을 제출합니다.

결과

R 스크립트 실행 구성 요소는 여러 출력을 반환할 수 있지만 R 데이터 프레임으로 제공되어야 합니다. 디자이너는 다른 구성 요소와의 호환성을 위해 데이터 프레임을 자동으로 데이터 세트로 변환합니다.

R의 표준 메시지 및 오류는 구성 요소의 로그로 반환됩니다.

R 스크립트에서 결과를 출력해야 하는 경우 구성 요소의 오른쪽 패널에 있는 출력+로그 탭의 70_driver_log에서 출력 결과를 찾을 수 있습니다.

샘플 스크립트

사용자 지정 R 스크립트를 사용하여 파이프라인을 확장하는 방법에는 여러 가지가 있습니다. 이 섹션에서는 일반적인 작업에 대한 샘플 코드를 제공합니다.

R 스크립트를 입력으로 추가

R 스크립트 실행 구성 요소는 임의의 R 스크립트 파일을 입력으로 지원합니다. 이를 사용하려면 .zip 파일의 일부로 작업 영역에 업로드해야 합니다.

R 코드가 포함된 .zip 파일을 작업 영역에 업로드하려면 데이터 세트 자산 페이지로 이동합니다. 데이터 세트 만들기를 선택한 다음 로컬 파일에서를 선택하고 파일 데이터 세트 유형 옵션을 선택합니다.
압축된 파일이 왼쪽 구성 요소 트리의 데이터 세트 범주의 내 데이터 세트에 표시되는지 확인합니다.
데이터 세트를 스크립트 번들 입력 포트에 연결합니다.
.zip 파일의 모든 파일은 파이프라인 런타임 중에 사용할 수 있습니다.

스크립트 번들 파일에 디렉터리 구조가 포함되어 있으면 구조가 유지됩니다. 하지만 . /Script 번들을 경로 앞에 추가하려면 코드를 변경해야 합니다.

데이터 처리

다음 샘플에서는 입력 데이터의 크기를 조정하고 정규화하는 방법을 보여줍니다.

# R version: 3.5.1
# The script MUST contain a function named azureml_main,
# which is the entry point for this component.

# Note that functions dependent on the X11 library,
# such as "View," are not supported because the X11 library
# is not preinstalled.

# The entry point function MUST have two input arguments.
# If the input port is not connected, the corresponding
# dataframe argument will be null.
#   Param<dataframe1>: a R DataFrame
#   Param<dataframe2>: a R DataFrame
azureml_main <- function(dataframe1, dataframe2){
  print("R script run.")
  # If a .zip file is connected to the third input port, it's
  # unzipped under "./Script Bundle". This directory is added
  # to sys.path.
  series <- dataframe1$width
  # Find the maximum and minimum values of the width column in dataframe1
  max_v <- max(series)
  min_v <- min(series)
  # Calculate the scale and bias
  scale <- max_v - min_v
  bias <- min_v / dis
  # Apply min-max normalizing
  dataframe1$width <- dataframe1$width / scale - bias
  dataframe2$width <- dataframe2$width / scale - bias
  # Return datasets as a Named List
  return(list(dataset1=dataframe1, dataset2=dataframe2))
}

.zip 파일을 입력으로 읽습니다.

이 샘플에서는 .zip 파일의 데이터 세트를 R 스크립트 실행 구성 요소에 대한 입력으로 사용하는 방법을 보여 줍니다.

CSV 형식으로 데이터 파일을 만들고 이름을 mydatafile.csv.
.zip 파일을 만들고 보관 파일에 CSV 파일을 추가합니다.
압축된 파일을 Azure Machine Learning 작업 영역에 업로드합니다.
결과 데이터 세트를 R 스크립트 실행 구성 요소의 ScriptBundle 입력에 연결합니다.
다음 코드를 사용하여 압축된 파일에서 CSV 데이터를 읽습니다.

azureml_main <- function(dataframe1, dataframe2){
  print("R script run.")
  mydataset<-read.csv("./Script Bundle/mydatafile.csv",encoding="UTF-8");  
  # Return datasets as a Named List
  return(list(dataset1=mydataset, dataset2=dataframe2))
}

행 복제

이 샘플은 샘플의 균형을 맞추기 위해 데이터 세트에서 양수 레코드를 복제하는 방법을 보여 줍니다.

azureml_main <- function(dataframe1, dataframe2){
  data.set <- dataframe1[dataframe1[,1]==-1,]  
  # positions of the positive samples
  pos <- dataframe1[dataframe1[,1]==1,]
  # replicate the positive samples to balance the sample  
  for (i in 1:20) data.set <- rbind(data.set,pos)  
  row.names(data.set) <- NULL
  # Return datasets as a Named List
  return(list(dataset1=data.set, dataset2=dataframe2))
}