parquet store-gateways: open labels file from bucket with flag (#12091)

<!--  Thanks for sending a pull request!  Before submitting:

1. Read our CONTRIBUTING.md guide
2. Rebase your PR if it gets out of sync with main
-->

#### What this PR does
```
-blocks-storage.bucket-store.parquet-load-index-to-disk
    	True to download the Parquet labels file to disk before opening it. False to open it directly from the bucket. (default true)
```


#### Which issue(s) this PR fixes or relates to

Fixes #<issue number>

#### Checklist

- [ ] Tests updated.
- [ ] Documentation added.
- [ ] `CHANGELOG.md` updated - the order of entries should be
`[CHANGE]`, `[FEATURE]`, `[ENHANCEMENT]`, `[BUGFIX]`. If changelog entry
is not needed, please add the `changelog-not-needed` label to the PR.
- [ ]
[`about-versioning.md`](https://github.com/grafana/mimir/blob/main/docs/sources/mimir/configure/about-versioning.md)
updated with experimental features.

Author: francoposa

cmd/mimir/config-descriptor.json

@@ -10173,6 +10173,17 @@
               "fieldType": "float",
               "fieldCategory": "advanced"
             },
+            {
+              "kind": "field",
+              "name": "parquet_load_index_to_disk",
+              "required": false,
+              "desc": "True to download the Parquet labels file to disk before opening it. False to open it directly from the bucket.",
+              "fieldValue": null,
+              "fieldDefaultValue": true,
+              "fieldFlag": "blocks-storage.bucket-store.parquet-load-index-to-disk",
+              "fieldType": "boolean",
+              "fieldCategory": "advanced"
+            },
             {
               "kind": "field",
               "name": "parquet_max_row_count",

cmd/mimir/help-all.txt.tmpl

@@ -609,6 +609,8 @@ Usage of ./cmd/mimir/mimir:
     	How long to cache list of blocks for each tenant. (default 5m0s)
   -blocks-storage.bucket-store.metadata-cache.tenants-list-ttl duration
     	How long to cache list of tenants in the bucket. (default 15m0s)
+  -blocks-storage.bucket-store.parquet-load-index-to-disk
+    	True to download the Parquet labels file to disk before opening it. False to open it directly from the bucket. (default true)
   -blocks-storage.bucket-store.parquet-max-chunk-size-bytes uint
     	Maximum size in bytes that can be fetched from the parquet chunks file. If the size exceeds this value the query will stop with limit error.
   -blocks-storage.bucket-store.parquet-max-data-size-bytes uint

development/mimir-microservices-mode/docker-compose.jsonnet

@@ -38,6 +38,8 @@ std.manifestYamlDoc({
 
     // If true, start parquet-converter
     enable_parquet: false,
+    // If true, emulate classic store-gateway behavior by loading the Parquet labels file to disk
+    parquet_store_gateway_load_index_to_disk: false,
   },
 
   // We explicitely list all important services here, so that it's easy to disable them by commenting out.
@@ -176,14 +178,20 @@ std.manifestYamlDoc({
     for id in std.range(1, count)
   },
 
+  local extraStoreGatewayArgs = std.join(
+    ' ', [
+      (if $._config.enable_parquet then '-log.level=debug -store-gateway.parquet-enabled=true' else null),
+      (if ($._config.enable_parquet && !$._config.parquet_store_gateway_load_index_to_disk) then '-blocks-storage.bucket-store.parquet-load-index-to-disk=false' else null),
+    ]
+  ),
+
   store_gateways(count):: {
     ['store-gateway-%d' % id]: mimirService({
       name: 'store-gateway-' + id,
       target: 'store-gateway',
       httpPort: 8010 + id,
       jaegerApp: 'store-gateway-%d' % id,
-      extraArguments:
-        if $._config.enable_parquet then '-store-gateway.parquet-enabled=true' else '',
+      extraArguments: extraStoreGatewayArgs,
     })
     for id in std.range(1, count)
   },

docs/sources/mimir/configure/configuration-parameters/index.md

@@ -4894,6 +4894,11 @@ bucket_store:
   # CLI flag: -blocks-storage.bucket-store.series-fetch-preference
   [series_fetch_preference: <float> | default = 0.75]
 
+  # (advanced) True to download the Parquet labels file to disk before opening
+  # it. False to open it directly from the bucket.
+  # CLI flag: -blocks-storage.bucket-store.parquet-load-index-to-disk
+  [parquet_load_index_to_disk: <boolean> | default = true]
+
   # (advanced) Maximum number of rows in a parquet file. If the number of rows
   # exceeds this value the query will stop with limit error.
   # CLI flag: -blocks-storage.bucket-store.parquet-max-row-count