Microsoft DataverseInformació general dels límits de l’API

Nota

Vigent a partir del novembre de 2020:

  • S’ha canviat el nom del Common Data Service per Microsoft Dataverse. Més informació
  • S’han actualitzat alguns termes del Microsoft Dataverse. Per exemple, ara entitat s’anomena taula, i el camp ha passat a anomenar-se columna. Més informació

Aquest article s’actualitzarà pròximament per reflectir la terminologia més recent.

Els límits de l'API del Dataverse ajuden a garantir el nivell de servei, la disponibilitat i la qualitat. Els límits de l'API del Dataverse formen part del límit de sol·licituds i assignacions del Power Platform. En aquest article s'introduiran els límits específics per al Dataverse aplicables per a les aplicacions del Power Apps, el Power Automate i les aplicacions d'interacció amb el client (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing i Dynamics 365 Project Service Automation) que connecten al Dataverse.

Per obtenir informació sobre els límits de totes les àrees al Power Platform, vegeu Límits i assignacions de sol·licituds del Power Platform.

Hi ha dues categories de límits que s'apliquen al Dataverse: límits de Dret i Protecció de servei.

Límits de dret

Aquests límits representen el nombre de sol·licituds que els usuaris tenen dret a fer cada dia. El límit assignat depèn del tipus de llicència assignada a cada usuari.

Si qualsevol usuari supera el dret de sol·licituds, l'administrador rebria una notificació i podria assignar capacitat de sol·licituds del Power Apps i el Power Automate a aquest usuari. No es bloquejarà l'ús dels usuaris de les aplicacions per a superacions puntuals i raonables en aquest moment.

Per a les sol·licituds de l'API del Dataverse, incloeu totes les operacions de dades que interactuen amb les files de taula on es creen, recuperen, actualitzen o suprimeixen les files (CRUD). Les operacions especials, com ara comparteix i assigna, s'inclouen perquè es consideren actualitzacions. Aquestes sol·licituds poden ser de qualsevol client o aplicació i utilitzar qualsevol extrem. Aquests inclouen, però no es limiten a, operacions realitzades per complements, fluxos de treball asíncrons, controls personalitzats i operacions $batch (ExecuteMultiple). Hi ha un conjunt petit d'operacions internes del sistema que queden excloses de límits, com ara l'inici de sessió, el tancament de sessió i les operacions de metadades del sistema.

Important

Power Platform Les assignacions de sol·licituds d'API inclouen l'ús de Power Automate, i les API del AI Builder connector. Totes les sol·licituds per mitjà d'un connector que resultin en una sol·licitud del Dataverse representaran 1 sol·licitud del Power Platform.

Per obtenir més informació sobre aquests límits de dret, Assignacions de sol·licituds del Microsoft Power Platform basades en llicències.

Per obtenir informació sobre la visualització i l'assignació de complements de capacitat, vegeu Complements de capacitat.

Per obtenir informació sobre la compra de complements de capacitat individuals, consulteu la Guia de llicències del Power Apps i el Power Automate.

Límits de protecció de servei

Per garantir la disponibilitat i el rendiment coherents per a tothom, apliquem alguns límits sobre com s'utilitzen les API amb el Dataverse. Els límits de l'API de protecció de servei ajuden a garantir que els usuaris que executen aplicacions no puguin interferir-se els uns amb els altres basant-se en restriccions de recursos. Els límits no afectaran els usuaris normals de la plataforma. Només es veuran afectades les aplicacions que realitzen un gran nombre de sol·licituds d'API. Els límits ajudaran a proporcionar un nivell de protecció en cas d'increments sobtats i aleatoris del volum de sol·licituds que amenacen la disponibilitat i les característiques de rendiment de la plataforma del Dataverse.

Limitem el nombre de connexions simultànies per compte d'usuari, el nombre de sol·licituds d'API per connexió i la quantitat de temps d'execució que es pot utilitzar per a cada connexió. S'avaluen dins d'una finestra lliscant de cinc minuts. Quan s'excedeix un d'aquests límits, la plataforma generarà una excepció.

Nota

Els límits de protecció del servei s'apliquen a totes les sol·licituds del servei web extern, no només a les operacions CRUD de taules comptades amb els límits a què es té dret.

Els límits de l'API de protecció de servei no s'apliquen a les trucades de l'API fetes dins de fluxos de treball, activitats de flux de treball personalitzades o codi de complements. Aquestes operacions s'invoquen internament.

Com que els límits de protecció de servei normalment només es troben en aplicacions que realitzen un volum elevat d'operacions de dades, recomanem que els desenvolupadors que creen aquestes aplicacions apliquin patrons per tornar a intentar operacions després d'un període de temps quan es retornin aquestes excepcions. Això permetrà a l'aplicació respondre a les excepcions que el servei envia i reduir el nombre total de sol·licituds i aconseguir el rendiment màxim possible.

Per obtenir informació sobre els errors específics que es poden retornar i com els desenvolupadors poden aplicar patrons per respondre a aquests errors, vegeu Límits de l'API de protecció de servei.

Consulteu també

Administrar el Power Platform/Llicències i administració de llicències/Límits de sol·licituds i assignacions
Desenvolupador/Treballar amb dades mitjançant codi/Límits de l'API de protecció de servei