Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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" }
