建立 Firestore 資料分割計數器
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
建立 Firestore 資料分割計數器
深入探索
如需包含這個程式碼範例的詳細說明文件,請參閱下列內容:
程式碼範例
PHP
如要向 Firestore 進行驗證,請設定應用程式預設憑證。
詳情請參閱「為本機開發環境設定驗證」。
Python
如要向 Firestore 進行驗證,請設定應用程式預設憑證。
詳情請參閱「為本機開發環境設定驗證」。
Ruby
如要向 Firestore 進行驗證,請設定應用程式預設憑證。
詳情請參閱「為本機開發環境設定驗證」。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。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 content demonstrates how to create a sharded counter in Firestore, which is useful for high-frequency counter updates.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code samples initialize a specified number of shards, each with a \u003ccode\u003eCount\u003c/code\u003e of 0, within a subcollection of a Firestore document.\u003c/p\u003e\n"],["\u003cp\u003eCode examples are available in C#, Go, PHP, Python, and Ruby, showcasing implementation across multiple programming languages.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication to Firestore requires setting up Application Default Credentials, with a link provided for detailed instructions.\u003c/p\u003e\n"],["\u003cp\u003eFor further exploration, there are links to detailed documentation on distributed counters and a browser to see code samples for other google cloud services.\u003c/p\u003e\n"]]],[],null,["# Create a Firestore sharded counter\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 /// Create a given number of shards as a\n /// subcollection of specified document.\n /// \u003c/summary\u003e\n /// \u003cparam name=\"docRef\"\u003eThe document reference \u003csee cref=\"DocumentReference\"/\u003e\u003c/param\u003e\n private static async Task CreateCounterAsync(DocumentReference docRef, int numOfShards)\n {\n CollectionReference colRef = docRef.Collection(\"shards\");\n var tasks = new List\u003cTask\u003e();\n // Initialize each shard with Count=0\n for (var i = 0; i \u003c numOfShards; i++)\n {\n tasks.Add(colRef.Document(i.ToString()).SetAsync(new Shard() { Count = 0 }));\n }\n await Task.WhenAll(tasks);\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 // initCounter creates a given number of shards as\n // subcollection of specified document.\n func (c *Counter) initCounter(ctx context.Context, docRef *firestore.DocumentRef) error {\n \tcolRef := docRef.Collection(\"shards\")\n\n \t// Initialize each shard with count=0\n \tfor num := 0; num \u003c c.numShards; num++ {\n \t\tshard := Shard{0}\n\n \t\tif _, err := colRef.Doc(strconv.Itoa(num)).Set(ctx, shard); err != nil {\n \t\t\treturn fmt.Errorf(\"Set: %w\", err)\n \t\t}\n \t}\n \treturn nil\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 $numShards = 10;\n $ref = $db-\u003ecollection('samples/php/distributedCounters');\n for ($i = 0; $i \u003c $numShards; $i++) {\n $doc = $ref-\u003edocument((string) $i);\n $doc-\u003eset(['Cnt' =\u003e 0]);\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 init_counter(self, doc_ref):\n \"\"\"\n Create a given number of shards as\n subcollection of specified document.\n \"\"\"\n col_ref = doc_ref.collection(\"shards\")\n\n # Initialize each shard with count=0\n for num in range(self._num_shards):\n shard = Shard()\n col_ref.document(str(num)).set(shard.to_dict())\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 shards_ref = firestore.col collection_path\n\n # Initialize each shard with count=0\n num_shards.times do |i|\n shards_ref.doc(i).set({ count: 0 })\n end\n\n puts \"Distributed counter shards collection created.\"\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)."]]