# SendGrid 엔터티에서 읽기
<a name="sendgrid-reading-from-entities"></a>

**사전 조건**

읽으려는 SendGrid 객체입니다. 객체 이름(예: `lists`, `singlesends` 또는 `segments`)이 필요합니다.

**소스에 대해 지원되는 엔터티**:


| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \* 지원 | 분할 지원 | 
| --- | --- | --- | --- | --- | --- | 
| Lists | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| Single Sends | 예 | 예 | 아니요 | 예 | 아니요 | 
| Marketing Campaign Stats-Automations | 예 | 예 | 아니요 | 예 | 아니요 | 
| Marketing Campaign Stats-Single Sends | 예 | 예 | 아니요 | 예 | 아니요 | 
| Segments | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| Contacts | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 범주 | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 
| Stats | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| Unsubscribe Groups | 예 | 아니요 | 아니요 | 예 | 아니요 | 

**예시:**

```
sendgrid_read = glueContext.create_dynamic_frame.from_options(
    connection_type="sendgrid",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "lists",
        "API_VERSION": "v3",
        "INSTANCE_URL": "instanceUrl"
    }
```

**SendGrid 엔터티 및 필드 세부 정보**:

정적 메타데이터를 포함하는 엔터티:



- **Lists**
  - **필드:** id / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** name / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** contact\_count / **데이터 유형:** Integer / **지원되는 연산자:** N/A
  - **필드:** \_metadata / **데이터 유형:** Struct / **지원되는 연산자:** N/A

- **Single Sends**
  - **필드:** id / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** name / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO
  - **필드:** abtest / **데이터 유형:** Struct / **지원되는 연산자:** N/A
  - **필드:** status / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO
  - **필드:** categories / **데이터 유형:** 나열 / **지원되는 연산자:** EQUAL\_TO
  - **필드:** send\_at / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** is\_abtest / **데이터 유형:** 불 / **지원되는 연산자:** N/A
  - **필드:** updated\_at / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** created\_at / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** channels / **데이터 유형:** 나열 / **지원되는 연산자:** N/A

- **Marketing Campaign Stats-Automations**
  - **필드:** id / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** aggregation / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** step\_id / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** stats / **데이터 유형:** Struct / **지원되는 연산자:** N/A
  - **필드:** automation\_ids / **데이터 유형:** 나열 / **지원되는 연산자:** EQUAL\_TO

- **Marketing Campaign Stats-Singlesends**
  - **필드:** id / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** ab\_variation / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** ab\_phase / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** aggregation / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** stats / **데이터 유형:** Struct / **지원되는 연산자:** N/A
  - **필드:** singlesend\_ids / **데이터 유형:** 나열 / **지원되는 연산자:** EQUAL\_TO

- **Segments**
  - **필드:** id / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** name / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** query\_version / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** contacts\_count / **데이터 유형:** Integer / **지원되는 연산자:** N/A
  - **필드:** sample\_updated\_at / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** next\_sample\_update / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** created\_at / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** updated\_at / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** parent\_list\_id / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** status / **데이터 유형:** Struct / **지원되는 연산자:** N/A
  - **필드:** parent\_list\_ids / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO
  - **필드:** no\_parent\_list\_id / **데이터 유형:** 불 / **지원되는 연산자:** EQUAL\_TO

- **Contacts**
  - **필드:** id / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** first\_name / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** last\_name / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** unique\_name / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** 이메일 / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** alternate\_emails / **데이터 유형:** 나열 / **지원되는 연산자:** N/A
  - **필드:** address\_line\_1 / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** address\_line\_2 / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** city / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** state\_province\_region / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** country / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** postal\_code / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** phone\_number / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** whatsapp / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** line / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** facebook / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** list\_ids / **데이터 유형:** 나열 / **지원되는 연산자:** N/A
  - **필드:** custom\_fields / **데이터 유형:** Struct / **지원되는 연산자:** N/A
  - **필드:** created\_at / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** updated\_at / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** \_metadata / **데이터 유형:** Struct / **지원되는 연산자:** N/A
  - **필드:** event\_timestamp / **데이터 유형:** DateTime / **지원되는 연산자:** BETWEEN

- **범주**
  - **필드:** categories
  - **데이터 유형:** 나열
  - **지원되는 연산자:** N/A

- **Stats**
  - **필드:** date / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** stats / **데이터 유형:** 나열 / **지원되는 연산자:** N/A
  - **필드:** start\_date / **데이터 유형:** DateTime / **지원되는 연산자:** EQUAL\_TO, BETWEEN
  - **필드:** aggregated\_by / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO

- **Unsubscribe Groups**
  - **필드:** id / **데이터 유형:** Integer / **지원되는 연산자:** EQUAL\_TO
  - **필드:** name / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** 설명 / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음
  - **필드:** last\_email\_sent\_at / **데이터 유형:** Integer / **지원되는 연산자:** N/A
  - **필드:** is\_default / **데이터 유형:** 불 / **지원되는 연산자:** N/A
  - **필드:** unsubscribes / **데이터 유형:** Integer / **지원되는 연산자:** N/A



**참고**  
커넥터의 응답에서 Struct 및 List 데이터 유형은 String 데이터 유형으로 변환되며, DateTime 데이터 유형은 타임스탬프로 변환됩니다.

## 분할 쿼리
<a name="sendgrid-reading-partitioning-queries"></a>

SendGrid는 필터 기반 분할 또는 레코드 기반 분할을 지원하지 않습니다.