project-lib for R (더 이상 사용되지 않음)

프로젝트 정보 가져오기

다음 함수를 사용하여 프로그래밍 방식으로 프로젝트 관련 정보를 가져올 수 있습니다.

• get_name()

  이 함수는 프로젝트의 이름을 반환합니다.

• get_description()

  이 함수는 프로젝트에 대한 설명을 반환합니다.

• get_metadata()

  이 함수는 프로젝트 메타데이터를 반환합니다.

• get_files()

  이 함수는 프로젝트에 포함된 파일 목록을 반환합니다. 반환된 목록의 각 항목에는 파일의 ID와 이름이 포함되어 있습니다. 반환되는 파일 목록은 특정 기준에 따라 정렬되지 않으며, 함수를 다시 호출하면 변경될 수 있습니다.

• get_assets()

  이 함수는 모든 프로젝트 자산의 목록을 반환합니다. 함수에 선택적 assetType 매개변수를 전달하면 get_assets 자산 유형별로 필터링할 수 있습니다. 이 매개변수의 허용 값은, connection 및 data_asset 입니다 asset. 이 메서드는 프로젝트에 asset 포함된 모든 자산을 반환합니다. 예를 들어, 데이터 자산만 가져오려면 해당 함수를 사용하세요 get_assets("data_asset").

• get_connections()

  이 함수는 프로젝트에 있는 연결 목록을 반환합니다. 반환된 목록의 각 항목에는 연결의 ID와 이름이 포함되어 있습니다.

파일 가져오기

다음 함수를 사용하여 프로젝트에 저장된 파일을 페치할 수 있습니다.

• get_file(filename) 여기서 filename 는 가져오려는 파일의 이름입니다.

  이 함수는 파일을 실행 중인 커널의 메모리로 불러옵니다. 이 함수는 커널 고유의 데이터 구조체(예: R 데이터 프레임)에 바인딩하는 데 사용할 수 있는 바이트 버퍼를 반환합니다. 파일 크기가 매우 큰 경우에는 이 파일 가져오기 방법을 권장하지 않습니다.

  다음 예제는 파일을 가져와 데이터를 R 데이터 프레임으로 읽어들이는 방법을 보여줍니다:

  # Import project lib
  library("projectLib")
  project <- access_project()
  
  # Fetch data
  my.file <- project$get_file("my_file.csv")
  
  # Read the CSV data file into a data frame
  df.data <-  read.csv(text = rawToChar(my.file))
  head(df.data)
  

데이터 저장

다음 기능을 사용하여 데이터를 프로젝트에 파일로 저장할 수 있습니다. 이 함수는 여러 가지 기능을 수행합니다. 먼저 데이터를 파일에 넣은 후 이 데이터를 프로젝트에 데이터 자산으로 추가하여 프로젝트의 데이터 자산 목록에서 파일로 저장한 데이터를 볼 수 있습니다.

• save_data(filename, data, setProjectAsset=TRUE, overwrite=FALSE)

  이 함수는 다음 매개변수를 받습니다:

  • filename: 생성된 파일의 이름.

  • data: 업로드할 데이터. 이 매개변수의 허용되는 유형은 R 원시 객체 또는 문자열 버퍼입니다.

  • setProjectAsset[optional]: 데이터가 파일에 성공적으로 업로드된 후 파일을 데이터 자산으로 프로젝트에 추가합니다. 이 함수는 부울 값을 받으며, 기본값은 true로 설정되어 있습니다.

  • overwrite[optional]: 파일이 이미 있는 경우 파일을 겹쳐씁니다. 기본값은 false로 설정되어 있습니다.

    다음은 데이터를 파일에 저장하는 방법을 보여주는 예제입니다.

    library("projectLib")
    project <- access_project()
    
    # Capture CSV data from console output
    csv_lines <- capture.output(write.csv(df.data, row.names=FALSE), type="output")
    csv_raw <- charToRaw(paste0(csv_lines, collapse='\n'))
    
    project$save_data("file.csv", csv_raw)
    

연결에서 데이터를 읽기

다음 함수를 사용하여 특정 연결의 메타데이터(인증 정보)를 가져올 수 있습니다.

get_connection: 이 함수는 연결 ID 또는 연결 이름을 입력으로 받습니다. project에 나열된 모든 자산의, nametype 및 id값을 반환하는 함수를 get_assets() 사용하여 이 값들을 얻을 수 있습니다.

이 함수는 연결 데이터 소스에서 데이터를 가져오는 get_connection 데 사용할 수 있는 연결 자격 증명을 반환합니다.

다음은 해당 get_connection 함수를 사용하여 연결의 인증 정보를 가져오는 방법을 보여주는 예시입니다:

# Import project lib
library(projectLib)
project <- access_project()

# Fetch connection
conn.cred <- project$get_connection(name="<ConnectionName>")

예를 들어, 연결 대상이 dashDB 인 경우 다음 코드를 실행하여 데이터를 가져올 수 있습니다:

library(ibmdbR)

props <- paste("DASHDB;DATABASE=BLUDB;HOSTNAME=", conn.cred$host, ";PORT=50000;PROTOCOL=TCPIP;", sep="")
conn <- idaConnect(props, uid = conn.cred$username, pwd = conn.cred$password, conType = "odbc")
idaInit(conn)

idf.1 <- ida.data.frame('<TableName>')
head(idf.1)

연결된 데이터 가져오기

연결된 데이터의 인증 정보를 가져오려면 다음 함수를 사용할 수 있습니다. 이 함수는 연결 자격 증명을 포함하는 사전과 더불어, 해당 연결 내의 특정 데이터(예: dashDB 인스턴스의 테이블이나 Cloudant 인스턴스의 데이터베이스)를 가리키는 속성을 datapath 반환합니다.

get_connected_data: 이 함수는 연결된 데이터의 ID 또는 이름을 입력으로 받습니다. project에 나열된 모든 자산의, nametype 및 id값을 반환하는 함수를 get_assets() 사용하여 이 값들을 얻을 수 있습니다.

다음은 ` dashDB ` 인스턴스에서 `function get_connected_data `을 사용하여 연결된 데이터의 자격 증명을 가져오는 방법을 보여주는 예시입니다:

# Import project lib
library(projectLib)
project <- access_project()

# Fetch credentials of the connected data
conn.data <- project$get_connected_data(id="<ConnectedDataId>")