API를 사용하여 데이터 백업 및 복원Compatible with Milvus Backup 0.6.x

Milvus Backup HTTP API를 사용하여 백업을 생성하고, 컬렉션을 복원하며, 비동기 작업을 모니터링할 수 있습니다. 아래의 스냅샷 예제는 Milvus 3.0.1 이상이 필요합니다. Backup 0.5.x의 경우 0.5.x API 가이드를 참조하십시오. 기존 설치 환경의 경우 Milvus Backup 업그레이드 문서를 참조하십시오.

Milvus Backup 구하기

아래 예제는 Milvus Backup 0.6.0에서 검증되었습니다. v0.6.0 릴리스에서 적절한 바이너리를 다운로드하여 압축을 해제하십시오. 소스 코드에서 직접 빌드하려면 ‘Milvus Backup 구하기’를 따르십시오. 빌드에는 Go 1.26 이상이 필요합니다.

구성 파일 준비

'구성 파일 준비'의 v2 예제를 사용하여 ` configs/backup.yaml ` 파일을 생성하십시오. Milvus, 인스턴스의 스토리지 및 백업 대상에 대한 액세스를 구성하십시오. 또한 Milvus 서버는 스냅샷 작업을 위해 백업 스토리지에 액세스할 수 있어야 합니다.

v1 파일이 있는 경우, 해당 파일은 계속 불러올 수 있습니다. 스키마나 환경 변수를 변경하기 전에 '구성 마이그레이션'을 참조하십시오.

바이너리가 있는 디렉터리에서 구성을 확인하고 연결 상태를 점검하십시오:

./milvus-backup config show --config configs/backup.yaml
./milvus-backup check --config configs/backup.yaml

연결성 검사 결과 ' Success!'가 표시되면 다음 단계로 진행하십시오.

API 서버를 시작합니다.

확인한 구성으로 서비스를 시작하십시오:

./milvus-backup server --config configs/backup.yaml

기본 포트는 8080입니다. 다른 포트를 선택하려면 -p 를 사용하십시오:

./milvus-backup server -p 18080 --config configs/backup.yaml

특정 서비스에 대해서는 이 명령어 중 하나만 실행하십시오. 아래 예제에서는 포트 8080을 사용합니다. 다른 포트를 선택한 경우 URL을 변경하십시오. Swagger UI는 http://localhost:8080/api/v1/docs/index.html 에서 이용할 수 있습니다.

태스크를 폴링하는 동안 서비스를 계속 실행 상태로 유지하십시오. 태스크 ID와 실시간 진행 상황은 서비스 프로세스에 속하며, 프로세스가 중지된 후에도 영구 저장된 백업은 오브젝트 스토리지에 남아 있습니다.

데이터 준비

coll 라는 기존 컬렉션을 사용하거나, ‘샘플 데이터 준비’에서 256개 엔티티로 구성된 테스트 컬렉션을 생성하십시오. 자체 데이터를 사용하는 경우 요청 내의 컬렉션 이름을 변경하십시오. 결과를 확인하는 동안 테스트 데이터는 변경하지 마십시오.

데이터 백업

비동기 백업 요청을 제출합니다:

curl --request POST 'http://localhost:8080/api/v1/create' \
  --header 'Content-Type: application/json' \
  --data '{
    "async": true,
    "backup_name": "my_backup",
    "collection_names": ["coll"]
  }'

응답에는 requestId 값이 포함됩니다. 요청을 제출했다고 해서 백업이 완료된 것은 아닙니다. 해당 값을 backup_id 에 복사하고 주기적으로 확인하십시오:

curl 'http://localhost:8080/api/v1/get_backup?backup_id=BACKUP_REQUEST_ID&backup_name=my_backup'

data.state_code 가 2 로 변경될 때까지 기다리십시오. API는 다음과 같은 작업 상태를 사용합니다:

state_code의미
0초기
1실행 중
2성공
3실패
4시간 초과

응답과 작업 상태를 모두 확인하십시오. HTTP 200 상태 코드만으로는 충분하지 않습니다. 0이 아닌 응답 code 는 오류를 나타냅니다. 성공적인 응답의 경우 code 값이 0이므로 생략될 수 있습니다. 작업이 실패하거나 시간 초과된 경우, 해당 백업에서 복원하기 전에 응답 세부 정보와 서버 로그를 확인하십시오.

저장된 백업 목록을 확인하고 이름으로 완료된 백업을 조사하십시오:

curl 'http://localhost:8080/api/v1/list'
curl 'http://localhost:8080/api/v1/get_backup?backup_name=my_backup'

get_backup collection_backups 을 포함한 JSON 메타데이터를 반환하며, 백업 파일은 다운로드하지 않습니다. 다른 프로세스에서 생성된 백업의 경우, 이름만 지정하여 쿼리하면 실시간 작업 진행 상황 없이 메타데이터만 반환될 수 있습니다. 진행 중인 백업을 모니터링할 때는 현재 서비스의 생성 응답에서 반환된 작업 ID를 사용하십시오.

기본 형식은 auto 이며, 이는 Milvus 3.0에서 스냅샷을 선택합니다. 바이너리 로그를 명시적으로 요청하려면 create 본문에 "format": "binlog" 를 추가하십시오. CLI의 --for 사전 설정은 HTTP 요청 필드가 아닙니다.

백업을 보존하거나 이동하려면 오브젝트 스토리지의 전체 디렉터리를 복사하십시오. 0.6.0 전송 가이드를 참조하십시오.

데이터 복원

coll_bak 가 이미 존재하지 않는지 확인하십시오. 접미사를 포함하여 복원 요청을 제출하십시오:

curl --request POST 'http://localhost:8080/api/v1/restore' \
  --header 'Content-Type: application/json' \
  --data '{
    "async": true,
    "backup_name": "my_backup",
    "collection_names": ["coll"],
    "collection_suffix": "_bak"
  }'

HTTP collection_names 필드는 접미사가 적용되기 전 백업 내의 이름을 선택합니다. 이 요청은 coll 를 선택하여 coll_bak 를 생성합니다. 반면 CLI의 --filter 는 이름 변경 후의 대상 이름을 일치시킵니다. 이 HTTP 필드에 coll_bak 를 대입하지 마십시오.

복원 응답에서 data.id 을 복사한 후 작업을 확인하십시오:

curl 'http://localhost:8080/api/v1/get_restore?id=RESTORE_TASK_ID'

data.state_code: 2 가 표시될 때까지 기다린 후, collection_restore_tasks 에서 예상되는 대상 컬렉션을 확인하십시오. 제출된 작업이 아직 검증된 복원이 아닙니다.

원본 이름으로 복원

coll 가 존재하지 않는 대상 인스턴스를 사용하십시오. 해당 대상 및 완료된 백업 위치에 대해 구성된 별도의 백업 API 서비스를 시작한 다음, 대상 서비스에 다음 요청을 전송하십시오:

curl --request POST 'http://localhost:8080/api/v1/restore' \
  --header 'Content-Type: application/json' \
  --data '{
    "async": true,
    "backup_name": "my_backup",
    "collection_names": ["coll"],
    "collection_suffix": ""
  }'

반환된 작업 ID를 사용하여 동일한 서비스에서 get_restore 를 폴링하십시오. 복원 대상에 대해 milvus.* 를, 기존 백업에 대해 backup.storage 를 구성하십시오. ‘구성 파일 준비’를 참조하십시오.

복원된 데이터 확인

복원 작업이 성공적으로 완료된 후, 대상 Milvus 인스턴스에 연결하여 예상된 컬렉션과 데이터가 존재하는지 확인하십시오. 256개 엔티티로 구성된 테스트 컬렉션의 경우, ‘결과 확인’ 섹션에 설명된 스칼라, 벡터 및 검색 검사를 모두 수행하십시오.

원본 이름으로 복원할 때는 coll_bak 을 coll 으로 변경하십시오. 검증 코드는 복원된 데이터를 삭제하지 않고 읽어들입니다. 프로덕션 데이터의 경우, 백업 시점에 캡처된 기준 데이터와 비교하십시오.

번역DeepL

관리형 Milvus를 무료로 사용해 보세요

Zilliz Cloud는 번거로움이 없으며, Milvus 기반으로 10배 더 빠릅니다.

시작하기
피드백

이 페이지가 도움이 되었나요?