Lettura da entità Microsoft Teams
Prerequisiti
-
Un oggetto Microsoft Teams da cui si desidera leggere. Sarà necessario il nome dell'oggetto, ad esempio team o channel-message. Nella tabella seguente sono illustrate le entità supportate.
Entità supportate come origine
Tutte le entità sono supportate con l'API versione 1.0.
| Entità | Può essere Filtrato | Supporta Limite | Supporta Ordina per | Supporta Seleziona * | Supporta Partizionamento |
|---|---|---|---|---|---|
| Team | No | No | No | Sì | No |
| Membri del team | Sì | Sì | No | Sì | Sì |
| Groups (Gruppi) | Sì | Sì | Sì | Sì | Sì |
| Membri del gruppo | Sì | Sì | No | Sì | No |
| Canali | Sì | No | No | Sì | Sì |
| Messaggi del canale | No | Sì | No | Sì | No |
| Risposte ai messaggi del canale | No | Sì | No | Sì | No |
| Tabulazioni del canale | Sì | No | No | Sì | No |
| Chat | Sì | Sì | Sì | Sì | Sì |
| Eventi del calendario | Sì | Sì | Sì | Sì | Sì |
Esempio
MicrosoftTeams_read = glueContext.create_dynamic_frame.from_options( connection_type="MicrosoftTeams", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "company", "API_VERSION": "v1.0" }
Dettagli dell'entità e dei campi di Microsoft Teams
Elenco delle entità:
-
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
Query di partizionamento
Se si desidera utilizzare la simultaneità in Spark, possono essere fornite opzioni Spark PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND, NUM_PARTITIONS aggiuntive. Con questi parametri, la query originale viene suddivisa in NUM_PARTITIONS query secondarie che possono essere eseguite contemporaneamente dalle attività Spark.
-
PARTITION_FIELD: il nome del campo da utilizzare per partizionare la query. -
LOWER_BOUND: un valore limite inferiore inclusivo del campo di partizione scelto.Per la data, accettiamo il formato di data di Spark utilizzato nelle query di Spark SQL. Esempio di valori validi:
"2024-02-06". -
UPPER_BOUND: un valore limite superiore esclusivo del campo di partizione scelto. -
NUM_PARTITIONS: numero di partizioni.
I dettagli di supporto del campo di partizionamento per entità sono riportati nella tabella di seguito:
| Nome entità | Campi di partizionamento | Tipo di dati |
|---|---|---|
| Membri del team | visibleHistoryStartDateTime | DateTime |
| Gruppi | createdDateTime | DateTime |
| Canali | createdDateTime | DateTime |
| Chat | createdDateTime, lastModifiedDateTime | DateTime |
| Eventi del calendario | createdDateTime, lastModifiedDateTime, originalStart | DateTime |
Esempio
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" }
