Snapshots

Snapshots move data between an Edge Shard and a Qdrant server collection. This section covers the methods; for how to combine them, refer to Data Synchronization Patterns.

unpack_snapshot

Unpacks a snapshot archive on disk so it can be loaded as a shard. A static method in Python and an associated function in Rust, so it needs no shard instance.

@staticmethod
def unpack_snapshot(snapshot_path: str, target_path: str) -> None

pub fn unpack_snapshot(snapshot_path: &Path, target_path: &Path) -> OperationResult<()>

After unpacking, open the directory with load. The resulting shard keeps the configuration and file layout of the collection the snapshot came from, including its vector and payload indexes.

snapshot_manifest

Returns the shard’s snapshot manifest, which describes its segments and their metadata. Pass it to a server when requesting a partial snapshot so the server sends only the segments that have changed.

def snapshot_manifest(self) -> Any

pub fn snapshot_manifest(&self) -> OperationResult<SnapshotManifest>

Returns a JSON-like value in Python, and a SnapshotManifest in Rust.

Apply a Snapshot

Applies a snapshot to a shard that already holds data. The two languages differ in shape here.

def update_from_snapshot(
    self,
    snapshot_path: str,
    tmp_dir: Optional[str] = None,
) -> None

pub fn recover_partial_snapshot(
    shard_path: &Path,
    current_manifest: &SnapshotManifest,
    snapshot_path: &Path,
    snapshot_manifest: &SnapshotManifest,
) -> OperationResult<EdgeShard>

Python applies the snapshot to the open shard in place, optionally extracting through tmp_dir. Rust takes the shard’s path and both manifests, and returns a new EdgeShard for the merged result, so the existing instance must be dropped first.