CaptureSharepointChanges

CaptureSharepointChanges

SharePoint 문서 라이브러리(Document Library)의 변경 사항을 캡처하고, 발생하는 각 변경마다 FlowFile을 내보내는 프로세서예요. 파일·폴더의 추가·삭제뿐 아니라 권한, 메타데이터, 파일 내용의 변경도 포함돼요.

출처: Snowflake 문서 — CaptureSharepointChanges

본문

번들 (Bundle)

com.snowflake.openflow.runtime | runtime-msgraph-nar

설명

SharePoint 문서 라이브러리에서 변경 사항을 캡처하고, 발생하는 각 변경마다 FlowFile을 내보내요. 여기에는 파일과 폴더의 추가·삭제뿐 아니라 권한, 메타데이터, 파일 내용의 변경이 모두 포함돼요.

태그

cdc, document, graph, library, microsoft, openflow, sharepoint, unstructured

입력 요구 사항 (Input Requirement)

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

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

false — 지원하지 않아요.

속성 (Properties)

속성 설명
Authentication Service SharePoint API에 대한 인증을 제공하는 서비스예요.
Change Capture Initial Action 이전 상태 없이 프로세서가 실행되면, 이 속성이 기존 SharePoint 항목을 어떻게 처리할지 결정해요.
Document Library Name 나열할 문서 라이브러리의 이름이에요. 지정하지 않으면 해당 사이트에 연결된 모든 문서 라이브러리가 나열돼요.
Fallback Retry Duration 통신 실패 후 연산을 재시도하기 전에 기다리는 시간이에요. 응답에 Retry-After 헤더가 없을 때 이 값이 사용돼요.
Fetch Item Permissions true면 프로세서가 캡처한 SharePoint 항목의 사용자·그룹 권한 정보를 가져와요.
Folder Name 나열할 폴더/디렉터리 이름이에요.
Item Permissions To Fetch 캡처한 SharePoint 항목에 대해 가져올 권한 유형의 쉼표로 구분된 목록이에요. 사용 가능한 권한 유형: USER, GROUP, SITE_USER, SITE_GROUP.
Site URL 데이터를 가져올 SharePoint 사이트의 URL이에요.

상태 관리 (State management)

범위 (Scope) 설명
CLUSTER 각 SharePoint 폴더에 대한 토큰을 저장해 어떤 이벤트가 이미 캡처됐는지 상태를 추적해요.

관계 (Relationships)

이름 설명
created 생성된 각 SharePoint 항목에 대해 FlowFile이 이 관계로 라우팅돼요.
deleted 삭제된 각 SharePoint 항목에 대해 FlowFile이 이 관계로 라우팅돼요.
updated 업데이트된 각 SharePoint 항목에 대해 FlowFile이 이 관계로 라우팅돼요.

기록하는 속성 (Writes attributes)

