Límite de nodo
Para pasar una validación de modelo, todos los llamados a la API de GraphQL deben cumplir con estos estándares:
- Los clientes deben suministrar un argumento
first
olast
en cualquier conexión. - Los valores de
first
ylast
deben estar dentro de 1-100. - Las llamadas individuales no pueden solicitar más de 500,000 nodos en total.
Calcular los nodos en una llamada
Estos dos ejemplos te muestran cómo calcular los nodos totales en una llamada.
-
Consulta simple:
query { viewer { repositories(first: 50) { edges { repository:node { name issues(first: 10) { totalCount edges { node { title bodyHTML } } } } } } } }
Cálculo:
50 = 50 repositories + 50 x 10 = 500 repository issues = 550 total nodes
-
Consulta compleja:
query { viewer { repositories(first: 50) { edges { repository:node { name pullRequests(first: 20) { edges { pullRequest:node { title comments(first: 10) { edges { comment:node { bodyHTML } } } } } } issues(first: 20) { totalCount edges { issue:node { title bodyHTML comments(first: 10) { edges { comment:node { bodyHTML } } } } } } } } } followers(first: 10) { edges { follower:node { login } } } } }
Cálculo:
50 = 50 repositories + 50 x 20 = 1,000 pullRequests + 50 x 20 x 10 = 10,000 pullRequest comments + 50 x 20 = 1,000 issues + 50 x 20 x 10 = 10,000 issue comments + 10 = 10 followers = 22,060 total nodes
Limite de tasa
El límite de la API de GraphQL es diferente de los límites de tasa de la API de REST.
¿Por qué son diferentes los límites de tasa de la API? Con GraphQL, una llamada de GraphQL puede reemplazar varias llamadas de REST. Una sola llamada compleja de GraphQL puede ser el equivalente a miles de solicitudes de REST. Si bien una sola llamada de GraphQL caería muy debajo del límite de tasa de la API de REST, la consulta podría ser igual de cara en términos de procesamiento para los servidores de GitHub.
Para representar con precisión el costo de servidor de una consulta, la API de GraphQL calcula la puntuación del límite de tasa de un llamado con base en la escala de puntos normalizada. Los factores de puntuación de una consulta en argumentos "firs" y "last" en una conexión padre y sus hijos.
- La fórmula utiliza los argumentos
first
ylast
en una conexión padre y en sus hijos para pre-calcular la carga potencial en los sistemas de GitHub, tal como MySQL, ElasticSearch y Git. - Cada conexión nueva tiene su propio valor de puntos. Los puntos se combinan con otros puntos desde la llamada en una puntuación de tasa límite general.
El límite de tasa de la API de GraphQL es de 5000 puntos por hora.
Toma en cuenta que 5000 puntos por hora no es lo mismo que 5000 llamados por hora: la API de GraphQL y la de REST utilizan límites de tasa diferentes.
Nota: La fórmula y límite de tasa actuales están sujetos a cambios conforme observamos cómo los desarrolladores utilizan la API de GraphQL.
Recuperar el estado de límite de tasa de una llamada
Con la API de REST, puedes obtener el estado del límite de tasa si inspeccionas los encabezados HTTP devueltos.
Con la API de GraphQL, puedes verificar el estado de límite de tasa consultando campos en el objeto rateLimit
:
query {
viewer {
login
}
rateLimit {
limit
cost
remaining
resetAt
}
}
-
El campo
limit
devuelve el número máximo de puntos que se permite consumir al cliente en una ventana de 60 minutos. -
El campo
cost
devuelve el costo en puntos para la llamada actual que cuenta contra el límite de tasa. -
El campo
remaining
devuelve la cantidad de puntos restantes en la ventana de límite de tasa actual.) -
EL campo
resetAt
devuelve la hora en la que se reinicia la ventana de límite de tasa actual en segundos de satélite UTC.
Calcular el puntaje de límite de tasa antes de ejecutar la llamada
Al consultar el objeto rateLimit
se devuelve el puntaje de una llamada, pero ejecutar la llamada tiene un costo en el límite. Para evitar este dilema, puedes calcular el puntaje de una llamada antes de ejecutarla. Los siguientes cálculos funcionan casi de la misma manera que lo que devuelve rateLimit { cost }
.
- Agrega la cantidad de solicitudes requeridas para completar cada conexión única en la llamada. Asume que cada solicitud alcanzará los límites de los argumentos
first
olast
. - Divide la cantidad entre 100 y redondea el resultado para obtener el costo final agregado. Este paso normaliza las cantidades grandes.
Nota: El costo mínimo de un llamado a la API de GraphQL es 1, lo que representa una sola solicitud.
Aquí se muestra una consulta y cálculo de puntaje de ejemplo:
query {
viewer {
login
repositories(first: 100) {
edges {
node {
id
issues(first: 50) {
edges {
node {
id
labels(first: 60) {
edges {
node {
id
name
}
}
}
}
}
}
}
}
}
}
}
Esta consulta requiere de 5,101 solicitudes para completarse:
- Aunque se devolvieron 100 repositorios, la API se tiene que conectar a la cuenta del visualizador una vez para obtener la lista de repositorios. Así que, las solicitudes de repositorios = 1
- Aunque estámos obteniendo 50 informes de problemas de vuelta, la API tiene que conectarse a cada uno de los 100 repositorios para obtener la lista de informes de problemas. Así que, las solicitudes de informes de problemas = 100
- Aunque estamos obteniendo 60 etiquetas de vuelta, la API se tiene que conectar a cada uno de los 5,000 informes de problemas potenciales totales para obtener la lista de etiquetas. Así que, las solicitudes de etiquetas = 5,000
- Total = 5,101
Si lo dividimos entre 100 y lo redondeamos, obtenemos el puntaje final de la consulta: 51