Partitionne une requête en renvoyant des curseurs de partition pouvant être utilisés pour exécuter la requête en parallèle. Les curseurs de partition renvoyés sont des points de division qui peuvent être utilisés par documents.runQuery comme points de départ/d'arrivée pour les résultats de la requête.
Requête HTTP
POST https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*/documents}:partitionQuery
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
parent |
Obligatoire. Nom de la ressource parente. Format à respecter: |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "partitionCount": string, "pageToken": string, "pageSize": integer, // Union field |
Champs | |
---|---|
partitionCount |
Nombre maximal de points de partition souhaité. Les partitions peuvent être renvoyées sur plusieurs pages de résultats. Le nombre doit être positif. Le nombre réel de partitions renvoyées peut être inférieur. Par exemple, elle peut être définie sur un de moins que le nombre de requêtes parallèles à exécuter, ou, dans le cas de l'exécution d'un job de pipeline de données, sur un de moins que le nombre de nœuds de calcul ou d'instances de calcul disponibles. |
pageToken |
Valeur Par exemple, deux appels ultérieurs utilisant un pageToken peuvent renvoyer:
Pour obtenir un ensemble de résultats complet ordonné par rapport aux résultats de la requête fournie à documents.partitionQuery, vous devez fusionner les ensembles de résultats: curseur A, curseur B, curseur M, curseur Q, curseur U, curseur W |
pageSize |
Nombre maximal de partitions à renvoyer dans cet appel, sous réserve de Par exemple, si |
Champ d'union query_type . Requête à partitionner. query_type ne peut être qu'un des éléments suivants : |
|
structuredQuery |
Une requête structurée La requête doit spécifier une collection avec tous les descendants et être classée par ordre croissant de nom. Les autres filtres, tris, limites, décalages et curseurs de début/fin ne sont pas acceptés. |
Champ d'union consistency_selector . Mode de cohérence pour cette requête. Si ce champ n'est pas spécifié, la valeur par défaut est la cohérence forte. consistency_selector ne peut être qu'un des éléments suivants : |
|
readTime |
Lit les documents tels qu'ils étaient à l'époque. Il doit s'agir d'un horodatage de précision de l'ordre de la microseconde au cours de la dernière heure. Si la récupération à un moment précis est activée, il peut également s'agir d'un horodatage d'une minute entière datant des sept derniers jours. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
Corps de la réponse
Réponse pour Firestore.PartitionQuery
.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"partitions": [
{
object ( |
Champs | |
---|---|
partitions[] |
Partitionner les résultats. Chaque partition est un point de division qui peut être utilisé par documents.runQuery comme point de départ ou d'arrivée pour les résultats de la requête. Les requêtes documents.runQuery doivent être effectuées avec la même requête fournie à cette requête documents.partitionQuery. Les curseurs de partition seront classés dans le même ordre que les résultats de la requête fournie à documents.partitionQuery. Par exemple, si une requête documents.partitionQuery renvoie les curseurs de partition A et B, l'exécution des trois requêtes suivantes renvoie l'ensemble de résultats complet de la requête d'origine:
Un résultat vide peut indiquer que la requête a trop peu de résultats pour être partitionnée ou qu'elle n'est pas encore prise en charge pour le partitionnement. |
nextPageToken |
Jeton de page pouvant être utilisé pour demander un ensemble de résultats supplémentaire, jusqu'au nombre spécifié par |
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
Pour en savoir plus, consultez la page Présentation de l'authentification.