Lesen aus Microsoft-Teams-Entitäten
Voraussetzungen
-
Ein Microsoft-Teams-Objekt, aus dem Sie lesen möchten. Sie benötigen den Objektnamen wie „Team“ oder „Kanalnachricht“. Die folgende Tabelle zeigt die unterstützten Entitäten.
Unterstützte Entitäten für Quelle
Alle Entitäten werden mit API-Version 1.0 unterstützt.
| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „* auswählen“ | Unterstützt Partitionierung |
|---|---|---|---|---|---|
| Teams | Nein | Nein | Nein | Ja | Nein |
| Teammitglieder | Ja | Ja | Nein | Ja | Ja |
| Gruppen | Ja | Ja | Ja | Ja | Ja |
| Gruppenmitglieder | Ja | Ja | Nein | Ja | Nein |
| Kanäle | Ja | Nein | Nein | Ja | Ja |
| Kanalnachrichten | Nein | Ja | Nein | Ja | Nein |
| Antworten auf Kanalnachrichten | Nein | Ja | Nein | Ja | Nein |
| Kanal-Registerkarten | Ja | Nein | Nein | Ja | Nein |
| Chats | Ja | Ja | Ja | Ja | Ja |
| Kalenderereignisse | Ja | Ja | Ja | Ja | Ja |
Beispiel
MicrosoftTeams_read = glueContext.create_dynamic_frame.from_options( connection_type="MicrosoftTeams", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "company", "API_VERSION": "v1.0" }
Microsoft Teams-Entitäts- und -Felddetails
Liste der Entitäten:
-
Team: https://docs.microsoft.com/en-us/graph/api/user-list-joinedteams?view=graph-rest-1.0
-
Teammitglied: https://docs.microsoft.com/en-us/graph/api/team-list-members?view=graph-rest-1.0
-
Gruppe: https://docs.microsoft.com/en-us/graph/api/group-list?view=graph-rest-1.0
-
Gruppenmitglied: https://docs.microsoft.com/en-us/graph/api/group-list-members?view=graph-rest-1.0
-
Kanal: https://docs.microsoft.com/en-us/graph/api/channel-list?view=graph-rest-1.0
-
Kanalnachricht: https://docs.microsoft.com/en-us/graph/api/channel-list-messages?view=graph-rest-1.0
-
Antwort auf Kanalnachricht: https://docs.microsoft.com/en-us/graph/api/chatmessage-list-replies?view=graph-rest-1.0
-
Kanal-Registerkarte: 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
-
Kalenderereignis: https://docs.microsoft.com/en-us/graph/api/group-list-events?view=graph-rest-1.0
Partinionieren von Abfragen
Die zusätzlichen Spark-Optionen PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND und NUM_PARTITIONS können angegeben werden, wenn Sie Parallelität in Spark nutzen möchten. Mit diesen Parametern würde die ursprüngliche Abfrage in NUM_PARTITIONS Unterabfragen aufgeteilt, die von Spark-Aufgaben gleichzeitig ausgeführt werden können.
-
PARTITION_FIELD: der Name des Feldes, das zur Partitionierung der Abfrage verwendet werden soll. -
LOWER_BOUND: ein inklusiver Untergrenzwert des ausgewählten Partitionsfelds.Als Datum akzeptieren wir das Spark-Datumsformat, das in Spark-SQL-Abfragen verwendet wird. Beispiel für gültige Werte:
"2024-02-06". -
UPPER_BOUND: ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds. -
NUM_PARTITIONS: Anzahl der Partitionen.
Details zur Unterstützung von Feldern für die entitätsbezogene Partitionierung sind in der folgenden Tabelle aufgeführt.
| Entity Name | Partitionierung von Feldern | Datentyp |
|---|---|---|
| Teammitglieder | visibleHistoryStartDateTime | DateTime |
| Gruppen | createdDateTime | DateTime |
| Kanäle | createdDateTime | DateTime |
| Chats | createdDateTime, lastModifiedDateTime | DateTime |
| Kalenderereignisse | createdDateTime, lastModifiedDateTime, originalStart | DateTime |
Beispiel
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" }
