Microsoft Teams 엔터티에서 읽기
사전 조건
-
읽으려는 Microsoft Teams 객체. 객체 이름(예: team 또는 channel-message)이 필요합니다. 다음 표에는 지원되는 엔터티가 나와 있습니다.
소스에 대해 지원되는 엔터티
모든 개체는 API 버전 1.0에서 지원됩니다.
| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select * 지원 | 분할 지원 |
|---|---|---|---|---|---|
| 팀 | 아니요 | 아니요 | 아니요 | 예 | 아니요 |
| Team Members | 예 | 예 | 아니요 | 예 | 예 |
| Groups | 예 | 예 | 예 | 예 | 예 |
| Group Member | 예 | 예 | 아니요 | 예 | 아니요 |
| 채널 | 예 | 아니요 | 아니요 | 예 | 예 |
| Channel Messages | 아니요 | 예 | 아니요 | 예 | 아니요 |
| Channel Message Replies | 아니요 | 예 | 아니요 | 예 | 아니요 |
| Channel Tabs | 예 | 아니요 | 아니요 | 예 | 아니요 |
| Chats | 예 | 예 | 예 | 예 | 예 |
| Calendar Events | 예 | 예 | 예 | 예 | 예 |
예제
MicrosoftTeams_read = glueContext.create_dynamic_frame.from_options( connection_type="MicrosoftTeams", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "company", "API_VERSION": "v1.0" }
Microsoft Teams 엔터티 및 필드 세부 정보
엔터티 목록:
-
Team: https://docs.microsoft.com/en-us/graph/api/user-list-joinedteams?view=graph-rest-1.0
-
Team-Member: https://docs.microsoft.com/en-us/graph/api/team-list-members?view=graph-rest-1.0
-
Group: https://docs.microsoft.com/en-us/graph/api/group-list?view=graph-rest-1.0
-
Group-Member: https://docs.microsoft.com/en-us/graph/api/group-list-members?view=graph-rest-1.0
-
Channel: https://docs.microsoft.com/en-us/graph/api/channel-list?view=graph-rest-1.0
-
Channel-Message: https://docs.microsoft.com/en-us/graph/api/channel-list-messages?view=graph-rest-1.0
-
Channel-Message-Reply: https://docs.microsoft.com/en-us/graph/api/chatmessage-list-replies?view=graph-rest-1.0
-
Channel-Tab: https://docs.microsoft.com/en-us/graph/api/channel-list-tabs?view=graph-rest-1.0
-
Chat: https://docs.microsoft.com/en-us/graph/api/chat-list?view=graph-rest-1.0
-
Calendar-Event: https://docs.microsoft.com/en-us/graph/api/group-list-events?view=graph-rest-1.0
분할 쿼리
Spark에서 동시성을 활용하려는 경우 추가 Spark 옵션(PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND, NUM_PARTITIONS)을 제공할 수 있습니다. 이러한 파라미터를 사용하면 Spark 태스크에서 동시에 실행할 수 있는 NUM_PARTITIONS개의 하위 쿼리로 원본 쿼리가 분할됩니다.
-
PARTITION_FIELD: 쿼리 분할에 사용할 필드의 이름입니다. -
LOWER_BOUND: 선택한 파티션 필드의 하한 값(경계 포함).날짜의 경우 Spark SQL 쿼리에 사용된 Spark 날짜 형식을 허용합니다. 유효한 값의 예제:
"2024-02-06". -
UPPER_BOUND: 선택한 파티션 필드의 상한 값(경계 제외). -
NUM_PARTITIONS: 파티션 수.
엔터티 수준 분할 필드 지원 세부 정보는 아래 표에 나와 있습니다.
| Entity Name | Partitioning Fields | 데이터 형식 |
|---|---|---|
| Team Members | visibleHistoryStartDateTime | DateTime |
| Groups | createdDateTime | DateTime |
| 채널 | createdDateTime | DateTime |
| Chats | createdDateTime, lastModifiedDateTime | DateTime |
| Calendar Events | createdDateTime, lastModifiedDateTime, originalStart | DateTime |
예제
microsoftteams_read = glueContext.create_dynamic_frame.from_options( connection_type="MicrosoftTeams", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "group", "API_VERSION": "v1.0", "PARTITION_FIELD": "createdDateTime" "LOWER_BOUND": "2022-07-13T07:55:27.065Z" "UPPER_BOUND": "2022-08-12T07:55:27.065Z" "NUM_PARTITIONS": "2" }