CaptureGoogleDriveChanges 2025.5.31.15

번들

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

설명

Shared Google Drive의 변경 내용을 캡처하고 변경 사항이 발생할 때마다 FlowFile 을 전송합니다. 여기에는 파일 추가 및 삭제, 파일 메타데이터 및 권한 변경이 포함됩니다. 이 프로세서는 FetchGoogleDrive 프로세서와 함께 사용하도록 설계되었습니다.

태그

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

입력 요구 사항

FORBIDDEN

민감한 동적 속성 지원

false

속성

속성

설명

Drive ID

모니터링할 Shared Google Drive의ID 입니다.

GCP Credentials Service

컨트롤러 서비스는 Google 클라우드 플랫폼 자격 증명을 얻는 데 사용됩니다.

상태 관리

범위

설명

CLUSTER

이미 처리된 변경 사항을 추적하기 위해 토큰/커서를 저장합니다.

관계

이름

설명

created

이 관계는 생성되는 모든 파일에 사용됩니다.

removed

이 관계는 삭제된 모든 파일에 사용됩니다.

updated

이 관계는 업데이트되는 모든 파일에 사용됩니다.

Writes 특성

이름

설명

google.drive.drive.id

Shared 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.<역할>.users

지정된 역할이 있는 사용자의 쉼표로 구분된 이메일 주소 목록입니다. 유효한 역할은 ‘owner’, ‘organizer’, ‘fileOrganizer’, ‘writer’, ‘commenter’, ‘reader’입니다. 예를 들어, 소유자 john.doe@gmail.com 및 사용자 jane.doe@gmail.comjake.doe@gmail.com이 독자인 경우 값이 john.doe@gmail.comgoogle.drive.permissions.owner.users 라는 특성과 값이 jane.doe@gmail.com, jake.doe@gmail.comgoogle.drive.permissions.reader.users 라는 특성이 있습니다.

google.drive.permissions.<역할>.groups

지정된 역할이 있는 그룹에 대한 쉼표로 구분된 이메일 주소 목록입니다. 유효한 역할은 ‘owner’, ‘organizer’, ‘fileOrganizer’, ‘writer’, ‘commenter’, ‘reader’입니다. 예를 들어, 소유자가 employees@openflow-all-dev.iam.gserviceaccount.com 이고 그룹 contractors@openflow-all-dev.iam.gserviceaccount.com 이 읽기 권한을 보유한 경우, 값이 employees@openflow-all-dev.iam.gserviceaccount.comgoogle.drive.permissions.owner.groups 라는 특성과 값이 contractors@openflow-all-dev.iam.gserviceaccount.comgoogle.drive.permissions.reader.groups 라는 특성이 있습니다.

google.drive.permissions.<역할>.domains

모든 사용자에게 주어진 역할이 있는 도메인 네임의 쉼표로 구분된 목록입니다. 유효한 역할은 ‘owner’, ‘organizer’, ‘fileOrganizer’, ‘writer’, ‘commenter’, ‘reader’입니다. 예를 들어, snowflake.com 도메인의 모든 사용자에게 독자 역할이 있는 경우 값이 snowflake.comgoogle.drive.permissions.reader.domains 이라는 특성이 있습니다.

google.drive.permissions.<역할>.public

파일이 공개적으로 공유되는 경우 이 특성은 공개에 적용되는 모든 역할에 대해 ‘true’ 값으로 추가됩니다.

google.drive.file.path

Google Drive에서 파일의 계층적 경로(예: ‘parent_folder/child_folder/file.txt’)입니다.

참고 항목