소개

Google 드라이브는 Google에서 제공하는 무료 온라인 저장소(스토리지)입니다. 문서 파일, 사진, 음악, 동영상 등 다양한 형태의 데이터를 인터넷을 통해 저장할 수 있는 매우 편리한 서비스입니다.
이번에는 Xplenty에 의한 Google 드라이브의 텍스트나 CSV/TSV 형식의 파일을 읽고 다른 시스템에 연계하는 방법을 소개합니다. 주요한 연계 시스템은 Destination의 파일 스토리지나 데이터베이스가 되겠습니다.

보다 편리하게 사용하기 위한 간단한 활용법도 소개합니다.

파일 연합 준비 사항

Google 드라이브에서 파일을 연결하려면 준비가 필요합니다.

우선, Google 드라이브 커넥션의 작성과 그 커넥션의 Unique ID나 대상의 Google 드라이브의 드라이브 ID를 아래의 그림을 참고해 확인해 주세요.
지정한 파일을 Google 드라이브에서 가져오기 위한 쿼리 문자열을 구글 페이지를 참고하여 만들고, URL Encode를 통한 변환도 미리 해 두십시요.

1. 연결 페이지에서 복사 소스 인 Google 드라이브의 연결을 생성하고 커넥션의 Unique ID를 얻습니다.
   
2. URL로부터 대상 드라이브의 ID와 대상 파일명을 취득(아래 그림의 ①과 ②에 해당)
   
3. Google Drive의 가이드에 있는 < 쿼리 문자열의 예 >를 참고하여 Google API와 대상 파일명이 취득한 쿼리 문자열을 합체하여 URL을 URL Encoder로 변환해 (아래 예시 참조)

## 쿼리 문자열의 예
지정된 구글 드라이브에서 파일이름이 head_content를 포함하고 mineTYpe이 CSV형식인 파일 리스트의 받기

<Google API의 URL>
https://www.googleapis.com/drive/v3/files?q=<쿼리_문자열>

<쿼리 문자열>
name contains "head_content" and mimeType="text/csv" and "<---구글_드라이브_ID--->" in parents

<URL Encode로 변혼한 파일 리스트 취득 URL>
https://www.googleapis.com/drive/v3/files?q=name+contains+%22head_content%22+and+mimeType%3D%22text%2Fcsv%22+and+%22<---구글_드라이브_ID--->%22+in+parents

그럼, 여기로부터 Xplenty를 사용한 파일 연계의 본격적인 순서입니다. 아래의 순서대로 설정하면 Google 드라이브를 통한 파일 연계가 가능해 집니다.

파일 연계 절차

이 섹션에서는 Google 드라이브에서 텍스트 형식의 파일 (TXT, CSV, TSV)을 파일 스토리지 및 데이터베이스에 연결하는 단계에 대해 설명합니다.
먼저 Xplenty에서 익숙한 Package 작성/편집 화면에서 +Add Component를 클릭하고 Source에서 REST API 아이콘을 선택합니다. RestAPI 컴포넌트를 열고 아래 그림과 같이 상세 내용을 설정하여 해당 파일이 선택되어 있는지 확인하십시오.

1. RestAPI 컴포넌트에서 Google API를 사용하여 파일 목록 가져오기인증 유형은 연결을 선택하고 Google 드라이브 연결을 지정합니다. Method and URL 설정은 다음과 같습니다.
   

   • Method - GET으로 설정
   • URL - https://www.googleapis.com/drive/v3/files?q=name+contains+%22head_content%22+and+mimeType%3D%22text%2Fcsv%22+and+%22<---구글_드라이브_ID--->%22+in+parents
   • Response - JSON 선택 및 $.files[*]을 설정

   
   Google API URL과 파일 선택 쿼리 문자열로 만든 URL을 설정하고 Response는 JSON형식으로 받습니다.

   
   Data Preview에서 대상 파일 목록이 올바른지 확인하고 id, name필드를 선택 하십시오.

