Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
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ì |
| 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à:
-
Squadra: https://docs.microsoft.com/en-us/graph/api/user-list-joinedteams?
view=graph-rest-1.0 -
Membro del team: -list-members? https://docs.microsoft.com/en-us/ graph/api/team view=graph-rest-1.0
-
Gruppo: -list? https://docs.microsoft.com/en-us/ graph/api/group view=graph-rest-1.0
-
Canale: -list? https://docs.microsoft.com/en-us/ graph/api/channel view=graph-rest-1.0
-
Channel-Tab: -list-tabs? https://docs.microsoft.com/en-us/ graph/api/channel view=graph-rest-1.0
-
Chat: -list? https://docs.microsoft.com/en-us/ graph/api/chat 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, Ora lastModifiedDate | DateTime |
| Eventi del calendario | createdDateTime, lastModifiedDate Ora, inizio originale | 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" }
