Lecture à partir d’entités Microsoft Teams
Prérequis
-
Un objet Microsoft Teams à partir duquel vous souhaitez lire. Vous aurez besoin du nom de l’objet, comme team ou channel-message. Le tableau suivant présente les entités prises en charge.
Entités prises en charge pour la source
Toutes les entités sont prises en charge par la version 1.0 de l’API.
| Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge* | Partitionnement pris en charge |
|---|---|---|---|---|---|
| Equipes | Non | Non | Non | Oui | Non |
| Team Members | Oui | Oui | Non | Oui | Oui |
| Groups (Groupes) | Oui | Oui | Oui | Oui | Oui |
| Group Members | Oui | Oui | Non | Oui | Non |
| Canaux | Oui | Non | Non | Oui | Oui |
| Channel Messages | Non | Oui | Non | Oui | Non |
| Channel Message Replies | Non | Oui | Non | Oui | Non |
| Channel Tabs | Oui | Non | Non | Oui | Non |
| Chats | Oui | Oui | Oui | Oui | Oui |
| Calendar Events | Oui | Oui | Oui | Oui | Oui |
Exemple
MicrosoftTeams_read = glueContext.create_dynamic_frame.from_options( connection_type="MicrosoftTeams", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "company", "API_VERSION": "v1.0" }
Détails des entités et des champs Microsoft Teams
Liste des entités :
-
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
Requêtes de partitionnement
Les options Spark supplémentaires PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND et NUM_PARTITIONS peuvent être indiquées si vous souhaitez utiliser la simultanéité dans Spark. Avec ces paramètres, la requête d’origine serait divisée en NUM_PARTITIONS nombres de sous-requêtes pouvant être exécutées simultanément par les tâches Spark.
-
PARTITION_FIELD: le nom du champ à utiliser pour partitionner la requête. -
LOWER_BOUND: une valeur limite inférieure inclusive du champ de partition choisi.Pour le champ Date, nous acceptons le format de date Spark utilisé dans les requêtes SQL Spark. Exemples de valeurs valides :
"2024-02-06". -
UPPER_BOUND: une valeur limite supérieure exclusive du champ de partition choisi. -
NUM_PARTITIONS: nombre de partitions.
Les détails relatifs à la prise en charge des champs de partitionnement par entité sont présentés dans le tableau ci-dessous :
| Nom de l’entité | Champs de partitionnement | Type de données |
|---|---|---|
| Team Members | visibleHistoryStartDateTime | DateTime |
| Groups (Groupes) | createdDateTime | DateTime |
| Canaux | createdDateTime | DateTime |
| Chats | createdDateTime, lastModifiedDateTime | DateTime |
| Calendar Events | createdDateTime, lastModifiedDateTime, originalStart | DateTime |
Exemple
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" }