Cette page décrit les requêtes d'écriture par lot Spanner et vous explique comment les utiliser modifier vos données Spanner.
Vous pouvez utiliser l'écriture par lot Spanner pour insérer, mettre à jour ou supprimer plusieurs lignes dans vos tables Spanner. Spanner l'écriture par lot accepte les écritures à faible latence sans opération de lecture, et renvoie à mesure que les mutations sont appliquées par lot. Pour utiliser l'écriture par lot, vous regroupez mutations associées, et validation de toutes les mutations d'un groupe de manière atomique. Les mutations entre les groupes sont appliquées dans un ordre non spécifié et sont indépendants les uns des autres (non atomiques). Spanner n'a pas besoin d'attendre l'application de toutes les mutations avant d'envoyer une réponse. Autrement dit, cette écriture par lot autorise un échec partiel. Vous pouvez aussi exécuter plusieurs les écritures à la fois. Pour en savoir plus, consultez la section Utiliser l'écriture par lot.
Cas d'utilisation
L'écriture par lot Spanner est particulièrement utile si vous souhaitez valider un grand nombre d'écritures sans opération de lecture, mais ne nécessitent pas pour toutes vos mutations.
Si vous souhaitez traiter vos requêtes LMD par lot, utilisez le traitement LMD par lot. pour modifier vos données Spanner. Pour en savoir plus sur les différences entre le LMD et les mutations, consultez la page Comparer le LMD et les mutations.
Pour les requêtes de mutation unique, nous vous recommandons d'utiliser un verrouillage en lecture/écriture transaction.
Limites
L'écriture par lot Spanner présente les limites suivantes:
L'écriture par lot Spanner n'est pas disponible avec la console Google Cloud ou Google Cloud CLI. Il n'est disponible qu'avec REST et RPC. et la bibliothèque cliente Java Spanner.
Protection contre la relecture n'est pas compatible avec l'écriture par lot. Il est possible que les mutations soient appliquée plusieurs fois, et une mutation appliquée plusieurs fois peut peut entraîner une défaillance. Par exemple, si vous relancez une mutation d'insertion, une erreur existe déjà, ou si vous utilisez des valeurs générées ou validées clés basées sur l'horodatage dans la mutation, des lignes supplémentaires peuvent être ajoutées ajoutés au tableau. Nous vous recommandons de structurer vos écritures de façon à ce qu'elles soient idempotentes pour éviter ce problème.
Vous ne pouvez pas effectuer un rollback d'une requête d'écriture par lot terminée. Vous pouvez annuler une requête d'écriture par lot en cours. Si vous annulez une écriture par lot en cours, les mutations des groupes non terminés font l'objet d'un rollback. Mutations dans les groupes terminés sont validés dans la base de données.
La taille maximale d'une requête d'écriture par lot est identique à la limite d'un fichier commit de la requête. Pour en savoir plus, consultez Limites de création, de lecture, de mise à jour et de suppression de données.
Utiliser l'écriture par lot
Pour utiliser l'écriture par lot, vous devez disposer de l'autorisation spanner.databases.write
sur
la base de données à modifier. Vous pouvez écrire des mutations par lot
de manière non atomique dans un seul appel à l'aide d'un objet REST ;
ou API RPC
.
Vous devez regrouper les types de mutations suivants lorsque vous utilisez l'écriture par lot:
- Insérer des lignes avec le même préfixe de clé primaire dans les éléments parent et enfant tableaux.
- Insérer des lignes dans des tableaux avec une relation de clé étrangère entre les tableaux
- Autres types de mutations associées en fonction du schéma de votre base de données et logique d'application.
Vous pouvez également effectuer une écriture par lot à l'aide de la bibliothèque cliente Java Spanner.
L'exemple de code suivant met à jour la table Singers
avec de nouvelles lignes.
Java
Étape suivante
- En savoir plus sur les transactions Spanner.