Funciones y cláusulas de OData compatibles
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
En este artículo se explica cómo Analytics admite varias funciones de OData. También se enumeran las funciones no admitidas. OData (Open Data Protocol) es un estándar ISO/IEC aprobado, que define los procedimientos recomendados para compilar y consumir API REST. Para obtener más información, consulte la documentación de OData.
Nota:
El servicio Analytics se habilita automáticamente y se admite en producción para todos los servicios de Azure DevOps. La integración de Power BI y el acceso a la fuente OData del servicio Analytics están disponibles con carácter general. Le recomendamos que lo use y nos envíe sus comentarios.
Los datos disponibles dependen de la versión. La versión más reciente admitida es v2.0y la versión preliminar más reciente es v4.0-preview. Para obtener más información, consulte Control de versiones de la API de OData.
Nota:
El servicio Analytics se instala y admite automáticamente en producción para todas las colecciones de proyectos nuevas para Azure DevOps Server 2020 y versiones posteriores. La integración de Power BI y el acceso a la fuente OData del servicio Analytics están disponibles con carácter general. Le recomendamos que lo use y nos envíe sus comentarios. Si ha actualizado desde Azure DevOps Server 2019, puede instalar el servicio Analytics durante la actualización.
Los datos disponibles dependen de la versión. La versión más reciente admitida es v2.0y la versión preliminar más reciente es v4.0-preview. Para obtener más información, consulte Control de versiones de la API de OData.
Nota:
El servicio Analytics está en versión preliminar para Azure DevOps Server 2019. Puede habilitarlo o instalarlo para una colección de proyectos. La integración y el acceso de Power BI a la fuente OData del servicio Analytics se encuentran en versión preliminar. Le recomendamos que lo use y nos envíe sus comentarios.
Los datos disponibles dependen de la versión. La versión más reciente admitida es v2.0y la versión preliminar más reciente es v4.0-preview. Para obtener más información, consulte Control de versiones de la API de OData.
Cláusulas admitidas
$apply$compute$count$expand$filter$orderby$select$skip$top
Cuando se usan varias cláusulas en una consulta, se aplican en el orden especificado anteriormente. Se omite el orden de las cláusulas de la cadena de consulta. Por ejemplo, en la consulta siguiente, los elementos de trabajo se agrupan y agregan por primera vez. A continuación, se filtran los grupos. Después, los grupos filtrados se ordenan. Por último, se devuelven los cinco primeros registros. La consulta devuelve los cinco primeros tipos de elementos de trabajo usados al menos 100 veces.
WorkItems?$filter=Count ge 100&$apply=groupby((WorkItemType), aggregate($count as Count))&$orderby=Count&top=5
Compatibilidad con extensiones de agregación
Toma una secuencia de transformaciones de conjunto, separadas por barras diagonales para expresar que se aplican consecutivamente. El resultado de cada transformación es la entrada para la siguiente transformación. Por ejemplo, en la consulta siguiente, los elementos de trabajo se filtran y, a continuación, se agrupan por tipo de elemento de trabajo y estado. A continuación, los grupos se filtran y agrupan de nuevo.
Nota:
Las extensiones de agregación de OData son relativamente nuevas y aún no son totalmente compatibles con algunas herramientas de cliente.
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))
Se admiten las transformaciones siguientes:
| Transformación | Notas |
|---|---|
aggregate |
Permite la agregación mediante uno de los métodos $countsiguientes, , averagemax, , , minsum |
compute |
Permite agregar propiedades calculadas |
expand |
Permite la expansión por propiedades especificadas |
filter |
Permite filtrar el conjunto de entrada. Admite las mismas expresiones que $filter |
groupby |
Permite la agrupación por propiedades |
Para obtener más información, consulte Datos de seguimiento de trabajos agregados.
Funciones admitidas
| Función canónica | Descripción |
|---|---|
cast |
Devuelve la expresión de la instancia actual que se convierte en el tipo especificado. |
contains |
Devuelve true si el segundo valor de cadena de parámetro es una subcadena del primer valor de cadena de parámetro; de lo contrario, devuelve false. |
endswith |
Devuelve true si el primer valor de cadena de parámetro termina con el segundo valor de cadena de parámetro; de lo contrario, devuelve false. |
startswith |
Devuelve true si el primer valor de cadena de parámetro comienza con el segundo valor de cadena de parámetro; de lo contrario, devuelve false. |
length |
Devuelve el número de caracteres del valor del parámetro. |
indexof |
Devuelve la posición de carácter de base cero de la primera aparición del segundo valor de parámetro en el primer valor del parámetro o -1 si el segundo valor del parámetro no se produce en el primer valor de parámetro. |
substring |
Devuelve una subcadena del primer valor de cadena de parámetro, empezando por el carácter N y terminando en el último carácter (donde N es el segundo valor entero del parámetro). |
tolower |
Devuelve el valor de cadena del parámetro de entrada con todos los caracteres en mayúsculas convertidos en minúsculas. |
toupper |
Devuelve el valor de cadena del parámetro de entrada con todos los caracteres en minúsculas convertidos en mayúsculas. |
trim |
Devuelve el valor de cadena del parámetro de entrada con todos los caracteres de espacio en blanco iniciales y finales. |
year |
Devuelve el componente year del valor del parámetro Date o DateTimeOffset. |
month |
Devuelve el componente month del valor del parámetro Date o DateTimeOffset. |
day |
Devuelve el componente day del valor del parámetro Date o DateTimeOffset. |
date |
Devuelve la parte de fecha del valor del parámetro DateTimeOffset. |
time |
Devuelve la parte de hora del valor del parámetro DateTimeOffset. |
totaloffsetminutes |
Devuelve el número de minutos firmado en la parte de desplazamiento de zona horaria del valor del parámetro DateTimeOffset. |
now |
Devuelve el punto actual de hora (fecha y hora con zona horaria) como un valor DateTimeOffset. |
maxdatetime |
Devuelve el último momento posible en el tiempo como un valor DateTimeOffset. |
mindatetime |
Devuelve el punto más antiguo posible en el tiempo como un valor DateTimeOffset. |
Las funciones de OData se usan en una $filter cláusula , pero no en una $select cláusula de la manera en que se usarían en una instrucción SQL.
Por ejemplo, puede especificar:
/WorkItems?$filter=toupper(Title) eq 'HELP'
Sin embargo, no puede escribir la cadena siguiente:
/WorkItems?$select=WorkItemId,State,toupper(Title)
Características no admitidas
bottomcountbottomsumbottompercent$crossjoinconcatcountdistinctfromisdefined$rollup$searchtopcounttopsumtoppercent