從 Microsoft Teams 實體中讀取
先決條件
-
您想要從中進行讀取的 Microsoft Teams 物件。將需要物件名稱，例如團隊或頻道訊息。下表顯示支援的實體。
來源的支援實體
API 1.0 版支援所有實體。
| 實體 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 * | 支援分區 |
|---|---|---|---|---|---|
| 團隊 | 否 | 否 | 否 | 是 | 否 |
| 團隊成員 | 是 | 是 | 否 | 是 | 是 |
| Groups (群組) | 是 | 是 | 是 | 是 | 是 |
| 群組成員 | 是 | 是 | 否 | 是 | 否 |
| 頻道 | 是 | 否 | 否 | 是 | 是 |
| 頻道訊息 | 否 | 是 | 否 | 是 | 否 |
| 頻道訊息回覆 | 否 | 是 | 否 | 是 | 否 |
| 頻道標籤 | 是 | 否 | 否 | 是 | 否 |
| 聊天 | 是 | 是 | 是 | 是 | 是 |
| 行事曆事件 | 是 | 是 | 是 | 是 | 是 |
範例
MicrosoftTeams_read = glueContext.create_dynamic_frame.from_options( connection_type="MicrosoftTeams", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "company", "API_VERSION": "v1.0" }
Microsoft Teams 實體和欄位詳細資訊
實體清單：
-
團隊：https://docs.microsoft.com/en-us/graph/api/user-list-joinedteams?view=graph-rest-1.0
-
團隊成員：https://docs.microsoft.com/en-us/graph/api/team-list-members?view=graph-rest-1.0
-
群組：https://docs.microsoft.com/en-us/graph/api/group-list?view=graph-rest-1.0
-
群組成員：https://docs.microsoft.com/en-us/graph/api/group-list-members?view=graph-rest-1.0
-
頻道：https://docs.microsoft.com/en-us/graph/api/channel-list?view=graph-rest-1.0
-
頻道訊息：https://docs.microsoft.com/en-us/graph/api/channel-list-messages?view=graph-rest-1.0
-
頻道訊息回覆：https://docs.microsoft.com/en-us/graph/api/chatmessage-list-replies?view=graph-rest-1.0
-
頻道標籤：https://docs.microsoft.com/en-us/graph/api/channel-list-tabs?view=graph-rest-1.0
-
聊天：https://docs.microsoft.com/en-us/graph/api/chat-list?view=graph-rest-1.0
-
行事曆事件：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：分區數目。
實體分區欄位支援詳細資訊如下表所示：
| 實體名稱 | 分區欄位 | 資料類型 |
|---|---|---|
| 團隊成員 | visibleHistoryStartDateTime | DateTime |
| Groups (群組) | createdDateTime | DateTime |
| 頻道 | createdDateTime | DateTime |
| 聊天 | createdDateTime、lastModifiedDateTime | DateTime |
| 行事曆事件 | 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" }
