FeatureLayer.query returning dict instead of FeatureSet

[NoahLittle2001]

Describe the bug
When using the FeatureLayer.query method and requesting a large number of attributes and features the method will return a dictionary instead of a FeatureSet. This dictionary includes the error 'exceededTransferLimit': True. This error will pop up even if you request less than the maxRecordCount if requesting many attributes.

To Reproduce
Steps to reproduce the behavior:

gis = GIS('pro')
fl = FeatureLayer(url, gis=gis)
fetch_size = getattr(fl.properties, "maxRecordCount")
fs = fl.query(where='1=1', out_fields=['*'], return_geometry=True, result_record_count=fetch_size)
print(fs)
print(type(fs))

error:

'geometry': {'x': 2953720.9347767606, 'y': 14609546.783672191}},
  ...],
 'exceededTransferLimit': True}

dict

Screenshots

Expected behavior
The Arcgis Python API should handle this internally and change the request size or limit. Keeping the return type as a FeatureSet exclusively would make things more predictable.

Platform (please complete the following information):

• Windows 11
• Chrome
• 2.4.1.1

Additional context
While this might not be a bug I feel that this error is not handles properly and should be handed internally with the python API.

[nanaeaubry]

@NoahLittle2001 What version of the API are you using?
Also how many records are you querying ?

[NoahLittle2001]

@NoahLittle2001 What version of the API are you using? Also how many records are you querying ?

Apologize for not including the version. I'm using 2.4.1.1.
I've been using the services maxRecordCount which is 100000. I'm also querying about 90 attributes per feature.

[nanaeaubry]

@NoahLittle2001
We cannot reproduce the bug you are seeing but we also have data that caps at about 200'000 features. This does require the query to use pagination as with your 100000.

What is happening is that the raw result is being returned in your case. This occurs in a few cases:

1. The Feature Layer is a 3D feature layer
2. The query failed at some point and had to retry with fewer records until it succeeded. (most likely your case)

If you want a result that is a feature set you can get the result and do: arcgis.features.FeatureSet.from_dict(result)

The API does handle this internally but does not return a FeatureSet since it failed to execute the original user query.
We will discuss this and find a way to better handle it.