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

属性¶

属性	描述
云端硬盘 ID	要监控的共享 Google 云端硬盘的 ID。
GCP 凭据服务	用于获取 Google Cloud Platform 凭据的控制器服务。

状态管理¶

范围	描述
CLUSTER	存储令牌/游标以跟踪已处理的变更。

关系¶

名称	描述
created	此关系用于所有已创建的文件。
removed	此关系用于所有已删除的文件。
updated	此关系用于所有已更新的文件。

写入属性¶

名称	描述
google.drive.drive.id	共享 Google 云端硬盘的 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 纪元以来的毫秒数表示。
google.drive.created.time	文件创建时的时间戳，以自 Unix 纪元以来的毫秒数表示。
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”。例如，如果所有者是 john.doe@gmail.com，而用户 jane.doe@gmail.com 和 jake.doe@gmail.com 是阅读者，则会有一个名为 `google.drive.permissions.owner.users` 的属性，其值为 `john.doe@gmail.com`，以及一个名为 `google.drive.permissions.reader.users` 的属性，其值为 `jane.doe@gmail.com, jake.doe@gmail.com`
google.drive.permissions.<role>.groups	具有指定角色的群组电子邮件地址列表，以逗号分隔。有效角色包括“owner”、“organizer”、“fileOrganizer”、“writer”、“commenter”、“reader”。例如，如果所有者是 `employees@openflow-all-dev.iam.gserviceaccount.com`，群组 `contractors@openflow-all-dev.iam.gserviceaccount.com` 是阅读者，则会有一个名为 `google.drive.permissions.owner.groups` 的属性，其值为 `employees@openflow-all-dev.iam.gserviceaccount.com`，以及一个名为 `google.drive.permissions.reader.groups` 的属性，其值为 `contractors@openflow-all-dev.iam.gserviceaccount.com`
google.drive.permissions.<role>.domains	以逗号分隔的域名列表，所有用户都具有给定角色。有效角色包括“owner”、“organizer”、“fileOrganizer”、“writer”、“commenter”、“reader”。例如，如果域名 `snowflake.com` 中的所有用户角色均为阅读者，则会有一个名为 `google.drive.permissions.reader.domains` 的属性，其值为 `snowflake.com`
google.drive.permissions.<role>.public	如果文件是公开共享的，则对于任何适用于公众的角色，该属性的值都将为“true”。
google.drive.file.path	Google 云端硬盘中文件的分层路径，例如“parent_folder/child_folder/file.txt”。