샤드를 사용하는 동안 Firestore 문서 필드 증가
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
샤드를 사용하는 동안 Firestore 문서 필드 증가
더 살펴보기
이 코드 샘플이 포함된 자세한 문서는 다음을 참조하세요.
코드 샘플
C#
Firestore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다.
자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Firestore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다.
자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Firestore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다.
자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
PHP
Firestore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다.
자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Firestore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다.
자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Firestore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다.
자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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 document provides code samples for incrementing a Firestore document field using shards across multiple programming languages, including C#, Go, Node.js, PHP, Python, and Ruby.\u003c/p\u003e\n"],["\u003cp\u003eThe core concept demonstrated is incrementing a randomly selected shard's count by 1 using \u003ccode\u003eFieldValue.increment(1)\u003c/code\u003e or equivalent methods.\u003c/p\u003e\n"],["\u003cp\u003eEach code sample shows how to select a random shard within a designated collection to apply the increment operation, and requires Application Default Credentials to be set up for Firestore authentication.\u003c/p\u003e\n"],["\u003cp\u003eThe document references external documentation on distributed counters, explaining the use case and purpose of this pattern in Firestore.\u003c/p\u003e\n"],["\u003cp\u003eThe document also makes a reference to the google cloud sample browser, where you can search for more samples regarding google cloud products.\u003c/p\u003e\n"]]],[],null,["# Incrementing a Firestore document field while using shards\n\nExplore further\n---------------\n\n\nFor detailed documentation that includes this code sample, see the following:\n\n- [Distributed counters](https://firebase.google.com/docs/firestore/solutions/counters)\n- [Support frequent and distributed counters](/firestore/native/docs/solutions/counters)\n\nCode sample\n-----------\n\n### C#\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 /// \u003csummary\u003e\n /// Increment a randomly picked shard by 1.\n /// \u003c/summary\u003e\n /// \u003cparam name=\"docRef\"\u003eThe document reference \u003csee cref=\"DocumentReference\"/\u003e\u003c/param\u003e\n /// \u003creturns\u003eThe \u003csee cref=\"Task\"/\u003e\u003c/returns\u003e\n private static async Task IncrementCounterAsync(DocumentReference docRef, int numOfShards)\n {\n int documentId;\n lock (s_randLock)\n {\n documentId = s_rand.Next(numOfShards);\n }\n var shardRef = docRef.Collection(\"shards\").Document(documentId.ToString());\n await shardRef.UpdateAsync(\"count\", FieldValue.Increment(1));\n }\n\n### Go\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\n // incrementCounter increments a randomly picked shard.\n func (c *Counter) incrementCounter(ctx context.Context, docRef *firestore.DocumentRef) (*firestore.WriteResult, error) {\n \tdocID := strconv.Itoa(rand.Intn(c.numShards))\n\n \tshardRef := docRef.Collection(\"shards\").Doc(docID)\n \treturn shardRef.Update(ctx, []firestore.Update{\n \t\t{Path: \"Count\", Value: firestore.Increment(1)},\n \t})\n }\n\n### Node.js\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 function incrementCounter(docRef, numShards) {\n const shardId = Math.floor(Math.random() * numShards);\n const shardRef = docRef.collection('shards').doc(shardId.toString());\n return shardRef.set({count: FieldValue.increment(1)}, {merge: true});\n }\n\n### PHP\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 $ref = $db-\u003ecollection('samples/php/distributedCounters');\n $numShards = 0;\n $docCollection = $ref-\u003edocuments();\n foreach ($docCollection as $doc) {\n $numShards++;\n }\n $shardIdx = random_int(0, max(1, $numShards) - 1);\n $doc = $ref-\u003edocument((string) $shardIdx);\n $doc-\u003eupdate([\n ['path' =\u003e 'Cnt', 'value' =\u003e FieldValue::increment(1)]\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 def increment_counter(self, doc_ref):\n \"\"\"Increment a randomly picked shard.\"\"\"\n doc_id = random.randint(0, self._num_shards - 1)\n\n shard_ref = doc_ref.collection(\"shards\").document(str(doc_id))\n return shard_ref.update({\"count\": firestore.Increment(1)})\n\n### Ruby\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 # project_id = \"Your Google Cloud Project ID\"\n # num_shards = \"Number of shards for distributed counter\"\n # collection_path = \"shards\"\n\n require \"google/cloud/firestore\"\n\n firestore = Google::Cloud::https://cloud.google.com/ruby/docs/reference/google-cloud-firestore/latest/Google-Cloud-Firestore.html.https://cloud.google.com/ruby/docs/reference/google-cloud-firestore/latest/Google-Cloud-Firestore.html project_id: project_id\n\n # Select a shard of the counter at random\n shard_id = rand 0...num_shards\n shard_ref = firestore.doc \"#{collection_path}/#{shard_id}\"\n\n # increment counter\n shard_ref.update({ count: firestore.https://cloud.google.com/ruby/docs/reference/google-cloud-firestore/latest/Google-Cloud-Firestore-Client.html(1) })\n\n puts \"Counter incremented.\"\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)."]]