IRPCIndexingDataSource2.GetCurrentTimestampForIX
Server integration API / specialized internal: not for applications read session idempotent
Gets the vault's current crawl position for the combined enumerator: a crawl that starts there sees every change committed after the call and none committed before it.
| Service | Indexing data source (version 2) MFiles.IRPCIndexingDataSource2 |
|---|---|
| gRPC method | /MFiles.IRPCIndexingDataSource2/GetCurrentTimestampForIX |
| HTTP (mf-http-grpc) | POST /grpc/v1/get-current-timestamp-for-ix |
| Request | GetCurrentTimestampForIXRequest |
| Response | GetCurrentTimestampForIXResponse |
| Book and level | Server integration API, specialized |
| Kind | read |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | yes |
| Returns metadata structure version | no |
| Streaming | none (unary) |
Remarks
For M-Files components only. M-Files' cloud search indexing services call it to start a crawl from "now" instead of from the beginning of the vault's history. Applications should not call it.
- Requires a vault session with the vault rights
see_all_objectsandsee_deleted_objects; a normal user is denied. Read-only. - Not available on all servers: it fails with "Not implemented." where the server does not offer
it. An older server answers with gRPC status
UNIMPLEMENTED.
Request: GetCurrentTimestampForIXRequest
No fields.
Response: GetCurrentTimestampForIXResponse
Response for GetCurrentTimestampForIX. Carries the vault's current indexing head: the position from which a ForIX crawl sees no change committed before the call and every change committed after it.
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
current_version_for_ix | LogicalTimestamp | The position as an integer timestamp, for starting a crawl with GetNextObjectsForIX and HasMoreObjectsForIX. Each value is capped so that it never passes a change that is still being committed. |
current_version_for_ix.type | LogicalTimestampType | Logical timestamp type.Values: LOGICAL_TIMESTAMP_TYPE_UNINITIALIZED (0), LOGICAL_TIMESTAMP_TYPE_IGNORED (1), LOGICAL_TIMESTAMP_TYPE_INTEGER (2), LOGICAL_TIMESTAMP_TYPE_STRING (3), LOGICAL_TIMESTAMP_TYPE_INTEGER_AND_STRING (4). |
current_version_for_ix.data | LogicalTimestampUnion | The data as a union. |
current_version_for_ix.data.integer | LogicalTimestampInteger (oneof data) | Logical timestamp as an int64 vector. |
current_version_for_ix.data.string | LogicalTimestampString (oneof data) | String. |
current_version_for_ix.data.integer_and_string | LogicalTimestampIntegerAndString (oneof data) | Integer and string. |
current_change_tracking_version | LogicalTimestamp | The current Change Tracking version, read before the position, in the form that GetSmallestTimestampForMetadataIX reports it; 1 when the vault does not use Change Tracking. |
current_change_tracking_version.type | LogicalTimestampType | Logical timestamp type.Values: LOGICAL_TIMESTAMP_TYPE_UNINITIALIZED (0), LOGICAL_TIMESTAMP_TYPE_IGNORED (1), LOGICAL_TIMESTAMP_TYPE_INTEGER (2), LOGICAL_TIMESTAMP_TYPE_STRING (3), LOGICAL_TIMESTAMP_TYPE_INTEGER_AND_STRING (4). |
current_change_tracking_version.data | LogicalTimestampUnion | The data as a union. |
current_change_tracking_version.data.integer | LogicalTimestampInteger (oneof data) | Logical timestamp as an int64 vector. |
current_change_tracking_version.data.string | LogicalTimestampString (oneof data) | String. |
current_change_tracking_version.data.integer_and_string | LogicalTimestampIntegerAndString (oneof data) | Integer and string. |