2. Filter 컴포넌트 에서 정규 표현식의 매칭을 통해 파일 리스트로부터 연계 대상의 파일 ID와 파일명을 추출

   • Conditions :AND
   • Operator :Text matches (regex)
   • Value/Expression :^100_.*$

3. Select 컴포넌트에서 CCurl커멘드를 이용해 GET 메소드에 의한 파일의 전송을 실시하고. 파일의 내용이 담김 body부분만을 가져옴
   

   • Expression :CCurl(CONCAT('https://www.googleapis.com/drive/v3/files/', id, '?alt=media'), 'GET', '', '', '<---구글_드라이브_ID--->')#'body'
     • 참고 : CCurl 명령에서는 Google 드라이브 커넥션의 Unique ID를 지정하십시오! !
   • Alias :api_response_body

4. body부의 내용은 1개의 레코드로 인식하기에, Select 컴포넌트 상에서 Flatten함수를 사용해 복수의 레코드로 분리

   • Expression :Flatten(STRSPLITTOBAG(api_response_body, '\\n'))
   • Alias :line

5. Filter 컴포넌트 에서 정규식을 통해 헤더 레코드를 제거
   

   • 삭제할 헤더 :seq,name/first,name/last,age,street,city,state,zip,dollar,pick,date
   • Conditions :NOT
   • Value/Expression :^seq.+$

6. Select 컴포넌트 에서 CSVSPLIT함수를 사용해 레코드를 필드별로 분리된 배열로 변환
   

7. Select 컴포넌트에서 배열의 각 요소를 적합한 데이터 형식으로 캐스팅하여 변환
   

8. Destination의 파일 스토리지 및 데이터베이스에 저장
   

간단한 활용법

파일 연계의 전후 관계가 없고 Google 드라이브로부터의 복수 파일 연계를 1개의 패키지로 관리하고 싶은 경우, 아래와 같은 활용이 가능합니다.

1. Google 드라이브에서 여러 파일을 동시에 연계 아래 그림과 같이 취득한 파일 목록에 여러 개의 Clone 컴포넌트의 연결에 의해, 하나의 패키지 실행으로 동시에 여러 파일을 연계할 수 있습니다.
   

2. 여러 곳의 Google 드라이브와의 파일 연계
   여러개의 Google Drive 커넥션을 사용하여, 1개의 패키지에서 여러 곳의 Google 드라이브에서 동시에 파일 연계가 가능해 집니다. 쉽게 이야기 하면 위의 파일 연계가 옆으로 몇개씩 나열 되어 있는 형태라고 생각하시면 됩니다.

패키지 템플릿을 사용할 때

지금까지 설명한 내용에 대해서는 Xplenty의 데이터 플로의 템플릿으로 이미 제공하고 있습니다.
아래 그림과 같이 패키지 작성 화면에서 Template 항목에서 바로 찾을 수 있습니다.

템플릿의 경우, 두 개의 사용자 변수 설정만으로 바로 사용할 수 있습니다.

• query_string : 쿼리 문자열 지정
• google_drive_connection_id : Google 드라이브 연결의 Unique ID 지정

마지막으로

편리한 Google 드라이브를 통한 파일 연동은 특히 비즈니스 부서에서 매우 일반적인 사용법입니다.
Xplenty는 프로그래밍 경험이 있는 분은 물론, 비즈니스 부서에서 프로그래밍 경험이 거의 없는 분들도 곧바로 사용할 수 있는 DX 전문의 로우 코드 툴입니다.

Xplenty를 사용해 파일 제휴와 같은 간단한 업무로부터 귀사의 자동화를 스스로 해 보지 않으시겠습니까?
저희 홈페이지 에서 부담없이 프리 트라이얼 과 데모 신청 을 할 수 있습니다. 여러분의 많은 신청을 기다리고 있습니다.