CreateAmazonAdsReport 프로세서
CreateAmazonAdsReport 프로세서
이 문서는 Snowflake OpenFlow의 CreateAmazonAdsReport 프로세서에 대한 참조 문서예요. Amazon Ads 커넥터를 위한 보고서 구성을 만들어요. 기본적으로 하루에 한 번 실행돼요.
출처: Snowflake 문서
본문
기능 — 일반 제공 (Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP Commercial 리전의 모든 계정에서 사용할 수 있어요.
Openflow BYOC 배포는 AWS Commercial 리전의 모든 계정에서 사용할 수 있어요.
번들 (Bundle)
| 그룹 | NAR |
|---|---|
| com.snowflake.openflow.runtime | runtime-amazon-ads-processors-nar |
설명 (Description)
Amazon Ads 커넥터를 위한 보고서 구성을 만드는 프로세서예요. 기본적으로 하루에 한 번 실행돼요.
태그 (Tags)
Amazon, Amazon Ads, report
입력 요구사항 (Input Requirement)
FORBIDDEN
민감한 동적 속성 지원 (Supports Sensitive Dynamic Properties)
아니요 (false)
속성 (Properties)
| 속성 | 설명 |
|---|---|
| Access Token Provider | OAuth 액세스 토큰을 제공하는 서비스예요. |
| Amazon Advertising Client ID | Amazon Advertising 사용자의 Client ID예요. |
| Region | 광고 데이터를 다운로드할 환경이에요. |
| Report Ad Product | 보고되는 광고 제품의 유형이에요. |
| Report Columns | Reporting API에서 가져오는 열 목록이에요. |
| Report Filters | 반환된 데이터를 다듬는 데 사용하는 필터 집합이에요. |
| Report Group By | 보고서의 세분성(granularity) 수준이에요. |
| Report Ingestion Strategy | 보고서 수집(ingestion)의 구성이에요. |
| Report Ingestion Window | 증분 수집 동안 과거에서 다운로드해야 하는 일 수예요. |
| Report Name | 보고서의 고유 이름이에요. |
| Report Profile ID | 특정 마켓플레이스의 광고 계정과 연결된 프로필 ID예요. |
| Report Start Date | 수집이 시작되어야 하는 시작 날짜예요. |
| Report Time Unit | 날짜 집계 방식이에요. |
| Report Type | 보고서에 포함된 데이터 유형이에요. |
| Web Client Service Provider | REST 요청 실행을 위한 클라이언트를 제공하는 서비스예요. |
상태 관리 (State management)
| 범위 | 설명 |
|---|---|
| CLUSTER | 스키마 변경을 감지하기 위해 마지막 보고서 정의에 대한 정보를 해시 형태로 저장해요. 증분 로드된 보고서는 마지막 수집 날짜를 유지해 초기 로드 이후의 수집 날짜 범위를 정의해요. 또한 시작 날짜도 저장돼요. |
관계 (Relationships)
| 이름 | 설명 |
|---|---|
| success | Amazon Ads Reporting API에서 성공 응답을 받았을 때 전달되는 응답 FlowFiles예요. |
기록하는 속성 (Writes attributes)
| 이름 | 설명 |
|---|---|
| amazon.ads.report.id | 현재 준비된 작업의 고유 식별자예요. |
| amazon.ads.report.name | 보고서의 고유 이름이에요. |
| amazon.ads.ingestion.strategy | 보고서를 SNAPSHOT으로 다운로드할지 INCREMENTALLY로 다운로드할지를 정의하는 전략이에요. |
| amazon.ads.run.id | 현재 수집 프로세스의 고유 식별자예요. |
| amazon.ads.ingestion.start.date | Amazon Ads에서 데이터를 다운로드하는 시작 날짜예요(해당 날짜 포함). |
| amazon.ads.ingestion.end.date | Amazon Ads에서 데이터를 다운로드하는 종료 날짜예요(해당 날짜 포함). |
| amazon.ads.report.schema.changed | 프로세서 실행 사이에 보고서 스키마가 변경되었는지를 나타내는 플래그예요. |
| avro.schema | 구성된 모든 필드 집합을 담은 Avro 스키마예요. |
| fragment.identifier | 각 수집 실행의 고유 ID예요. 단일 실행 중 생성된 모든 flow files를 식별할 수 있게 해줘요. |
| fragment.index | 한 수집 실행 중 생성된 flowfiles 배치에서 고유 식별자를 나타내는 번호예요. |
| fragment.count | 프로세서 실행 중 생성된 flowfiles 수예요. |