Funzioni e clausole OData supportate

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Questo articolo illustra come Analytics supporta diverse funzioni OData. Sono elencate anche le funzioni non supportate. OData (Open Data Protocol) è uno standard ISO/IEC approvato, OASIS che definisce le procedure consigliate per la compilazione e l'utilizzo delle API REST. Per altre informazioni, vedere la documentazione di OData.

Nota

Il servizio Analytics viene abilitato automaticamente e supportato nell'ambiente di produzione per tutti i Azure DevOps Services. L'integrazione di Power BI e l'accesso al feed OData del servizio Analisi sono disponibili a livello generale. Ti invitiamo a usarlo e a inviare commenti e suggerimenti. I dati disponibili dipendono dalla versione. La versione supportata più recente è v2.0e la versione di anteprima più recente è v4.0-preview. Per altre informazioni, vedere Controllo delle versioni delle API OData.

Clausole supportate

• $apply
• $compute
• $count
• $expand
• $filter
• $orderby
• $select
• $skip
• $top

Quando in una query vengono usate più clausole, vengono applicate nell'ordine specificato in precedenza. L'ordine delle clausole nella stringa di query viene ignorato. Nella query seguente, ad esempio, gli elementi di lavoro vengono prima raggruppati e aggregati. I gruppi vengono quindi filtrati. Successivamente, i gruppi filtrati vengono ordinati. Infine, vengono restituiti i primi cinque record. La query restituisce i primi cinque tipi di elementi di lavoro usati almeno 100 volte.

WorkItems?$filter=Count ge 100&$apply=groupby((WorkItemType), aggregate($count as Count))&$orderby=Count&top=5

Supporto delle estensioni di aggregazione

Accetta una sequenza di trasformazioni set, separate da barre per esprimere che vengono applicate consecutivamente. Il risultato di ogni trasformazione è l'input per la trasformazione successiva. Nella query seguente, ad esempio, gli elementi di lavoro vengono filtrati e quindi raggruppati per tipo e stato dell'elemento di lavoro. Successivamente, i gruppi vengono filtrati e raggruppati di nuovo.

Nota

Le estensioni di aggregazione OData sono relativamente nuove e non ancora completamente supportate da alcuni strumenti client.

Workitems?$apply=filter(State ne 'Closed')/groupby((WorkItemType, State), aggregate($count as Count))/filter(Count gt 100)/groupby((State),aggregate(Count with max as MaxCount))  

Sono supportate le trasformazioni seguenti:

Trasformazione	Note
aggregate	Consente l'aggregazione usando uno dei metodi $countseguenti, , averagemax, , minsum
compute	Consente di aggiungere proprietà calcolate
expand	Consente l'espansione in base alle proprietà specificate
filter	Consente di filtrare il set di input. Supporta le stesse espressioni di $filter
groupby	Consente il raggruppamento per proprietà

Per altre informazioni, vedere Aggregare i dati di rilevamento del lavoro.

Funzioni supportate

Funzione canonica	Descrizione
cast	Restituisce l'espressione del cast dell'istanza corrente al tipo specificato.
contains	Restituisce true se il secondo valore della stringa di parametro è una sottostringa del primo valore stringa del parametro. In caso contrario, restituisce false.
endswith	Restituisce true se il primo valore stringa del parametro termina con il secondo valore stringa di parametro, in caso contrario restituisce false.
startswith	Restituisce true se il primo valore stringa del parametro inizia con il secondo valore stringa di parametro, in caso contrario restituisce false.
length	Restituisce il numero di caratteri nel valore del parametro.
indexof	Restituisce la posizione del carattere in base zero della prima occorrenza del valore del secondo parametro nel primo valore del parametro o -1 se il secondo valore del parametro non si verifica nel primo valore del parametro.
substring	Restituisce una sottostringa del primo valore stringa del parametro, a partire dal carattere N e terminando con l'ultimo carattere (dove N è il secondo valore intero del parametro).
tolower	Restituisce il valore stringa del parametro di input con tutti i caratteri maiuscoli convertiti in minuscolo.
toupper	Restituisce il valore stringa del parametro di input con tutti i caratteri minuscoli convertiti in lettere maiuscole.
trim	Restituisce il valore stringa del parametro di input con tutti i caratteri di spazi vuoti iniziali e finali.
year	Restituisce il componente year del valore del parametro Date o DateTimeOffset.
month	Restituisce il componente month del valore del parametro Date o DateTimeOffset.
day	Restituisce il componente day del valore del parametro Date o DateTimeOffset.
date	Restituisce la parte date del valore del parametro DateTimeOffset.
time	Restituisce la parte relativa all'ora del valore del parametro DateTimeOffset.
totaloffsetminutes	Restituisce il numero di minuti con segno nella parte di offset del fuso orario del valore del parametro DateTimeOffset.
now	Restituisce il punto corrente nell'ora (data e ora con fuso orario) come valore DateTimeOffset.
maxdatetime	Restituisce l'ultimo punto nel tempo possibile come valore DateTimeOffset.
mindatetime	Restituisce il primo punto nel tempo possibile come valore DateTimeOffset.

Le funzioni OData vengono usate in una $filter clausola, ma non in una $select clausola nel modo in cui vengono usate in un'istruzione SQL.

Ad esempio, è possibile specificare:

/WorkItems?$filter=toupper(Title) eq 'HELP' 

Non è tuttavia possibile immettere la stringa seguente:

/WorkItems?$select=WorkItemId,State,toupper(Title)

Funzionalità non supportate

• bottomcount
• bottomsum
• bottompercent
• $crossjoin
• concat
• countdistinct
• from
• isdefined
• $rollup
• $search
• topcount
• topsum
• toppercent

Articoli correlati

• Eseguire query sui dati di rilevamento del lavoro
• Aggregare i dati
• Specifica OData v4.0
• OData v4.0 Part 2: URL Conventions Plus Errata 02
• Estensione di aggregazione OData v4.0