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)

Open
#9,104 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

:beetle: regression :gear: blobs :gear: file preview
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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.