FetchSharepointMetadata 2025.10.9.21 — SharePoint 메타데이터 가져오기 프로세서
FetchSharepointMetadata 2025.10.9.21 — SharePoint 메타데이터 가져오기 프로세서
FetchSharepointMetadata 프로세서는 각 drive 항목에 대해 메타데이터와 권한을 가져와 FlowFile 속성으로 기록해요.
출처: Snowflake 문서
본문
기능 — 일반 공개 (Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP의 상용 리전에서 모든 계정에 제공돼요.
Openflow BYOC 배포는 AWS의 상용 리전에서 모든 계정에 제공돼요.
Bundle
com.snowflake.openflow.runtime | runtime-msgraph-nar
Description
각 drive 항목에 대해 메타데이터와 권한을 가져와 FlowFile 속성으로 기록해요.
Tags
cdc, document, graph, library, microsoft, openflow, sharepoint, unstructured
Input Requirement
REQUIRED
Supports Sensitive Dynamic Properties
false
Properties
| Property | Description |
|---|---|
| Authentication Service | SharePoint API에 대한 인증을 제공하는 서비스 |
| Drive ID | SharePoint 파일이 있는 drive id |
| Fallback Retry Duration | 통신 실패 후 작업을 재시도하기 전에 기다리는 시간이에요. 응답에 Retry-After 헤더가 없을 때 이 값이 사용돼요 |
| Fetch Item Permissions | true면 프로세서가 캡처된 SharePoint 항목에 대한 사용자 및 그룹 권한 정보를 가져와요 |
| Item ID | 메타데이터를 가져올 항목의 id |
| Item Permissions To Fetch | 캡처된 SharePoint 항목에 대해 가져올 권한 타입의 쉼표로 구분된 목록. 사용 가능한 권한 타입: USER, GROUP, SITE_USER, SITE_GROUP |
| Site ID | SharePoint 파일이 있는 site id |
Relationships
| Name | Description |
|---|---|
| comms.failure | 프로세서가 Graph API와 통신하지 못하면 FlowFile이 여기로 라우팅돼요. 재시도할 수 있어요 |
| failure | 항목의 메타데이터와 권한을 가져올 수 없으면 들어오는 FlowFile이 이 관계로 라우팅돼요 |
| not.found | 항목을 찾지 못하면 FlowFile이 여기로 라우팅돼요 |
| success | 항목의 메타데이터와 권한을 가져와 FlowFile 속성에 기록한 후 들어오는 FlowFile이 이 관계로 라우팅돼요 |
Writes attributes
| Name | Description |
|---|---|
| sharepoint.item.id | SharePoint 항목의 ID |
| sharepoint.item.type | SharePoint 항목의 타입. 가능한 값은 'File'과 'Folder'예요 |
| sharepoint.path | SharePoint 항목의 경로. Document Library의 루트에 상대적인 경로예요 |
| sharepoint.filename | SharePoint 항목의 이름. 'Deleted' 변경 사항에는 이 속성이 없어요 |
| sharepoint.size | SharePoint 항목의 크기 |
| sharepoint.createdAt | SharePoint 항목의 생성 타임스탬프 |
| sharepoint.lastModified | SharePoint 항목의 마지막 수정 타임스탬프 |
| sharepoint.createdBy. |
SharePoint 항목을 만든 identity의 id. 항상 사용 가능한 것은 아니에요 |
| sharepoint.createdBy. |
SharePoint 항목을 만든 identity의 표시 이름. 항상 사용 가능한 것은 아니에요 |
| sharepoint.createdBy. |
SharePoint 항목을 만든 identity의 이메일. 항상 사용 가능한 것은 아니에요 |
| sharepoint.lastModifiedBy. |
SharePoint 항목을 마지막으로 수정한 identity의 id. 항상 사용 가능한 것은 아니에요 |
| sharepoint.lastModifiedBy. |
SharePoint 항목을 마지막으로 수정한 identity의 표시 이름. 항상 사용 가능한 것은 아니에요 |
| sharepoint.lastModifiedBy. |
SharePoint 항목을 마지막으로 수정한 identity의 이메일. 항상 사용 가능한 것은 아니에요 |
| sharepoint.drive.id | 항목을 포함하는 SharePoint Drive의 ID |
| sharepoint.site.id | 항목을 포함하는 SharePoint Site의 ID |
| sharepoint.ctag | SharePoint 항목의 CTag |
| sharepoint.etag | SharePoint 항목의 ETag |
| sharepoint.webUrl | SharePoint 항목의 브라우저 보기 url |
| sharepoint.permissions.read.groups | SharePoint 항목에 읽기 권한이 있는 그룹의 쉼표로 구분된 목록. 각 그룹에 대해 SharePoint에 이메일 주소가 있으면 포함돼요. 또한 [email protected] 같은 그룹 프린시펄(principal)도 포함돼요 |
| sharepoint.permissions.read.groups.ids | SharePoint 항목에 읽기 권한이 있는 그룹 ID의 쉼표로 구분된 목록 |
| sharepoint.permissions.read.users | SharePoint 항목에 읽기 권한이 있는 사용자의 쉼표로 구분된 목록. 각 사용자에 대해 SharePoint에 이메일 주소가 있으면 포함돼요. 또한 [email protected] 같은 사용자 프린시펄도 포함돼요 |
| sharepoint.permissions.read.users.ids | SharePoint 항목에 읽기 권한이 있는 Microsoft365 사용자 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 항목의 이름 |
| path | SharePoint 항목의 경로. Document Library의 루트에 상대적인 경로예요 |
| mime.type | SharePoint 항목의 MIME 타입. 'File' 항목에만 사용 가능해요 |
| hash.quickxor | SharePoint 항목의 QuickXor 해시. 항상 사용 가능한 것은 아니에요 |
| hash.sha256 | SharePoint 항목의 SHA-256 해시. 항상 사용 가능한 것은 아니에요 |
| hash.sha1 | SharePoint 항목의 SHA-1 해시. 항상 사용 가능한 것은 아니에요 |
| hash.crc32 | SharePoint 항목의 CRC32 해시. 항상 사용 가능한 것은 아니에요 |