從 Microsoft Teams 實體讀取

先決條件

• 您想要讀取的 Microsoft Teams 物件。您需要物件名稱，例如團隊或頻道訊息。下表顯示支援的實體。

Source 支援的實體

API 1.0 版支援所有實體。

實體	可以篩選	支援限制	支援 排序依據	支援選取 *	支援分割
團隊	否	否	否	是	否
團隊成員	是	是	否	是	是
群組	是	是	是	是	是
群組成員	是	是	否	是	否
頻道	是	否	否	是	是
頻道訊息	否	是	否	是	否
頻道訊息回應	否	是	否	是	否
頻道索引標籤	是	否	否	是	否
聊天	是	是	是	是	是
行事曆事件	是	是	是	是	是

範例

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：//https://docs.microsoft.com/en-us/graph/api/user-list-joinedteams?view=graph-rest-1.0

• 團隊成員：https：//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：//https://docs.microsoft.com/en-us/graph/api/group-list-members?view=graph-rest-1.0

• 頻道：https：//https://docs.microsoft.com/en-us/graph/api/channel-list?view=graph-rest-1.0

• Channel-Message：https：//https://docs.microsoft.com/en-us/graph/api/channel-list-messages?view=graph-rest-1.0

• Channel-Message-Reply：https：//https://docs.microsoft.com/en-us/graph/api/chatmessage-list-replies?view=graph-rest-1.0

• Channel-Tab：https：//https://docs.microsoft.com/en-us/graph/api/channel-list-tabs?view=graph-rest-1.0

• 聊天：https：//https://docs.microsoft.com/en-us/graph/api/chat-list?view=graph-rest-1.0

• 行事曆事件：https：//https://docs.microsoft.com/en-us/graph/api/group-list-events?view=graph-rest-1.0

分割查詢

如果您想要在 Spark 中使用並行PARTITION_FIELD，NUM_PARTITIONS可以提供其他的 Spark LOWER_BOUND選項 UPPER_BOUND、、。透過這些參數，原始查詢會分割為可由 Spark 任務同時執行的子查詢NUM_PARTITIONS數目。

• PARTITION_FIELD：用於分割查詢的欄位名稱。

• LOWER_BOUND：所選分割區欄位的包含下限值。

  對於日期，我們接受 Spark SQL 查詢中使用的 Spark 日期格式。有效值的範例："2024-02-06"。

• UPPER_BOUND：所選分割區欄位的專屬上限值。

• NUM_PARTITIONS：分割區數量。

下表擷取實體智慧分割欄位支援詳細資訊：

實體名稱	分割欄位	資料類型
團隊成員	visibleHistoryStartDateTime	DateTime
群組	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"
    }