이 블로그에서는 Xplenty의 Rest API Component를 사용하여 Google Sheet에서 데이터를 로드하는 방법에 대해 설명합니다.

Rest API 구성 요소 설정

인증(Authentication) 설정

미리 연결 화면에서 만든 Google Sheet 인증을 선택합니다.

URL 지정 방법

URL:https://sheets.googleapis.com/v4/spreadsheets/シートID/values:batchGet?ranges=セル範囲&majorDimension=ROWS

시트 ID:
Google Sheet URL에서 시트 ID 가져오기

셀 범위:
예) A1 : G1000 (A 열의 1 행부터 G 열의 1000 행까지)

Response 설정

$..values[*]를 입력

필드 선택

획득한 JSON 플랫화

변환 1 : BAG 형에서 Tuple 형으로 변환

Select 구성 요소를 사용하고 BagToTuple 함수를 사용하여 Tuple 형식으로 변환

변환 2:각 열을 배열 번호를 지정해, 각각 취득한다

각각의 열을 배열 번호($0)를 지정해 취득함과 함께, Chararray 함수로 캐릭터 라인형으로 변환한다

헤더 행을 필터로 제외

1행째에 헤더행이 포함되어 있는 경우, 필터로 제외한다 (Rest API측의 셀의 범위 지정으로 헤더행을 제외하는 방법도 있다.)
(예) id열에 「Id」라고 하는 문자가 포함되어 있지 않은 데이터만 추출

로드할 구성 요소를 설정하고 작업을 실행하고 확인

마지막으로 데이터베이스, DWH, 스토리지 등에 로드하면 완료됩니다.

패키지 전체도

예) Snowflake가 로드 대상인 경우 다음과 같은 흐름이 됩니다.

데이터가 올바르게 반영되었는지 확인

Google Sheet에 쓰기도 가능

Xpelnty에서는 Select 구성요소에 Curl 요청을 작성하여 Google Sheet에 쓸 수 있습니다.


쓰기 요청 예:CCurl(CONCAT('https://sheets.googleapis.com/v4/spreadsheets/', '$spreadsheetId', '/values:batchUpdate'),'POST','{"Accept":"application/json"}',CONCAT('{"valueInputOption":"RAW","data":[{"range":"','$range','","majorDimension": "ROWS","values": [', BagToString(data, ','), ',]}]}'), '$connection_id')
위 요청에서 사용하는 변수 정보

$spreadsheetId : GoogleSheet ID 지정

$connection_id : Xplenty의 연결 ID 지정 (연결 화면에서 확인할 수 있습니다.)
예: GOOGLESHEETS_CONNECTION_9215

$range : 시트 이름과 셀 범위 지정.
예: campaign!A1:N100000