メインコンテンツまでスキップ

CreateSnapshot()

この操作はコレクションのある時点のスナップショットを作成します。スナップショットを使用して、災害復旧や移行のためにコレクションのデータとメタデータをバックアップします。

go
func (c *Client) CreateSnapshot(ctx context.Context, opt CreateSnapshotOption, callOptions ...grpc.CallOption) error

リクエスト構文​

go
option := client.NewCreateSnapshotOption(snapshotName, collectionName).
    WithDescription(description string).
    WithDbName(dbName string)

err := client.CreateSnapshot(option)

パラメータ:

  • snapshotName (string) -

    作成するスナップショットの名前です。これはコレクション内で一意である必要があります。

  • collectionName (string) -

    スナップショットを作成するコレクションの名前です。

ビルダーメソッド:

  • WithDescription(description string)

    スナップショットに、人が読める任意の説明を設定します。

  • WithDbName(dbName string)

    データベース名を設定します。設定しない場合は、デフォルトのデータベースが使用されます。

戻り値の型:

error

戻り値:

成功時は nil を返します。コレクションが存在しない場合、スナップショット名がすでに使用されている場合、またはその他の理由で操作が失敗した場合は error を返します。

例外:

  • error

    失敗の詳細は err != nil を確認してください。

例​

go
import (
	"context"
	"fmt"

	"github.com/milvus-io/milvus/client/v2/milvusclient"
)

ctx, cancel := context.WithCancel(context.Background())
defer cancel()

milvusAddr := "YOUR_CLUSTER_ENDPOINT"

cli, err := milvusclient.New(ctx, &milvusclient.ClientConfig{
	Address: milvusAddr,
})
if err != nil {
	log.Fatal(err)
}

defer cli.Close(ctx)

option := milvusclient.NewCreateSnapshotOption("backup_20260418", "my_collection").
	WithDescription("Daily backup before schema change")

err = cli.CreateSnapshot(ctx, option)
if err != nil {
	// handle error
}

fmt.Println("Snapshot created successfully")
Ctrl I