在事务中有条件地更新 Firestore 文档(异步)
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
在事务中有条件地更新 Firestore 文档(异步)。
深入探索
如需查看包含此代码示例的详细文档,请参阅以下内容:
代码示例
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],[],[[["\u003cp\u003eThis code sample demonstrates how to conditionally update a Firestore document within an asynchronous transaction.\u003c/p\u003e\n"],["\u003cp\u003eThe code utilizes the \u003ccode\u003e@firestore.async_transactional\u003c/code\u003e decorator to define the transaction logic.\u003c/p\u003e\n"],["\u003cp\u003eIt checks a condition based on the document's current data (population) before performing an update.\u003c/p\u003e\n"],["\u003cp\u003eThe transaction will update a city's population only if the population does not surpass a million.\u003c/p\u003e\n"],["\u003cp\u003eThe operation returns a boolean \u003ccode\u003eresult\u003c/code\u003e which is then used to communicate the success or failure of the population update.\u003c/p\u003e\n"]]],[],null,["# Conditionally updating a Firestore document in a transaction (async).\n\nExplore further\n---------------\n\n\nFor detailed documentation that includes this code sample, see the following:\n\n- [Transactions and batched writes](/firestore/native/docs/manage-data/transactions)\n- [Transactions and batched writes](https://firebase.google.com/docs/firestore/manage-data/transactions)\n\nCode sample\n-----------\n\n### Python\n\n\nTo authenticate to Firestore, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n transaction = db.transaction()\n city_ref = db.collection(\"cities\").document(\"SF\")\n\n @firestore.async_transactional\n async def update_in_transaction(transaction, city_ref):\n snapshot = await city_ref.get(transaction=transaction)\n new_population = snapshot.get(\"population\") + 1\n\n if new_population \u003c 1000000:\n transaction.update(city_ref, {\"population\": new_population})\n return True\n else:\n return False\n\n result = await update_in_transaction(transaction, city_ref)\n if result:\n print(\"Population updated\")\n else:\n print(\"Sorry! Population is too big.\")\n\nWhat's next\n-----------\n\n\nTo search and filter code samples for other Google Cloud products, see the\n[Google Cloud sample browser](/docs/samples?product=firestore)."]]