Files
Lists files stored in OneDrive or SharePoint, with metadata including file names, locations, last modified times, and sharing status.
Table Specific Information
Select
Retrieve files by using the UserId or File Id (Id) for instance, or simply filter by a certain column:
SELECT * FROM Files WHERE UserId = 'MyUserId' SELECT Name, LastModifiedDateTime FROM Files WHERE Name LIKE 'test%'
To work for Folder-level files, we need to specify the parentReference_path in the query.
SELECT * FROM files WHERE parentReference_path = '/drives/b!3LIvU2zISEqicGlWkgVknKxKT-q7gM5IqlBJ4w4MZqaX6BQc_vtwQpnqaldXkH9I/root:/Test_Shubham';
INSERT
INSERT operation is not supported for this table.
Note: See UploadFile (or CreateFolder to create a folder) to insert and update content to a file.
Columns
| Name | Type | ReadOnly | References | Description |
| id [KEY] | String | True |
Unique identifier for the file object. | |
| Etag | String | False |
Entity tag representing the version of the file for concurrency control. | |
| createdBy_application_displayName | String | False |
Display name of the application that created the file. | |
| createdBy_application_id | String | False |
Identifier of the application that created the file. | |
| createdDateTime | Datetime | False |
Timestamp indicating when the file was created. | |
| description | String | False |
User-defined or system-generated description of the file. | |
| lastModifiedBy_application_displayName | String | False |
Display name of the application that last modified the file. | |
| lastModifiedBy_application_id | String | False |
Identifier of the application that last modified the file. | |
| lastModifiedDateTime | Datetime | False |
Timestamp indicating the last modification time of the file. | |
| name | String | False |
Name of the file. | |
| parentReference_driveId | String | False |
Drive ID of the parent folder that contains the file. | |
| parentReference_driveType | String | False |
Type of drive (for example, personal, business, or document library) where the file resides. | |
| parentReference_id | String | False |
ID of the parent folder or drive reference. | |
| parentReference_name | String | False |
Name of the parent folder containing the file. | |
| parentReference_path | String | False |
Path from the drive root to the parent folder. | |
| parentReference_shareId | String | False |
Sharing ID associated with the parent reference. | |
| parentReference_sharepointIds_listId | String | False |
SharePoint list ID linked to the parent reference. | |
| parentReference_sharepointIds_listItemId | String | False |
List item ID in SharePoint for the parent reference. | |
| parentReference_sharepointIds_listItemUniqueId | String | False |
Unique ID of the list item in SharePoint for the parent reference. | |
| parentReference_sharepointIds_siteId | String | False |
Site ID in SharePoint associated with the parent reference. | |
| parentReference_sharepointIds_siteUrl | String | False |
URL of the SharePoint site related to the parent reference. | |
| parentReference_sharepointIds_tenantId | String | False |
Tenant ID for the SharePoint environment of the parent reference. | |
| parentReference_sharepointIds_webId | String | False |
Web ID in SharePoint for the parent reference. | |
| parentReference_siteId | String | False |
Site ID associated with the file's parent location. | |
| webUrl | String | False |
Web-accessible URL pointing to the file. | |
| audio_album | String | False |
Album title associated with the audio file. | |
| audio_albumArtist | String | False |
Primary artist for the album associated with the audio file. | |
| audio_artist | String | False |
Artist of the audio file. | |
| audio_bitrate | Long | False |
Bitrate of the audio content in bits per second. | |
| audio_composers | String | False |
List of composers for the audio content. | |
| audio_copyright | String | False |
Copyright statement for the audio file. | |
| audio_disc | Int | False |
Disc number for multi-disc audio content. | |
| audio_discCount | Int | False |
Total number of discs in the album. | |
| audio_duration | Long | False |
Duration of the audio content in milliseconds. | |
| audio_genre | String | False |
Genre of the audio content. | |
| audio_hasDrm | Bool | False |
Indicates whether the audio file is protected by digital rights management. | |
| audio_isVariableBitrate | Bool | False |
Indicates whether the audio file uses variable bitrate encoding. | |
| audio_title | String | False |
Title of the audio track. | |
| audio_track | Int | False |
Track number of the audio file within the album. | |
| audio_trackCount | Int | False |
Total number of tracks in the album. | |
| audio_year | Int | False |
Year the audio track was released. | |
| content | String | False |
File contents in raw or encoded format. | |
| cTag | String | False |
Client tag used for managing file changes and synchronization. | |
| deleted_state | String | False |
Indicates the deletion state of the file, such as deleted or notDeleted. | |
| file_hashes_crc32Hash | String | False |
CRC32 hash value used to validate file content integrity. | |
| file_hashes_quickXorHash | String | False |
QuickXorHash used for content comparison and validation. | |
| file_hashes_sha1Hash | String | False |
SHA-1 hash of the file contents. | |
| file_hashes_sha256Hash | String | False |
SHA-256 hash of the file contents. | |
| file_mimeType | String | False |
MIME type indicating the file format, such as text/plain or application/pdf. | |
| file_processingMetadata | Bool | False |
Indicates whether metadata processing is complete for the file. | |
| fileSystemInfo_createdDateTime | Datetime | False |
Creation timestamp of the file from the file system. | |
| fileSystemInfo_lastAccessedDateTime | Datetime | False |
Last accessed timestamp recorded by the file system. | |
| fileSystemInfo_lastModifiedDateTime | Datetime | False |
Last modified timestamp recorded by the file system. | |
| folder_childCount | Int | False |
Number of child items within the folder. | |
| folder_view_sortBy | String | False |
Default column used to sort items in the folder view. | |
| folder_view_sortOrder | String | False |
Sort order (ascending or descending) used in the folder view. | |
| folder_view_viewType | String | False |
Type of folder view, such as details or thumbnails. | |
| image_height | Int | False |
Height of the image in pixels. | |
| image_width | Int | False |
Width of the image in pixels. | |
| location_altitude | Double | False |
Altitude where the image or file was captured, in meters. | |
| location_latitude | Double | False |
Latitude coordinate where the file or photo was created. | |
| location_longitude | Double | False |
Longitude coordinate where the file or photo was created. | |
| package_type | String | False |
Type of file package, such as oneNote or PDFPackage. | |
| pendingOperations_pendingContentUpdate_queuedDateTime | Datetime | False |
Timestamp when a pending content update was queued. | |
| photo_cameraMake | String | False |
Manufacturer of the camera used to take the photo. | |
| photo_cameraModel | String | False |
Model of the camera used to take the photo. | |
| photo_exposureDenominator | Double | False |
Denominator value for the exposure time used in the photo. | |
| photo_exposureNumerator | Double | False |
Numerator value for the exposure time used in the photo. | |
| photo_fNumber | Double | False |
F-number indicating the aperture setting of the camera. | |
| photo_focalLength | Double | False |
Focal length of the camera lens in millimeters. | |
| photo_iso | Int | False |
ISO setting used when the photo was taken. | |
| photo_orientation | Int | False |
Orientation value of the photo, indicating how it was rotated when taken. | |
| photo_takenDateTime | Datetime | False |
Timestamp when the photo was captured. | |
| publication_level | String | False |
Indicates the publication level, such as draft or published. | |
| publication_versionId | String | False |
Version ID of the published file. | |
| remoteItem_createdBy_application_displayName | String | False |
Display name of the application that originally created the remote item. | |
| remoteItem_createdBy_application_id | String | False |
Identifier of the application that created the remote item. | |
| remoteItem_createdDateTime | Datetime | False |
Timestamp when the remote item was created. | |
| remoteItem_file_hashes_crc32Hash | String | False |
CRC32 hash of the remote file used to verify data integrity. | |
| remoteItem_file_hashes_quickXorHash | String | False |
QuickXorHash of the remote file for efficient content comparison. | |
| remoteItem_file_hashes_sha1Hash | String | False |
SHA-1 hash of the remote file content. | |
| remoteItem_file_hashes_sha256Hash | String | False |
SHA-256 hash of the remote file content. | |
| remoteItem_file_mimeType | String | False |
MIME type of the remote file, identifying its format. | |
| remoteItem_file_processingMetadata | Bool | False |
Indicates whether metadata processing is complete for the remote file. | |
| remoteItem_fileSystemInfo_createdDateTime | Datetime | False |
Timestamp of when the remote file was created in the file system. | |
| remoteItem_fileSystemInfo_lastAccessedDateTime | Datetime | False |
Timestamp of when the remote file was last accessed. | |
| remoteItem_fileSystemInfo_lastModifiedDateTime | Datetime | False |
Timestamp of when the remote file was last modified. | |
| remoteItem_folder_childCount | Int | False |
Number of child items in the remote folder. | |
| remoteItem_folder_view_sortBy | String | False |
Field used to sort child items in the remote folder view. | |
| remoteItem_folder_view_sortOrder | String | False |
Sort order used in the remote folder view (ascending or descending). | |
| remoteItem_folder_view_viewType | String | False |
Type of view used for the remote folder, such as list or grid. | |
| remoteItem_id | String | False |
Unique identifier for the remote item. | |
| remoteItem_image_height | Int | False |
Height of the remote image in pixels. | |
| remoteItem_image_width | Int | False |
Width of the remote image in pixels. | |
| remoteItem_lastModifiedDateTime | Datetime | False |
Timestamp indicating when the remote item was last modified. | |
| remoteItem_name | String | False |
Name of the remote item. | |
| remoteItem_package_type | String | False |
Package type of the remote item, such as oneNote or PDFPackage. | |
| remoteItem_parentReference_driveId | String | False |
Drive ID of the parent folder of the remote item. | |
| remoteItem_parentReference_driveType | String | False |
Type of drive containing the remote item. | |
| remoteItem_parentReference_id | String | False |
Identifier of the remote item's parent folder. | |
| remoteItem_parentReference_name | String | False |
Name of the folder containing the remote item. | |
| remoteItem_parentReference_path | String | False |
Full path from the drive root to the remote item's parent. | |
| remoteItem_parentReference_shareId | String | False |
Share ID associated with the parent of the remote item. | |
| remoteItem_parentReference_sharepointIds_listId | String | False |
SharePoint list ID associated with the remote item's parent. | |
| remoteItem_parentReference_sharepointIds_listItemId | String | False |
SharePoint list item ID for the remote item's parent. | |
| remoteItem_parentReference_sharepointIds_listItemUniqueId | String | False |
Unique ID of the SharePoint list item for the remote item's parent. | |
| remoteItem_parentReference_sharepointIds_siteId | String | False |
SharePoint site ID associated with the parent of the remote item. | |
| remoteItem_parentReference_sharepointIds_siteUrl | String | False |
SharePoint site URL associated with the remote item's parent. | |
| remoteItem_parentReference_sharepointIds_tenantId | String | False |
Tenant ID of the SharePoint site for the remote item's parent. | |
| remoteItem_parentReference_sharepointIds_webId | String | False |
Web ID of the SharePoint site for the remote item's parent. | |
| remoteItem_parentReference_siteId | String | False |
Site ID where the remote item's parent folder is located. | |
| remoteItem_shared_scope | String | False |
Scope of sharing for the remote item, such as users or organization. | |
| remoteItem_shared_sharedDateTime | Datetime | False |
Timestamp when the remote item was shared. | |
| remoteItem_size | Long | False |
Size of the remote item in bytes. | |
| remoteItem_specialFolder_name | String | False |
Name of the special folder associated with the remote item, such as documents or photos. | |
| remoteItem_video_audioBitsPerSample | Int | False |
Bit depth per audio sample in the remote video file. | |
| remoteItem_video_audioChannels | Int | False |
Number of audio channels in the remote video file. | |
| remoteItem_video_audioSamplesPerSecond | Int | False |
Audio sample rate in samples per second for the remote video. | |
| remoteItem_video_bitrate | Int | False |
Bitrate of the remote video content in bits per second. | |
| remoteItem_video_duration | Long | False |
Duration of the remote video in milliseconds. | |
| remoteItem_video_fourCC | String | False |
Four-character code (FourCC) identifying the video codec of the remote video. | |
| remoteItem_video_frameRate | Double | False |
Frame rate of the remote video in frames per second. | |
| remoteItem_video_height | Int | False |
Height of the remote video in pixels. | |
| remoteItem_video_width | Int | False |
Width of the remote video in pixels. | |
| remoteItem_webDavUrl | String | False |
WebDAV URL that provides remote access to the item. | |
| remoteItem_webUrl | String | False |
Publicly accessible web URL of the remote item. | |
| searchResult_onClickTelemetryUrl | String | False |
URL used to collect telemetry when a search result is clicked. | |
| shared_owner_application_displayName | String | False |
Display name of the application that owns the shared item. | |
| shared_owner_application_id | String | False |
Identifier of the application that owns the shared item. | |
| shared_scope | String | False |
Scope of the sharing, such as anonymous or organization. | |
| shared_sharedDateTime | Datetime | False |
Timestamp indicating when the item was shared. | |
| sharepointIds_listId | String | False |
SharePoint list ID associated with the item. | |
| sharepointIds_listItemId | String | False |
List item ID within the SharePoint list. | |
| sharepointIds_listItemUniqueId | String | False |
Globally unique identifier of the SharePoint list item. | |
| sharepointIds_siteId | String | False |
SharePoint site ID where the item resides. | |
| sharepointIds_siteUrl | String | False |
URL of the SharePoint site containing the item. | |
| sharepointIds_tenantId | String | False |
Tenant ID of the SharePoint organization. | |
| sharepointIds_webId | String | False |
Web ID of the SharePoint site. | |
| size | Long | False |
Total size of the file in bytes. | |
| specialFolder_name | String | False |
Type of special folder, such as documents or photos, associated with the item. | |
| video_audioBitsPerSample | Int | False |
Number of bits per audio sample in the video file. | |
| video_audioChannels | Int | False |
Number of audio channels in the video. | |
| video_audioFormat | String | False |
Format of the audio stream embedded in the video. | |
| video_audioSamplesPerSecond | Int | False |
Sampling rate of the audio stream in samples per second. | |
| video_bitrate | Int | False |
Bitrate of the video content in bits per second. | |
| video_duration | Long | False |
Total duration of the video in milliseconds. | |
| video_fourCC | String | False |
FourCC representing the video codec. | |
| video_frameRate | Double | False |
Video frame rate measured in frames per second. | |
| video_height | Int | False |
Vertical resolution of the video in pixels. | |
| video_width | Int | False |
Horizontal resolution of the video in pixels. | |
| webDavUrl | String | False |
WebDAV endpoint URL to access the file remotely. | |
| UserId | String | False |
Identifier of the user who owns or uploaded the file. |