CaptureGoogleDriveChanges

CaptureGoogleDriveChanges

공유 Google Drive의 변경 사항을 캡처해, 발생하는 각 변경마다 FlowFile을 내보내는 프로세서예요. 파일의 추가·삭제뿐 아니라 파일 메타데이터와 권한의 변경도 포함돼요.

출처: Snowflake 문서 — CaptureGoogleDriveChanges

본문

번들 (Bundle)

com.snowflake.openflow.runtime | runtime-google-drive-nar

설명

공유 Google Drive의 변경 사항을 캡처하고, 발생하는 각 변경마다 FlowFile을 내보내요. 여기에는 파일의 추가·삭제, 파일 메타데이터와 권한의 변경이 모두 포함돼요. 이 프로세서는 FetchGoogleDrive 프로세서와 함께 사용하도록 설계됐어요.

태그

authorization, cdc, change data capture, cloud, drive, gcp, google, openflow, permissions, storage, unstructured

입력 요구 사항 (Input Requirement)

FORBIDDEN — 입력 FlowFile이 허용되지 않아요.

민감한 동적 속성 지원 (Supports Sensitive Dynamic Properties)

false — 지원하지 않아요.

속성 (Properties)

속성 설명
Drive ID 모니터링할 공유 Google Drive의 ID예요.
GCP Credentials Service Google Cloud Platform 자격 증명을 얻는 데 사용하는 Controller Service예요.

상태 관리 (State management)

범위 (Scope) 설명
CLUSTER 이미 처리된 변경 사항을 추적하기 위한 토큰/커서를 저장해요.

관계 (Relationships)

이름 설명
created 생성된 모든 파일에 사용되는 관계예요.
removed 삭제된 모든 파일에 사용되는 관계예요.
updated 업데이트된 모든 파일에 사용되는 관계예요.

기록하는 속성 (Writes attributes)

이름 설명
google.drive.drive.id 공유 Google Drive의 ID예요.
google.drive.file.id 변경된 파일의 ID예요.
drive.id 변경된 파일의 ID예요. FetchGoogleDrive의 기본 구성과의 호환을 위해 반복돼요.
google.drive.file.name 변경된 파일의 이름이에요.
google.drive.change.type 발생한 변경 유형이에요. 가능한 값은 CREATED, UPDATED, DELETED예요.
google.drive.change.time Unix epoch 이후 밀리초로 표시된 변경 시점 타임스탬프예요.
google.drive.created.time Unix epoch 이후 밀리초로 표시된 파일 생성 시점 타임스탬프예요.
google.drive.webUrl 브라우저에서 관련 Google 편집기나 뷰어로 파일을 여는 링크예요.
google.drive.size 바이트 단위의 파일 크기예요.
google.drive.md5 파일의 MD5 체크섬이에요.
google.drive.version 파일의 버전이에요. 사용자 및 시스템 기반 파일 업데이트에 따라 바뀌어요.
google.drive.mime.type 파일의 MIME 유형이에요.
google.drive.lastModifiedBy.displayName 파일을 수정한 사용자의 표시 이름이에요.
google.drive.lastModifiedBy.email 파일을 수정한 사용자의 이메일이에요.
google.drive.permissions.<role>.users 지정된 역할을 가진 사용자 이메일 주소의 쉼표로 구분된 목록이에요. 유효한 역할은 owner, organizer, fileOrganizer, writer, commenter, reader예요. 예를 들어 소유자가 [email protected]이고 [email protected]과 [email protected]이 reader라면, 값이 [email protected]인 google.drive.permissions.owner.users 속성과 값이 [email protected], [email protected]인 google.drive.permissions.reader.users 속성이 생겨요.
google.drive.permissions.<role>.groups 지정된 역할을 가진 그룹 이메일 주소의 쉼표로 구분된 목록이에요. 유효한 역할은 owner, organizer, fileOrganizer, writer, commenter, reader예요. 예를 들어 소유자가 [email protected]이고 그룹 [email protected]이 reader라면, 값이 [email protected]인 google.drive.permissions.owner.groups 속성과 값이 [email protected]인 google.drive.permissions.reader.groups 속성이 생겨요.
google.drive.permissions.<role>.domains 모든 사용자가 지정된 역할을 가진 도메인 이름의 쉼표로 구분된 목록이에요. 유효한 역할은 owner, organizer, fileOrganizer, writer, commenter, reader예요. 예를 들어 example.com 도메인의 모든 사용자가 reader 역할이라면, 값이 example.com인 google.drive.permissions.reader.domains 속성이 생겨요.
google.drive.permissions.<role>.public 파일이 공개적으로 공유되면, public에 적용되는 모든 역할에 대해 값이 true인 이 속성이 추가돼요.
google.drive.file.path Google Drive에서 파일의 계층적 경로예요. 예: parent_folder/child_folder/file.txt

더 보기 (See also)

  • com.snowflake.openflow.runtime.processors.sharepoint.CaptureSharepointChanges
  • org.apache.nifi.processors.gcp.drive.FetchGoogleDrive

더 알아보기 (Learn more)