Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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" }