Funciones y cláusulas de OData admitidas
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 por OASIS que define los procedimientos recomendados para compilar y consumir API REST. Para 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 Azure DevOps Services. 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 envíenos sus comentarios.
Los datos disponibles dependen de la versión. La versión más reciente admitida es v2.0
y la versión preliminar más reciente es v4.0-preview
. Para 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 envíenos 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.0
y la versión preliminar más reciente es v4.0-preview
. Para 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 de Power BI y el acceso a la fuente OData del servicio Analytics se encuentran en versión preliminar. Le recomendamos que lo use y envíenos sus comentarios.
Los datos disponibles dependen de la versión. La versión más reciente admitida es v2.0
y la versión preliminar más reciente es v4.0-preview
. Para 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 tipos de elementos de trabajo principales 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 de forma consecutiva. El resultado de cada transformación es la entrada a la siguiente transformación. Por ejemplo, en la consulta siguiente, los elementos de trabajo se filtran y, a continuación, se agrupan por tipo y estado de elemento de trabajo. A continuación, los grupos se filtran y se 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 siguientes transformaciones:
Transformación | Notas |
---|---|
aggregate |
Permite la agregación mediante uno de los métodos $count siguientes, , average max , , , min sum |
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 agregados de seguimiento del trabajo.
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 finaliza 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 con signo en la parte de desplazamiento de zona horaria del valor del parámetro DateTimeOffset. |
now |
Devuelve el punto actual en la hora (fecha y hora con zona horaria) como un valor DateTimeOffset. |
maxdatetime |
Devuelve el último punto 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 OData se usan en una $filter
cláusula , pero no en una $select
cláusula de la forma 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 siguiente cadena:
/WorkItems?$select=WorkItemId,State,toupper(Title)
Características no admitidas
bottomcount
bottomsum
bottompercent
$crossjoin
concat
countdistinct
from
isdefined
$rollup
$search
topcount
topsum
toppercent
Artículos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de