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 수예요.

더 알아보기 (Learn more)