google-apis-firestore_v1 0.100.0 → 0.101.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1fead599ce1cf026ef2d00b7112b4c3da820a4d707df0f769df07fe53fcfc24
-  data.tar.gz: 1bfcaa09f08ed411bcec3745a1e53130c15a78f75d4fa3cf6e95d0b365853a7c
+  metadata.gz: 12a01ceb516312bce23f9f09340a64573527ab897c3408cb61c3154a11837174
+  data.tar.gz: b8fdf828a69d2dd84c9da527bf86c1c61a5d7ae2c829d59ff9211491e09dce72
 SHA512:
-  metadata.gz: 7651ddcde70802c50cf69f1527489cf2dcf5f180839e0f12e0b16854d37f0c41aaa63bbf8fff17805374430fc144fe7342a6fe6f3203b8bfbe5bfd65bea807c7
-  data.tar.gz: d9de0b293b319e46d86487dd1635bfda98a66d172328348048afc10087fef46ad84d4362db1e2a43b4421a1d32191da7b59468eebffffc6f158e9435d832f431
+  metadata.gz: 27e68ae264e2bd31bb83245237acd1a9d2c94bb82da617f127a1f27c8947d5257e48aab4d350b1b59db761c069ea8344c59fc96bc88e05b8f2a50d09e4a99b7c
+  data.tar.gz: 18203da751056ec0c3a968d02d6eb49a0966b4d0d390fd28810ad8e3ad7e2f82bb5d399342aa94c0deb2f5bbeef2e7609026e7380416c4f322d03cd7e6259c7f

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 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

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

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.100.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 = "20260826"
+      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.100.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.100.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: