mirror of
https://github.com/qdrant/qdrant-client.git
synced 2026-07-29 22:21:10 -05:00
519 lines
14 KiB
Python
519 lines
14 KiB
Python
# flake8: noqa E501
|
|
from typing import IO, TYPE_CHECKING, Any, Dict, Set, Union
|
|
|
|
from qdrant_client.http.models import *
|
|
from qdrant_client.http.models import models as m
|
|
|
|
SetIntStr = Set[Union[int, str]]
|
|
DictIntStrAny = Dict[Union[int, str], Any]
|
|
file = None
|
|
|
|
|
|
def jsonable_encoder(
|
|
obj: Any,
|
|
include: Union[SetIntStr, DictIntStrAny] = None,
|
|
exclude=None,
|
|
by_alias: bool = True,
|
|
skip_defaults: bool = None,
|
|
exclude_unset: bool = False,
|
|
):
|
|
if hasattr(obj, "dict"):
|
|
return obj.dict(
|
|
include=include,
|
|
exclude=exclude,
|
|
by_alias=by_alias,
|
|
exclude_unset=bool(exclude_unset or skip_defaults),
|
|
)
|
|
|
|
return obj
|
|
|
|
|
|
if TYPE_CHECKING:
|
|
from qdrant_client.http.api_client import ApiClient
|
|
|
|
|
|
class _SnapshotsApi:
|
|
def __init__(self, api_client: "Union[ApiClient, AsyncApiClient]"):
|
|
self.api_client = api_client
|
|
|
|
def _build_for_create_full_snapshot(
|
|
self,
|
|
wait: bool = None,
|
|
):
|
|
"""
|
|
Create new snapshot of the whole storage
|
|
"""
|
|
query_params = {}
|
|
if wait is not None:
|
|
query_params["wait"] = str(wait).lower()
|
|
|
|
return self.api_client.request(
|
|
type_=m.InlineResponse20010,
|
|
method="POST",
|
|
url="/snapshots",
|
|
params=query_params,
|
|
)
|
|
|
|
def _build_for_create_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
wait: bool = None,
|
|
):
|
|
"""
|
|
Create new snapshot for a collection
|
|
"""
|
|
path_params = {
|
|
"collection_name": str(collection_name),
|
|
}
|
|
|
|
query_params = {}
|
|
if wait is not None:
|
|
query_params["wait"] = str(wait).lower()
|
|
|
|
return self.api_client.request(
|
|
type_=m.InlineResponse20010,
|
|
method="POST",
|
|
url="/collections/{collection_name}/snapshots",
|
|
path_params=path_params,
|
|
params=query_params,
|
|
)
|
|
|
|
def _build_for_delete_full_snapshot(
|
|
self,
|
|
snapshot_name: str,
|
|
wait: bool = None,
|
|
):
|
|
"""
|
|
Delete snapshot of the whole storage
|
|
"""
|
|
path_params = {
|
|
"snapshot_name": str(snapshot_name),
|
|
}
|
|
|
|
query_params = {}
|
|
if wait is not None:
|
|
query_params["wait"] = str(wait).lower()
|
|
|
|
return self.api_client.request(
|
|
type_=m.InlineResponse2003,
|
|
method="DELETE",
|
|
url="/snapshots/{snapshot_name}",
|
|
path_params=path_params,
|
|
params=query_params,
|
|
)
|
|
|
|
def _build_for_delete_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
snapshot_name: str,
|
|
wait: bool = None,
|
|
):
|
|
"""
|
|
Delete snapshot for a collection
|
|
"""
|
|
path_params = {
|
|
"collection_name": str(collection_name),
|
|
"snapshot_name": str(snapshot_name),
|
|
}
|
|
|
|
query_params = {}
|
|
if wait is not None:
|
|
query_params["wait"] = str(wait).lower()
|
|
|
|
return self.api_client.request(
|
|
type_=m.InlineResponse2003,
|
|
method="DELETE",
|
|
url="/collections/{collection_name}/snapshots/{snapshot_name}",
|
|
path_params=path_params,
|
|
params=query_params,
|
|
)
|
|
|
|
def _build_for_get_full_snapshot(
|
|
self,
|
|
snapshot_name: str,
|
|
):
|
|
"""
|
|
Download specified snapshot of the whole storage as a file
|
|
"""
|
|
path_params = {
|
|
"snapshot_name": str(snapshot_name),
|
|
}
|
|
|
|
return self.api_client.request(
|
|
type_=file,
|
|
method="GET",
|
|
url="/snapshots/{snapshot_name}",
|
|
path_params=path_params,
|
|
)
|
|
|
|
def _build_for_get_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
snapshot_name: str,
|
|
):
|
|
"""
|
|
Download specified snapshot from a collection as a file
|
|
"""
|
|
path_params = {
|
|
"collection_name": str(collection_name),
|
|
"snapshot_name": str(snapshot_name),
|
|
}
|
|
|
|
return self.api_client.request(
|
|
type_=file,
|
|
method="GET",
|
|
url="/collections/{collection_name}/snapshots/{snapshot_name}",
|
|
path_params=path_params,
|
|
)
|
|
|
|
def _build_for_list_full_snapshots(
|
|
self,
|
|
):
|
|
"""
|
|
Get list of snapshots of the whole storage
|
|
"""
|
|
return self.api_client.request(
|
|
type_=m.InlineResponse2009,
|
|
method="GET",
|
|
url="/snapshots",
|
|
)
|
|
|
|
def _build_for_list_snapshots(
|
|
self,
|
|
collection_name: str,
|
|
):
|
|
"""
|
|
Get list of snapshots for a collection
|
|
"""
|
|
path_params = {
|
|
"collection_name": str(collection_name),
|
|
}
|
|
|
|
return self.api_client.request(
|
|
type_=m.InlineResponse2009,
|
|
method="GET",
|
|
url="/collections/{collection_name}/snapshots",
|
|
path_params=path_params,
|
|
)
|
|
|
|
def _build_for_recover_from_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
wait: bool = None,
|
|
snapshot_recover: m.SnapshotRecover = None,
|
|
):
|
|
"""
|
|
Recover local collection data from a snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created.
|
|
"""
|
|
path_params = {
|
|
"collection_name": str(collection_name),
|
|
}
|
|
|
|
query_params = {}
|
|
if wait is not None:
|
|
query_params["wait"] = str(wait).lower()
|
|
|
|
body = jsonable_encoder(snapshot_recover)
|
|
|
|
return self.api_client.request(
|
|
type_=m.InlineResponse2003,
|
|
method="PUT",
|
|
url="/collections/{collection_name}/snapshots/recover",
|
|
path_params=path_params,
|
|
params=query_params,
|
|
json=body,
|
|
)
|
|
|
|
def _build_for_recover_from_uploaded_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
wait: bool = None,
|
|
priority: SnapshotPriority = None,
|
|
snapshot: IO[Any] = None,
|
|
):
|
|
"""
|
|
Recover local collection data from an uploaded snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created.
|
|
"""
|
|
path_params = {
|
|
"collection_name": str(collection_name),
|
|
}
|
|
|
|
query_params = {}
|
|
if wait is not None:
|
|
query_params["wait"] = str(wait).lower()
|
|
if priority is not None:
|
|
query_params["priority"] = str(priority)
|
|
|
|
files: Dict[str, IO[Any]] = {} # noqa F841
|
|
data: Dict[str, Any] = {} # noqa F841
|
|
if snapshot is not None:
|
|
files["snapshot"] = snapshot
|
|
|
|
return self.api_client.request(
|
|
type_=m.InlineResponse2003,
|
|
method="POST",
|
|
url="/collections/{collection_name}/snapshots/upload",
|
|
path_params=path_params,
|
|
params=query_params,
|
|
data=data,
|
|
files=files,
|
|
)
|
|
|
|
|
|
class AsyncSnapshotsApi(_SnapshotsApi):
|
|
async def create_full_snapshot(
|
|
self,
|
|
wait: bool = None,
|
|
) -> m.InlineResponse20010:
|
|
"""
|
|
Create new snapshot of the whole storage
|
|
"""
|
|
return await self._build_for_create_full_snapshot(
|
|
wait=wait,
|
|
)
|
|
|
|
async def create_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
wait: bool = None,
|
|
) -> m.InlineResponse20010:
|
|
"""
|
|
Create new snapshot for a collection
|
|
"""
|
|
return await self._build_for_create_snapshot(
|
|
collection_name=collection_name,
|
|
wait=wait,
|
|
)
|
|
|
|
async def delete_full_snapshot(
|
|
self,
|
|
snapshot_name: str,
|
|
wait: bool = None,
|
|
) -> m.InlineResponse2003:
|
|
"""
|
|
Delete snapshot of the whole storage
|
|
"""
|
|
return await self._build_for_delete_full_snapshot(
|
|
snapshot_name=snapshot_name,
|
|
wait=wait,
|
|
)
|
|
|
|
async def delete_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
snapshot_name: str,
|
|
wait: bool = None,
|
|
) -> m.InlineResponse2003:
|
|
"""
|
|
Delete snapshot for a collection
|
|
"""
|
|
return await self._build_for_delete_snapshot(
|
|
collection_name=collection_name,
|
|
snapshot_name=snapshot_name,
|
|
wait=wait,
|
|
)
|
|
|
|
async def get_full_snapshot(
|
|
self,
|
|
snapshot_name: str,
|
|
) -> file:
|
|
"""
|
|
Download specified snapshot of the whole storage as a file
|
|
"""
|
|
return await self._build_for_get_full_snapshot(
|
|
snapshot_name=snapshot_name,
|
|
)
|
|
|
|
async def get_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
snapshot_name: str,
|
|
) -> file:
|
|
"""
|
|
Download specified snapshot from a collection as a file
|
|
"""
|
|
return await self._build_for_get_snapshot(
|
|
collection_name=collection_name,
|
|
snapshot_name=snapshot_name,
|
|
)
|
|
|
|
async def list_full_snapshots(
|
|
self,
|
|
) -> m.InlineResponse2009:
|
|
"""
|
|
Get list of snapshots of the whole storage
|
|
"""
|
|
return await self._build_for_list_full_snapshots()
|
|
|
|
async def list_snapshots(
|
|
self,
|
|
collection_name: str,
|
|
) -> m.InlineResponse2009:
|
|
"""
|
|
Get list of snapshots for a collection
|
|
"""
|
|
return await self._build_for_list_snapshots(
|
|
collection_name=collection_name,
|
|
)
|
|
|
|
async def recover_from_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
wait: bool = None,
|
|
snapshot_recover: m.SnapshotRecover = None,
|
|
) -> m.InlineResponse2003:
|
|
"""
|
|
Recover local collection data from a snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created.
|
|
"""
|
|
return await self._build_for_recover_from_snapshot(
|
|
collection_name=collection_name,
|
|
wait=wait,
|
|
snapshot_recover=snapshot_recover,
|
|
)
|
|
|
|
async def recover_from_uploaded_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
wait: bool = None,
|
|
priority: SnapshotPriority = None,
|
|
snapshot: IO[Any] = None,
|
|
) -> m.InlineResponse2003:
|
|
"""
|
|
Recover local collection data from an uploaded snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created.
|
|
"""
|
|
return await self._build_for_recover_from_uploaded_snapshot(
|
|
collection_name=collection_name,
|
|
wait=wait,
|
|
priority=priority,
|
|
snapshot=snapshot,
|
|
)
|
|
|
|
|
|
class SyncSnapshotsApi(_SnapshotsApi):
|
|
def create_full_snapshot(
|
|
self,
|
|
wait: bool = None,
|
|
) -> m.InlineResponse20010:
|
|
"""
|
|
Create new snapshot of the whole storage
|
|
"""
|
|
return self._build_for_create_full_snapshot(
|
|
wait=wait,
|
|
)
|
|
|
|
def create_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
wait: bool = None,
|
|
) -> m.InlineResponse20010:
|
|
"""
|
|
Create new snapshot for a collection
|
|
"""
|
|
return self._build_for_create_snapshot(
|
|
collection_name=collection_name,
|
|
wait=wait,
|
|
)
|
|
|
|
def delete_full_snapshot(
|
|
self,
|
|
snapshot_name: str,
|
|
wait: bool = None,
|
|
) -> m.InlineResponse2003:
|
|
"""
|
|
Delete snapshot of the whole storage
|
|
"""
|
|
return self._build_for_delete_full_snapshot(
|
|
snapshot_name=snapshot_name,
|
|
wait=wait,
|
|
)
|
|
|
|
def delete_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
snapshot_name: str,
|
|
wait: bool = None,
|
|
) -> m.InlineResponse2003:
|
|
"""
|
|
Delete snapshot for a collection
|
|
"""
|
|
return self._build_for_delete_snapshot(
|
|
collection_name=collection_name,
|
|
snapshot_name=snapshot_name,
|
|
wait=wait,
|
|
)
|
|
|
|
def get_full_snapshot(
|
|
self,
|
|
snapshot_name: str,
|
|
) -> file:
|
|
"""
|
|
Download specified snapshot of the whole storage as a file
|
|
"""
|
|
return self._build_for_get_full_snapshot(
|
|
snapshot_name=snapshot_name,
|
|
)
|
|
|
|
def get_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
snapshot_name: str,
|
|
) -> file:
|
|
"""
|
|
Download specified snapshot from a collection as a file
|
|
"""
|
|
return self._build_for_get_snapshot(
|
|
collection_name=collection_name,
|
|
snapshot_name=snapshot_name,
|
|
)
|
|
|
|
def list_full_snapshots(
|
|
self,
|
|
) -> m.InlineResponse2009:
|
|
"""
|
|
Get list of snapshots of the whole storage
|
|
"""
|
|
return self._build_for_list_full_snapshots()
|
|
|
|
def list_snapshots(
|
|
self,
|
|
collection_name: str,
|
|
) -> m.InlineResponse2009:
|
|
"""
|
|
Get list of snapshots for a collection
|
|
"""
|
|
return self._build_for_list_snapshots(
|
|
collection_name=collection_name,
|
|
)
|
|
|
|
def recover_from_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
wait: bool = None,
|
|
snapshot_recover: m.SnapshotRecover = None,
|
|
) -> m.InlineResponse2003:
|
|
"""
|
|
Recover local collection data from a snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created.
|
|
"""
|
|
return self._build_for_recover_from_snapshot(
|
|
collection_name=collection_name,
|
|
wait=wait,
|
|
snapshot_recover=snapshot_recover,
|
|
)
|
|
|
|
def recover_from_uploaded_snapshot(
|
|
self,
|
|
collection_name: str,
|
|
wait: bool = None,
|
|
priority: SnapshotPriority = None,
|
|
snapshot: IO[Any] = None,
|
|
) -> m.InlineResponse2003:
|
|
"""
|
|
Recover local collection data from an uploaded snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created.
|
|
"""
|
|
return self._build_for_recover_from_uploaded_snapshot(
|
|
collection_name=collection_name,
|
|
wait=wait,
|
|
priority=priority,
|
|
snapshot=snapshot,
|
|
)
|