이름 설명
sharepoint.change.type 발생한 변경 유형이에요. 가능한 값은 Created, Updated, PermissionsUpdated, Deleted예요.
sharepoint.item.id 변경된 SharePoint 항목의 ID예요.
sharepoint.item.type 변경된 SharePoint 항목의 유형이에요. 가능한 값은 File과 Folder예요.
sharepoint.path 변경된 SharePoint 항목의 경로예요. 문서 라이브러리 루트 기준의 상대 경로예요.
sharepoint.filename 변경된 SharePoint 항목의 이름이에요. Deleted 변경에는 이 속성이 없어요.
sharepoint.size 변경된 SharePoint 항목의 크기예요.
sharepoint.createdAt 변경된 SharePoint 항목의 생성 타임스탬프예요.
sharepoint.lastModified 변경된 SharePoint 항목의 마지막 수정 타임스탬프예요.
sharepoint.createdBy.<identity>.id 변경된 SharePoint 항목을 만든 identity의 ID예요. 항상 제공되지는 않아요.
sharepoint.createdBy.<identity>.displayName 변경된 SharePoint 항목을 만든 identity의 표시 이름이에요. 항상 제공되지는 않아요.
sharepoint.createdBy.<identity>.email 변경된 SharePoint 항목을 만든 identity의 이메일이에요. 항상 제공되지는 않아요.
sharepoint.lastModifiedBy.<identity>.id 변경된 SharePoint 항목을 수정한 identity의 ID예요. 항상 제공되지는 않아요.
sharepoint.lastModifiedBy.<identity>.displayName 변경된 SharePoint 항목을 수정한 identity의 표시 이름이에요. 항상 제공되지는 않아요.
sharepoint.lastModifiedBy.<identity>.email 변경된 SharePoint 항목을 수정한 identity의 이메일이에요. 항상 제공되지는 않아요.
sharepoint.drive.id 변경된 항목이 담긴 SharePoint Drive의 ID예요.
sharepoint.drive.name 변경된 항목이 담긴 SharePoint Drive의 이름이에요.
sharepoint.site.id 변경된 항목이 담긴 SharePoint 사이트의 ID예요.
sharepoint.site.url 변경된 항목이 담긴 SharePoint 사이트의 URL이에요.
sharepoint.ctag 변경된 SharePoint 항목의 CTag예요.
sharepoint.etag 변경된 SharePoint 항목의 ETag예요.
sharepoint.webUrl 변경된 SharePoint 항목의 브라우저 보기 URL이에요.
sharepoint.permissions.read.groups 변경된 SharePoint 항목에 읽기 권한이 있는 그룹의 쉼표로 구분된 목록이에요. 각 그룹에 대해 SharePoint에 이메일 주소가 있으면 포함되며, [email protected] 같은 그룹 프린시펄도 포함돼요.
sharepoint.permissions.read.groups.ids SharePoint 항목에 읽기 권한이 있는 그룹 ID의 쉼표로 구분된 목록이에요.
sharepoint.permissions.read.users 변경된 SharePoint 항목에 읽기 권한이 있는 사용자의 쉼표로 구분된 목록이에요. 각 사용자에 대해 SharePoint에 이메일 주소가 있으면 포함되며, [email protected] 같은 사용자 프린시펄도 포함돼요.
sharepoint.permissions.read.users.ids SharePoint 항목에 읽기 권한이 있는 Microsoft 365 사용자 ID의 쉼표로 구분된 목록이에요.
sharepoint.permissions.read.siteusers SharePoint 항목에 읽기 권한이 있는 SharePoint 사이트 사용자 이메일의 쉼표로 구분된 목록이에요.
sharepoint.permissions.read.siteusers.ids SharePoint 항목에 읽기 권한이 있는 SharePoint 사이트 사용자 ID의 쉼표로 구분된 목록이에요.
sharepoint.permissions.read.sitegroups.ids SharePoint 항목에 읽기 권한이 있는 SharePoint 사이트 그룹 ID의 쉼표로 구분된 목록이에요.
filename 변경된 SharePoint 항목의 이름이에요. Deleted 변경에는 이 속성이 없어요.
path 변경된 SharePoint 항목의 경로예요. 문서 라이브러리 루트 기준의 상대 경로예요.
mime.type 변경된 SharePoint 항목의 MIME 유형이에요. File 항목에서만 제공돼요.
hash.quickxor 변경된 SharePoint 항목의 QuickXor 해시예요. 항상 제공되지는 않아요.
hash.sha256 변경된 SharePoint 항목의 SHA-256 해시예요. 항상 제공되지는 않아요.
hash.sha1 변경된 SharePoint 항목의 SHA-1 해시예요. 항상 제공되지는 않아요.
hash.crc32 변경된 SharePoint 항목의 CRC32 해시예요. 항상 제공되지는 않아요.

다른 구성 요소를 포함하는 사용 사례 (Use Cases Involving Other Components)

SharePoint 문서 라이브러리에 변경 데이터 캡처(CDC)를 수행해, 권한을 포함한 문서 라이브러리의 모든 데이터를 가져와 대상 시스템을 SharePoint와 동기화 상태로 유지해요.

더 보기 (See also)

  • com.snowflake.openflow.runtime.processors.sharepoint.FetchSharepointFile

더 알아보기 (Learn more)