ListHubSpotObjects
ListHubSpotObjects
지정된 object type에 대해 HubSpot에서 데이터를 가져오고, 나열된 각 객체에 대해 해당 메타데이터를 FlowFile 특성으로 담은 FlowFile 하나를 생성하는 프로세서예요. object type은 검색 가능해야 하며, 즉 /search 엔드포인트에 대한 액세스를 지원해야 해요. 검색 가능한 object type에 대한 자세한 내용은 https://developers.hubspot.com/docs/reference/api/crm/objects/objects#search 를 참고하세요.
출처: Snowflake 문서
본문
기능 — 일반 제공(Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP Commercial 리전의 모든 계정에서 사용할 수 있어요. Openflow BYOC 배포는 AWS Commercial 리전의 모든 계정에서 사용할 수 있어요.
Bundle
com.snowflake.openflow.runtime | runtime-hubspot-processors-nar
설명 (Description)
지정된 object type에 대해 HubSpot에서 데이터를 가져오고, 나열된 각 객체에 대해 해당 메타데이터를 FlowFile 특성으로 담은 FlowFile 하나를 생성해요. object type은 검색 가능해야 하며, 즉 /search 엔드포인트에 대한 액세스를 지원해야 해요. 검색 가능한 object type에 대한 자세한 내용은 https://developers.hubspot.com/docs/reference/api/crm/objects/objects#search 를 참고하세요.
태그 (Tags)
Preview, hubspot
입력 요구사항 (Input Requirement)
REQUIRED (필수)
민감한 동적 속성 지원 (Supports Sensitive Dynamic Properties)
false
속성 (Properties)
| Property | Description |
|---|---|
| HubSpot Service | HubSpot Client Service예요. |
| Object Type | HubSpot object type이에요. |
| Updated After | 지정된 날짜 이후에 업데이트된 객체를 필터링해요(형식: yyyy-MM-dd). |
상태 관리 (State management)
| Scopes | Description |
|---|---|
| CLUSTER | 재시작 후 마지막으로 알려진 위치에서 데이터 검색을 계속하고 변경된 데이터만 가져오기 위해 페이지네이션 상태와 마지막 동기화 타임스탬프를 유지해요. |
관계 (Relationships)
| Name | Description |
|---|---|
| failure | HubSpot 실패 관계예요. |
| original | 입력 Flow File이 original 관계로 연결돼요. |
| retry | HubSpot 재시도 관계예요. 서버 timeout 또는 rate limit 관련 오류로 처리에 실패한 FlowFiles예요. 여기로 연결된 FlowFiles는 프로세서로 다시 연결해야 해요. |
| success | HubSpot 성공 관계예요. |
쓰기 속성 (Writes attributes)
| Name | Description |
|---|---|
| mime.type | application/json이에요. |
| statement.type | 이 프로세서의 경우 항상 ‘UPSERT’예요. |
| hubspot.object.type | 이 가져오기의 HubSpot Object Type이에요. |
| hubspot.object.id | 이 가져오기의 HubSpot Object ID예요. |
| hubspot.run.id | 이 실행 시작의 타임스탬프예요. 들어오는 FlowFile에서 얻거나 사용할 수 없으면 현재 시간에서 얻어요. |
| hubspot.is_last | 이 객체가 수집의 마지막 페이지 객체인지 여부예요. |
사용 사례 (Use cases)
| 수행 내용 |
|---|
| 이 프로세서는 일반적으로 GenerateFlowFile 프로세서와 함께 사용돼요. |
함께 보기 (See also)
- com.snowflake.openflow.runtime.processors.hubspot.GetHubSpotObject
- com.snowflake.openflow.runtime.processors.hubspot.GetHubSpotSchema
- com.snowflake.openflow.runtime.processors.hubspot.ListArchivedHubSpotData
- com.snowflake.openflow.runtime.processors.hubspot.PutHubSpot