Microsoft SharePoint Unstructured (Documents) Limitations and Troubleshooting
The Microsoft SharePoint unstructured data connector enforces specific constraints concerning file format compatibility, size limits, and content age during data ingestion. Files that don’t meet these criteria are automatically skipped, and their status is logged in the unstructured data lake object (UDLO) for auditing and review.
Supported File Formats and Regex Patterns
The connector is configured to process the following explicit MIME types and matching file patterns. This includes a wide range of documents, images, and text formats.
The following regular expressions are used to capture supported file types that match broad patterns in their MIME type or file extension:
Regex Pattern
Description
/^(?!.*google).*doc.* | .*-doc.*/i
Matches MIME types containing .doc or -doc, excluding Google Docs.
/.*html.* | .*-html.*/i
Matches MIME types containing .html or -html.
/.*image.* | .*-image.*/i
Matches MIME types containing image or -image.
/.*md.* | .*markdown.*/i
Matches MIME types containing .md or markdown.
/.*pdf.*/i
Matches MIME types containing pdf anywhere.
/^application\/vnd\.google-apps\..*/i
Matches Google Apps-specific MIME types.
Unsupported File Patterns
The following Google Workspace MIME types are explicitly excluded from ingestion and are skipped:
application/vnd.google-apps.shortcut
application/vnd.google-apps.script
application/vnd.google-apps.site
application/vnd.google-apps.form
application/vnd.google-apps.vid
File Size Limitations
To maintain processing stability and efficiency, the connector enforces maximum file size limits. Files are categorized, and a maximum size check is performed based on the content type. Any file exceeding its category limit will be skipped.
Any supported file format that doesn’t fall into the PDF or Image categories are checked against the 4-MB maximum size limit.
Last Modified Time
Content deemed stale based on its age is skipped to maintain relevance.
Rule: Any content where the last modified time is more than 2 years before the current sync time will be skipped.
Handling of Skipped Files (UDLO Reporting)
When a file fails any constraint check (Format, Size, or Last Modified Time), it’s skipped. The outcome is recorded in the UDLO. The UDLO contains the below fields to detail the failure.
Field
Value
Description
Sync Status
SUCCESS, FAILURE or SKIPPED
Indicates the file ingestion status.
Sync Status Detail
Detailed Error Message
Provides the explicit reason why the file was skipped.
File Path
NULL or Empty String
The file path field is explicitly cleared for all skipped records to mark them as non-ingested.
Reasons for Skipping (Sync Status Detail)
Files are processed through a series of checks. If a check fails, the file is immediately skipped and the appropriate reason is logged in the UDLO.
Failure Condition
Status Details Message
Unsupported Format
Explicitly Unsupported: If the file’s MIME type matches an unsupported pattern (for example, application/vnd.google-apps.shortcut).
Default Format Skip
Implicitly Unsupported: If the file’s type doesn’t match any supported format or regex patterns, it will be skipped.
Content Age
Last modified time %s is older than %d years (for example, Last modified time 2022-01-15T10:30:00Z is older than 2 years)
Size Exceeded (PDF, CSV & Similar)
%s must be less than %d MB (found %.2f MB) (for example, PDF must be less than 100 MB (found 204.20 MB))
Size Exceeded (Image & Similar)
%s must be less than %d MB (found %.2f MB) (for example, IMAGE must be less than 20 MB (found 25 MB))
Size Exceeded (All Other)
%s must be less than %d MB (found %.2f MB) (for example, text/other files must be less than 4 MB (found 30 MB))
Ingestion Size Limits and Timeout
Microsoft SharePoint supports ingestion of sites or libraries up to 300 GB per ingestion job.
Note: Timeout Guidance
Ingestion jobs that run for longer than 24 hours may time out depending on system execution limits, so plan accordingly.
Connector Scope Limitations
These limitations apply to the connector’s ingestion scope:
Subsites are not supported. The connector only ingests content from the site specified by the Site ID. Content stored on SharePoint subsites (child sites) is not ingested by the connector.
Only the default Documents library is ingested. The connector uses the default drive (Documents library) of the specified site. There is no option to specify a Drive ID. Files stored in non-default document libraries or custom drives within the same site are not ingested.
Folder-level and library-level filtering is not available. The connector ingests all supported files from the default Documents library. You can’t scope ingestion to a specific folder or sublibrary within the site.
Workaround
To ingest files that reside outside the default Documents library of the configured site:
Non-default library: Move the files into the default Documents library, or create a dedicated SharePoint site with the target files in its default Documents library and configure a new connector instance for that site.
Subsite content: Move the files to a root-level site’s default Documents library and connect to that site.
Behavior When No Files Are Found
If the default Documents library of the specified site contains no supported files (for example, because all content resides on a subsite or in a non-default library), the ingestion job completes successfully with zero records ingested. No error is displayed in the connector UI.
If files are present in the default Documents library but are unsupported (for example, due to unsupported MIME types or file sizes exceeding the supported limit), those files are skipped during ingestion. In such cases, the ingestion job typically completes successfully even though no records are ingested. Review the UDLO sync status fields for additional details about why specific files were not ingested.