google-apis-firestore_v1 0.99.0 → 0.101.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 105fc246a8747b12c36ffdce6e4f3d0e0abb22e127cfc0927255b00dcd6cecd4
-  data.tar.gz: 54690e9c6d59d2701ada7369a423542fe654d5a2e1d1de57082f886453d2f065
+  metadata.gz: 12a01ceb516312bce23f9f09340a64573527ab897c3408cb61c3154a11837174
+  data.tar.gz: b8fdf828a69d2dd84c9da527bf86c1c61a5d7ae2c829d59ff9211491e09dce72
 SHA512:
-  metadata.gz: 28c59d5d24e54cec597ca2be062c35fc85b22e373d407ffe15bbe3fc095c429b699905f48f637a391d9c8db604b4145468cbdd40c53b25ba7eba572154d0798f
-  data.tar.gz: 372ba5fca6ea073bb32e106f87e67c5b88a06d751850915f2a1605f8d82657e00dd419c4b632cfbebdd9ba85ebedb6946e5e05e455d46b1472cbd5edfca8862d
+  metadata.gz: 27e68ae264e2bd31bb83245237acd1a9d2c94bb82da617f127a1f27c8947d5257e48aab4d350b1b59db761c069ea8344c59fc96bc88e05b8f2a50d09e4a99b7c
+  data.tar.gz: 18203da751056ec0c3a968d02d6eb49a0966b4d0d390fd28810ad8e3ad7e2f82bb5d399342aa94c0deb2f5bbeef2e7609026e7380416c4f322d03cd7e6259c7f

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-firestore_v1
 
+### v0.101.0 (2026-10-04)
+
+* Regenerated from discovery document revision 20260928
+
+### v0.100.0 (2026-09-20)
+
+* Regenerated from discovery document revision 20260826
+
 ### v0.99.0 (2026-08-30)
 
 * Regenerated from discovery document revision 20260818

data/lib/google/apis/firestore_v1/classes.rb

@@ -2628,7 +2628,45 @@ module Google
         # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1SearchIndexOptions]
         attr_accessor :search_index_options
       
-        # Optional. The number of shards for the index.
+        # Optional. The number of physical shards for the index. In Cloud Firestore,
+        # data and index entries are stored in contiguous, ordered key ranges called
+        # splits. While document keys within a collection are hashed to distribute write
+        # traffic across splits, secondary index entries are ordered lexicographically
+        # by their indexed field values. When an index contains fields with sequential
+        # or monotonically increasing or decreasing values (such as timestamps or auto-
+        # incrementing IDs), every incoming index write targets the boundary of the
+        # index keyspace on a single split. Because sequential writes continuously
+        # advance to the newest split at the edge of the range, automatic load-based
+        # splitting cannot divide the write traffic across storage servers. Under high
+        # write rates, this concentration creates an append hotspot on that single split,
+        # resulting in elevated write latency, contention errors, and transaction
+        # aborts. Sharded indexes solve this write bottleneck by hash partitioning the
+        # secondary index keyspace. When `shard_count` is configured to N, Firestore
+        # automatically prepends a virtual computed shard field (with values from 0 to N-
+        # 1) as the leading field of the index. This splits a single sequential key
+        # range into N independent key ranges, uniformly scattering adjacent writes
+        # across distinct splits and storage servers to enable linear write scaling.
+        # Query trade-offs: Hash partitioning trades query performance for write
+        # throughput. Because matching index entries are scattered across all shards,
+        # queries executing against a sharded index cannot read from a single contiguous
+        # range. The query engine must fan out parallel seeks across all N shards and
+        # merge the ordered results. Even index point lookups and queries with `LIMIT 1`
+        # must seek across all N shards. Sizing and best practices: - Indexes cannot be
+        # updated in-place. `shard_count` is immutable once an index is created; to "
+        # reshard" an index, create a new index with the desired `shard_count` and
+        # delete the original index. - Use sharded indexes only for indexes experiencing
+        # write bottlenecks (typically exceeding 500-1,000 writes/sec) on sequential or
+        # timestamp fields. - Do not shard indexes on uniformly distributed fields (such
+        # as UUIDs or hash tokens), where writes naturally spread across splits without
+        # sharding. Sharding uniform indexes adds query overhead without improving write
+        # throughput. - Do not shard read-heavy or low-write collections. - Size `
+        # shard_count` based on expected peak write throughput. Because a single split
+        # sustains roughly 500-1,000 writes/sec on sequential keys, estimate `
+        # shard_count ≈ ceil(peak_write_qps / 500)`. - e.g., 4 for up to ~2,000-4,000
+        # writes/sec, 16 for up to ~10,000+ writes/sec. - Setting an excessively high
+        # shard count produces diminishing write returns while needlessly increasing
+        # read latency and seek costs. If <= 1, the index is unsharded (1 physical shard)
+        # .
         # Corresponds to the JSON property `shardCount`
         # @return [Fixnum]
         attr_accessor :shard_count
@@ -3249,7 +3287,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. Disables geoJSON indexing for the field. By default, geoJSON points
-        # are indexed.
+        # are indexed. Firestore GeoPoints are indexed regardless of the value of this
+        # field.
         # Corresponds to the JSON property `geoJsonIndexingDisabled`
         # @return [Boolean]
         attr_accessor :geo_json_indexing_disabled

data/lib/google/apis/firestore_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module FirestoreV1
       # Version of the google-apis-firestore_v1 gem
-      GEM_VERSION = "0.99.0"
+      GEM_VERSION = "0.101.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.19.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20260818"
+      REVISION = "20260928"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-firestore_v1
 version: !ruby/object:Gem::Version
-  version: 0.99.0
+  version: 0.101.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1/v0.99.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1/v0.101.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1
 rdoc_options: []
 require_paths: