microsoft / microsoft/AzureStorageExplorer
Parquet preview fails in 1.43.0 with missing option: typeLength (required for FIXED_LEN_BYTE_ARRAY) (worked in 1.41.1)
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 452
- Forks
- 92
- Avg merge
- 15h 20m
- Merged PRs (30d)
- 3
Description
Storage Explorer Version
1.43.0
Regression From
1.41.1
Architecture
x64
Storage Explorer Build Number
20260407.6
Platform
Windows
OS Version
Windows 11
Bug Description
After upgrading Azure Storage Explorer from 1.41.1 to 1.43.0, Parquet files that previously opened successfully in the built‑in preview now fail with the following error:
Error: missing option: typeLength (required for FIXED_LEN_BYTE_ARRAY)
This prevents viewing the file contents entirely.
Resource Types
Blobs
Authentication Method
Sign in
Connection Type
Sign in (subscription)
Steps to Reproduce
To Reproduce
Steps to reproduce the behaviour:
Install Azure Storage Explorer 1.43.0
Navigate to a container/directory containing Parquet files
Open a Parquet file (that was previously viewable in 1.41.1)
Observe the error in the preview pane
Actual Experience
{
"name": "Error",
"message": "missing option: typeLength (required for FIXED_LEN_BYTE_ARRAY)",
"stack": "Error: missing option: typeLength (required for FIXED_LEN_BYTE_ARRAY)
at decodeValues_FIXED_LEN_BYTE_ARRAY (C:\Program Files\Microsoft Azure Storage Explorer\resources\app\node_modules\@storage-explorer\file-preview\dist\src\index.js:31:29012)
at Object.decodeValues (C:\Program Files\Microsoft Azure Storage Explorer\resources\app\node_modules\@storage-explorer\file-preview\dist\src\index.js:31:29860)
at decodeValues (C:\Program Files\Microsoft Azure Storage Explorer\resources\app\node_modules\@storage-explorer\file-preview\dist\src\index.js:90:119015)
at decodeDictionaryPage (C:\Program Files\Microsoft Azure Storage Explorer\resources\app\node_modules\@storage-explorer\file-preview\dist\src\index.js:90:121097)
at process.processTicksAndRejections (node:internal/process/task_queues:103:5)
at async decodePage (C:\Program Files\Microsoft Azure Storage Explorer\resources\app\node_modules\@storage-explorer\file-preview\dist\src\index.js:90:120057)
at async ...
}
Expected Experience
Parquet files should preview successfully, as they did in version 1.41.1, without requiring changes to existing files.
Additional Context
AI Says
Possible cause
It appears the Parquet reader used in 1.43.0 has stricter handling for FIXED_LEN_BYTE_ARRAY types and now requires typeLength metadata to be present.
The files in question:
Contain FIXED_LEN_BYTE_ARRAY columns (likely decimals or fixed binary values)
Were readable in earlier versions, suggesting a regression or stricter validation in the newer preview component (@storage-explorer/file-preview)
The files are still readable using other tools (e.g., PyArrow, Spark, parquet-tools), suggesting the files are valid or at least widely compatible.
Downgrading to 1.41.1 restores functionality.
This impacts usability when inspecting existing datasets without reprocessing them.
I can pass an example file privately , however I can't upload it publicly for all to see
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the @storage-explorer/file-preview component and the decodeValues_FIXED_LEN_BYTE_ARRAY and decodeDictionaryPage entries shown in the stack trace. Compare the Parquet preview behavior between versions 1.43.0 and 1.41.1, using a representative file with FIXED_LEN_BYTE_ARRAY columns if available. Done means existing Parquet files preview successfully without the missing typeLength error.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- data, desktop
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100