Specifies the scope of GraphQL object type fields that the provider exposes as tables in the schema.

Possible Values

Data Type

string

Default Value

"SHALLOW"

Remarks

This property determines the extent to which GraphQL object type fields are exposed as tables in the schema. It applies only to object fields that meet the following conditions:

1. At a given nesting level, if the schema defines both a single-field object and a field that returns a list or a connection of the same type, the connector exposes the list or connection as a table. This is because the list or connection represents the complete collection, whereas the single-field object typically represents a filtered subset requiring additional parameters, such as an ID, for retrieval.
2. The object field is either directly part of the root Query type or includes required arguments.

This property offers three modes of exposure:

• NONE: No GraphQL object type fields are exposed as tables.
• SHALLOW: Only objects directly under the root Query type are exposed as tables.
• DEEP: All objects meeting the conditions, up to the limit defined by the ExpandTablesDepth property, are exposed as tables.

The default setting, SHALLOW, simplifies schema representation by exposing only top-level query objects as tables. Use DEEP to include more deeply nested objects for advanced use cases.