Créer un compteur segmenté Firestore
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Créer un compteur segmenté Firestore
En savoir plus
Pour obtenir une documentation détaillée incluant cet exemple de code, consultez les articles suivants :
Exemple de code
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","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)."]]