diff --git a/cmd/restore.go b/cmd/restore.go index 883cef3..ccc061e 100644 --- a/cmd/restore.go +++ b/cmd/restore.go @@ -23,6 +23,8 @@ var ( renameCollectionNames string restoreDatabases string restoreDatabaseCollections string + restoreMetaOnly bool + restoreIndex bool ) var restoreBackupCmd = &cobra.Command{ @@ -78,6 +80,8 @@ var restoreBackupCmd = &cobra.Command{ CollectionSuffix: renameSuffix, CollectionRenames: renameMap, DbCollections: utils.WrapDBCollections(restoreDatabaseCollections), + MetaOnly: restoreMetaOnly, + RestoreIndex: restoreIndex, }) fmt.Println(resp.GetCode(), "\n", resp.GetMsg()) @@ -92,5 +96,8 @@ func init() { restoreBackupCmd.Flags().StringVarP(&restoreDatabases, "databases", "d", "", "databases to restore, if not set, restore all databases") restoreBackupCmd.Flags().StringVarP(&restoreDatabaseCollections, "database_collections", "a", "", "databases and collections to restore, json format: {\"db1\":[\"c1\", \"c2\"],\"db2\":[]}") + restoreBackupCmd.Flags().BoolVarP(&restoreMetaOnly, "meta_only", "", false, "if set true, will restore meta only") + restoreBackupCmd.Flags().BoolVarP(&restoreIndex, "restore_index", "", false, "if set true, will restore index") + rootCmd.AddCommand(restoreBackupCmd) } diff --git a/core/backup_impl_restore_backup.go b/core/backup_impl_restore_backup.go index c511c67..4dbfdbf 100644 --- a/core/backup_impl_restore_backup.go +++ b/core/backup_impl_restore_backup.go @@ -25,6 +25,8 @@ func (b *BackupContext) RestoreBackup(ctx context.Context, request *backuppb.Res log.Info("receive RestoreBackupRequest", zap.String("requestId", request.GetRequestId()), zap.String("backupName", request.GetBackupName()), + zap.Bool("onlyMeta", request.GetMetaOnly()), + zap.Bool("restoreIndex", request.GetRestoreIndex()), zap.Strings("collections", request.GetCollectionNames()), zap.String("CollectionSuffix", request.GetCollectionSuffix()), zap.Any("CollectionRenames", request.GetCollectionRenames()), @@ -277,6 +279,8 @@ func (b *BackupContext) RestoreBackup(ctx context.Context, request *backuppb.Res ToRestoreSize: toRestoreSize, RestoredSize: 0, Progress: 0, + MetaOnly: request.GetMetaOnly(), + RestoreIndex: request.GetRestoreIndex(), } restoreCollectionTasks = append(restoreCollectionTasks, restoreCollectionTask) task.CollectionRestoreTasks = restoreCollectionTasks @@ -424,6 +428,18 @@ func (b *BackupContext) executeRestoreCollectionTask(ctx context.Context, backup zap.String("collectionName", targetCollectionName), zap.Bool("hasPartitionKey", hasPartitionKey)) + if task.GetRestoreIndex() { + indexes := task.GetCollBackup().GetIndexInfos() + for _, index := range indexes { + idx := entity.NewGenericIndex(index.GetIndexName(), entity.IndexType(index.GetIndexType()), index.GetFieldName(), index.GetParams()) + err := b.getMilvusClient().CreateIndex(ctx, targetCollectionName, index.GetFieldName(), idx, true) + if err != nil { + log.Warn("Fail to restore index", zap.Error(err)) + return task, err + } + } + } + tempDir := "restore-temp-" + parentTaskID + SEPERATOR isSameBucket := b.milvusBucketName == backupBucketName // clean the temporary file @@ -491,31 +507,13 @@ func (b *BackupContext) executeRestoreCollectionTask(ctx context.Context, backup return nil } - groupIds := collectGroupIdsFromSegments(partitionBackup.GetSegmentBackups()) - if len(groupIds) == 1 && groupIds[0] == 0 { - // backward compatible old backup without group id - files, err := b.getBackupPartitionPaths(ctx, backupBucketName, backupPath, partitionBackup) - if err != nil { - log.Error("fail to get partition backup binlog files", - zap.Error(err), - zap.String("backupCollectionName", task.GetCollBackup().GetCollectionName()), - zap.String("targetCollectionName", targetCollectionName), - zap.String("partition", partitionBackup.GetPartitionName())) - return task, err - } - err = copyAndBulkInsert(files) - if err != nil { - log.Error("fail to (copy and) bulkinsert data", - zap.Error(err), - zap.String("backupCollectionName", task.GetCollBackup().GetCollectionName()), - zap.String("targetCollectionName", targetCollectionName), - zap.String("partition", partitionBackup.GetPartitionName())) - return task, err - } + if task.GetMetaOnly() { + task.Progress = 100 } else { - // bulk insert by segment groups - for _, groupId := range groupIds { - files, err := b.getBackupPartitionPathsWithGroupID(ctx, backupBucketName, backupPath, partitionBackup, groupId) + groupIds := collectGroupIdsFromSegments(partitionBackup.GetSegmentBackups()) + if len(groupIds) == 1 && groupIds[0] == 0 { + // backward compatible old backup without group id + files, err := b.getBackupPartitionPaths(ctx, backupBucketName, backupPath, partitionBackup) if err != nil { log.Error("fail to get partition backup binlog files", zap.Error(err), @@ -533,13 +531,35 @@ func (b *BackupContext) executeRestoreCollectionTask(ctx context.Context, backup zap.String("partition", partitionBackup.GetPartitionName())) return task, err } + } else { + // bulk insert by segment groups + for _, groupId := range groupIds { + files, err := b.getBackupPartitionPathsWithGroupID(ctx, backupBucketName, backupPath, partitionBackup, groupId) + if err != nil { + log.Error("fail to get partition backup binlog files", + zap.Error(err), + zap.String("backupCollectionName", task.GetCollBackup().GetCollectionName()), + zap.String("targetCollectionName", targetCollectionName), + zap.String("partition", partitionBackup.GetPartitionName())) + return task, err + } + err = copyAndBulkInsert(files) + if err != nil { + log.Error("fail to (copy and) bulkinsert data", + zap.Error(err), + zap.String("backupCollectionName", task.GetCollBackup().GetCollectionName()), + zap.String("targetCollectionName", targetCollectionName), + zap.String("partition", partitionBackup.GetPartitionName())) + return task, err + } + } + } + task.RestoredSize = task.RestoredSize + partitionBackup.GetSize() + if task.ToRestoreSize == 0 { + task.Progress = 100 + } else { + task.Progress = int32(100 * task.RestoredSize / task.ToRestoreSize) } - } - task.RestoredSize = task.RestoredSize + partitionBackup.GetSize() - if task.ToRestoreSize == 0 { - task.Progress = 100 - } else { - task.Progress = int32(100 * task.RestoredSize / task.ToRestoreSize) } } diff --git a/core/proto/backup.proto b/core/proto/backup.proto index c868150..372ca3a 100644 --- a/core/proto/backup.proto +++ b/core/proto/backup.proto @@ -251,6 +251,10 @@ message RestoreBackupRequest { string path = 8; // database and collections to restore. A json string. To support database. 2023.7.7 google.protobuf.Value db_collections = 9; + // if true only restore meta + bool metaOnly = 10; + // if true restore index info + bool restoreIndex = 11; } message RestorePartitionTask { @@ -276,6 +280,10 @@ message RestoreCollectionTask { int64 to_restore_size = 10; int32 progress = 11; string target_db_name = 12; + // if true only restore meta + bool metaOnly = 13; + // if true restore index info + bool restoreIndex = 14; } message RestoreBackupTask { diff --git a/core/proto/backuppb/backup.pb.go b/core/proto/backuppb/backup.pb.go index 8d09915..3e6b3b7 100644 --- a/core/proto/backuppb/backup.pb.go +++ b/core/proto/backuppb/backup.pb.go @@ -1420,10 +1420,14 @@ type RestoreBackupRequest struct { // if bucket_name and path is set. will override bucket/path in config. Path string `protobuf:"bytes,8,opt,name=path,proto3" json:"path,omitempty"` // database and collections to restore. A json string. To support database. 2023.7.7 - DbCollections *_struct.Value `protobuf:"bytes,9,opt,name=db_collections,json=dbCollections,proto3" json:"db_collections,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + DbCollections *_struct.Value `protobuf:"bytes,9,opt,name=db_collections,json=dbCollections,proto3" json:"db_collections,omitempty"` + // if true only restore meta + MetaOnly bool `protobuf:"varint,10,opt,name=metaOnly,proto3" json:"metaOnly,omitempty"` + // if true restore index info + RestoreIndex bool `protobuf:"varint,11,opt,name=restoreIndex,proto3" json:"restoreIndex,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *RestoreBackupRequest) Reset() { *m = RestoreBackupRequest{} } @@ -1514,6 +1518,20 @@ func (m *RestoreBackupRequest) GetDbCollections() *_struct.Value { return nil } +func (m *RestoreBackupRequest) GetMetaOnly() bool { + if m != nil { + return m.MetaOnly + } + return false +} + +func (m *RestoreBackupRequest) GetRestoreIndex() bool { + if m != nil { + return m.RestoreIndex + } + return false +} + type RestorePartitionTask struct { Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"` StateCode RestoreTaskStateCode `protobuf:"varint,2,opt,name=state_code,json=stateCode,proto3,enum=milvus.proto.backup.RestoreTaskStateCode" json:"state_code,omitempty"` @@ -1614,9 +1632,13 @@ type RestoreCollectionTask struct { ToRestoreSize int64 `protobuf:"varint,10,opt,name=to_restore_size,json=toRestoreSize,proto3" json:"to_restore_size"` Progress int32 `protobuf:"varint,11,opt,name=progress,proto3" json:"progress,omitempty"` TargetDbName string `protobuf:"bytes,12,opt,name=target_db_name,json=targetDbName,proto3" json:"target_db_name,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + // if true only restore meta + MetaOnly bool `protobuf:"varint,13,opt,name=metaOnly,proto3" json:"metaOnly,omitempty"` + // if true restore index info + RestoreIndex bool `protobuf:"varint,14,opt,name=restoreIndex,proto3" json:"restoreIndex,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *RestoreCollectionTask) Reset() { *m = RestoreCollectionTask{} } @@ -1728,6 +1750,20 @@ func (m *RestoreCollectionTask) GetTargetDbName() string { return "" } +func (m *RestoreCollectionTask) GetMetaOnly() bool { + if m != nil { + return m.MetaOnly + } + return false +} + +func (m *RestoreCollectionTask) GetRestoreIndex() bool { + if m != nil { + return m.RestoreIndex + } + return false +} + type RestoreBackupTask struct { Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"` StateCode RestoreTaskStateCode `protobuf:"varint,2,opt,name=state_code,json=stateCode,proto3,enum=milvus.proto.backup.RestoreTaskStateCode" json:"state_code,omitempty"` @@ -2602,173 +2638,176 @@ func init() { func init() { proto.RegisterFile("backup.proto", fileDescriptor_65240d19de191688) } var fileDescriptor_65240d19de191688 = []byte{ - // 2652 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xdc, 0x5a, 0xcb, 0x73, 0x1b, 0x49, - 0x19, 0xb7, 0x1e, 0x96, 0x34, 0x9f, 0x1e, 0x1e, 0xb7, 0xbd, 0x5e, 0xc5, 0xd9, 0x6c, 0x9c, 0x61, - 0x1f, 0x8e, 0xb7, 0x70, 0xc0, 0xfb, 0x60, 0x37, 0xc5, 0xbe, 0xfc, 0x4a, 0x44, 0xb2, 0x8e, 0x6b, - 0xec, 0xb8, 0x52, 0xcb, 0x63, 0x6a, 0x34, 0xd3, 0x96, 0x87, 0x8c, 0xa6, 0xc5, 0x74, 0x2b, 0xbb, - 0x4a, 0x15, 0xdc, 0xa8, 0xe2, 0xc8, 0x81, 0x13, 0xc5, 0x3f, 0xc0, 0x0d, 0x8a, 0xe2, 0xc2, 0x95, - 0x13, 0x14, 0x17, 0xfe, 0x0a, 0x0a, 0x0e, 0x5c, 0xb9, 0x52, 0xfd, 0x75, 0xcf, 0x68, 0x24, 0x4f, - 0x1c, 0x99, 0xda, 0x62, 0x59, 0x6e, 0xdd, 0xbf, 0xfe, 0xbe, 0xaf, 0xbb, 0xbf, 0x57, 0x7f, 0xf3, - 0x49, 0xd0, 0xe8, 0xba, 0xde, 0xe3, 0xe1, 0x60, 0x73, 0x10, 0x33, 0xc1, 0xc8, 0x52, 0x3f, 0x08, - 0x9f, 0x0c, 0xb9, 0x9a, 0x6d, 0xaa, 0xa5, 0xd5, 0x97, 0x7a, 0x8c, 0xf5, 0x42, 0x7a, 0x0b, 0xc1, - 0xee, 0xf0, 0xf4, 0x16, 0x17, 0xf1, 0xd0, 0x13, 0x8a, 0xc8, 0xfa, 0x5b, 0x01, 0x8c, 0x4e, 0xe4, - 0xd3, 0xcf, 0x3b, 0xd1, 0x29, 0x23, 0xd7, 0x00, 0x4e, 0x03, 0x1a, 0xfa, 0x4e, 0xe4, 0xf6, 0x69, - 0xbb, 0xb0, 0x56, 0x58, 0x37, 0x6c, 0x03, 0x91, 0x03, 0xb7, 0x4f, 0xe5, 0x72, 0x20, 0x69, 0xd5, - 0x72, 0x51, 0x2d, 0x23, 0x32, 0xb9, 0x2c, 0x46, 0x03, 0xda, 0x2e, 0x65, 0x96, 0x8f, 0x47, 0x03, - 0x4a, 0xb6, 0xa1, 0x32, 0x70, 0x63, 0xb7, 0xcf, 0xdb, 0xe5, 0xb5, 0xd2, 0x7a, 0x7d, 0x6b, 0x63, - 0x33, 0xe7, 0xb8, 0x9b, 0xe9, 0x61, 0x36, 0x0f, 0x91, 0x78, 0x2f, 0x12, 0xf1, 0xc8, 0xd6, 0x9c, - 0xab, 0xef, 0x41, 0x3d, 0x03, 0x13, 0x13, 0x4a, 0x8f, 0xe9, 0x48, 0x1f, 0x54, 0x0e, 0xc9, 0x32, - 0xcc, 0x3f, 0x71, 0xc3, 0x61, 0x72, 0x3a, 0x35, 0xb9, 0x5d, 0x7c, 0xb7, 0x60, 0xfd, 0xb5, 0x02, - 0xcb, 0x3b, 0x2c, 0x0c, 0xa9, 0x27, 0x02, 0x16, 0x6d, 0xe3, 0x6e, 0x78, 0xe9, 0x16, 0x14, 0x03, - 0x5f, 0xcb, 0x28, 0x06, 0x3e, 0xb9, 0x03, 0xc0, 0x85, 0x2b, 0xa8, 0xe3, 0x31, 0x5f, 0xc9, 0x69, - 0x6d, 0xad, 0xe7, 0x9e, 0x55, 0x09, 0x39, 0x76, 0xf9, 0xe3, 0x23, 0xc9, 0xb0, 0xc3, 0x7c, 0x6a, - 0x1b, 0x3c, 0x19, 0x12, 0x0b, 0x1a, 0x34, 0x8e, 0x59, 0xfc, 0x09, 0xe5, 0xdc, 0xed, 0x25, 0x1a, - 0x99, 0xc0, 0xa4, 0xce, 0xb8, 0x70, 0x63, 0xe1, 0x88, 0xa0, 0x4f, 0xdb, 0xe5, 0xb5, 0xc2, 0x7a, - 0x09, 0x45, 0xc4, 0xe2, 0x38, 0xe8, 0x53, 0x72, 0x05, 0x6a, 0x34, 0xf2, 0xd5, 0xe2, 0x3c, 0x2e, - 0x56, 0x69, 0xe4, 0xe3, 0xd2, 0x2a, 0xd4, 0x06, 0x31, 0xeb, 0xc5, 0x94, 0xf3, 0x76, 0x65, 0xad, - 0xb0, 0x3e, 0x6f, 0xa7, 0x73, 0xf2, 0x35, 0x68, 0x7a, 0xe9, 0x55, 0x9d, 0xc0, 0x6f, 0x57, 0x91, - 0xb7, 0x31, 0x06, 0x3b, 0x3e, 0x79, 0x11, 0xaa, 0x7e, 0x57, 0x99, 0xb2, 0x86, 0x27, 0xab, 0xf8, - 0x5d, 0xb4, 0xe3, 0xeb, 0xb0, 0x90, 0xe1, 0x46, 0x02, 0x03, 0x09, 0x5a, 0x63, 0x18, 0x09, 0xdf, - 0x87, 0x0a, 0xf7, 0xce, 0x68, 0xdf, 0x6d, 0xc3, 0x5a, 0x61, 0xbd, 0xbe, 0xf5, 0x6a, 0xae, 0x96, - 0xc6, 0x4a, 0x3f, 0x42, 0x62, 0x5b, 0x33, 0xe1, 0xdd, 0xcf, 0xdc, 0xd8, 0xe7, 0x4e, 0x34, 0xec, - 0xb7, 0xeb, 0x78, 0x07, 0x43, 0x21, 0x07, 0xc3, 0x3e, 0xb1, 0x61, 0xd1, 0x63, 0x11, 0x0f, 0xb8, - 0xa0, 0x91, 0x37, 0x72, 0x42, 0xfa, 0x84, 0x86, 0xed, 0x06, 0x9a, 0xe3, 0x59, 0x1b, 0xa5, 0xd4, - 0xf7, 0x25, 0xb1, 0x6d, 0x7a, 0x53, 0x08, 0x79, 0x08, 0x8b, 0x03, 0x37, 0x16, 0x01, 0xde, 0x4c, - 0xb1, 0xf1, 0x76, 0x13, 0xdd, 0x31, 0xdf, 0xc4, 0x87, 0x09, 0xf5, 0xd8, 0x61, 0x6c, 0x73, 0x30, - 0x09, 0x72, 0x72, 0x13, 0x4c, 0x45, 0x8f, 0x96, 0xe2, 0xc2, 0xed, 0x0f, 0xda, 0xad, 0xb5, 0xc2, - 0x7a, 0xd9, 0x5e, 0x50, 0xf8, 0x71, 0x02, 0x13, 0x02, 0x65, 0x1e, 0x3c, 0xa5, 0xed, 0x05, 0xb4, - 0x08, 0x8e, 0xc9, 0x55, 0x30, 0xce, 0x5c, 0xee, 0x60, 0xa8, 0xb4, 0xcd, 0xb5, 0xc2, 0x7a, 0xcd, - 0xae, 0x9d, 0xb9, 0x1c, 0x43, 0x81, 0x7c, 0x08, 0x75, 0x15, 0x55, 0x41, 0x74, 0xca, 0x78, 0x7b, - 0x11, 0x0f, 0xfb, 0xf2, 0xc5, 0xb1, 0x63, 0xab, 0x40, 0x94, 0x43, 0x2e, 0xd5, 0x1c, 0x32, 0xd7, - 0x77, 0xd0, 0x31, 0xdb, 0x44, 0x85, 0xa5, 0x44, 0xd0, 0x69, 0xc9, 0x6d, 0xb8, 0xa2, 0xcf, 0x3e, - 0x38, 0x1b, 0xf1, 0xc0, 0x73, 0xc3, 0xcc, 0x25, 0x96, 0xf0, 0x12, 0x2f, 0x2a, 0x82, 0x43, 0xbd, - 0x9e, 0x5e, 0xc6, 0xfa, 0x59, 0x11, 0x96, 0x72, 0x34, 0x44, 0x6e, 0x40, 0x63, 0xac, 0x66, 0x1d, - 0x5c, 0x25, 0xbb, 0x9e, 0x62, 0x1d, 0x9f, 0xbc, 0x0a, 0xad, 0x31, 0x49, 0x26, 0x9f, 0x34, 0x53, - 0x14, 0x5d, 0xec, 0x9c, 0x27, 0x97, 0x72, 0x3c, 0xf9, 0x01, 0x2c, 0x70, 0xda, 0xeb, 0xd3, 0x48, - 0xa4, 0x36, 0x55, 0x29, 0xe6, 0xb5, 0x5c, 0x35, 0x1d, 0x29, 0xda, 0x8c, 0x45, 0x5b, 0x3c, 0x0b, - 0xf1, 0xd4, 0x48, 0xf3, 0x19, 0x23, 0x4d, 0xaa, 0xb1, 0x32, 0xa5, 0x46, 0xeb, 0xa7, 0x25, 0x58, - 0x3c, 0x27, 0x18, 0x5d, 0x5c, 0x9f, 0x2c, 0x55, 0x83, 0xa1, 0x91, 0x8e, 0x7f, 0xfe, 0x76, 0xc5, - 0x9c, 0xdb, 0x4d, 0x2b, 0xb3, 0x74, 0x5e, 0x99, 0x2f, 0x43, 0x3d, 0x1a, 0xf6, 0x1d, 0x76, 0xea, - 0xc4, 0xec, 0x33, 0x9e, 0xa4, 0x91, 0x68, 0xd8, 0x7f, 0x70, 0x6a, 0xb3, 0xcf, 0x38, 0xb9, 0x0d, - 0xd5, 0x6e, 0x10, 0x85, 0xac, 0xc7, 0xdb, 0xf3, 0xa8, 0x98, 0xb5, 0x5c, 0xc5, 0xec, 0xcb, 0x4c, - 0xbf, 0x8d, 0x84, 0x76, 0xc2, 0x40, 0x3e, 0x00, 0x4c, 0x69, 0x1c, 0xb9, 0x2b, 0x33, 0x72, 0x8f, - 0x59, 0x24, 0xbf, 0x4f, 0x43, 0xe1, 0x22, 0x7f, 0x75, 0x56, 0xfe, 0x94, 0x25, 0xb5, 0x45, 0x2d, - 0x63, 0x8b, 0x2b, 0x50, 0xeb, 0xc5, 0x6c, 0x38, 0x90, 0xea, 0x30, 0x54, 0x5a, 0xc4, 0x79, 0xc7, - 0xb7, 0x7e, 0x57, 0x02, 0xf8, 0xff, 0x4e, 0xee, 0x04, 0xca, 0x18, 0x2f, 0x55, 0xdc, 0x11, 0xc7, - 0xb9, 0x09, 0xa8, 0x96, 0x9f, 0x80, 0x1e, 0x01, 0xc9, 0xf8, 0x5c, 0x12, 0x2f, 0x06, 0x1a, 0xe6, - 0xe6, 0x73, 0x12, 0x78, 0x26, 0x64, 0x16, 0xbd, 0x29, 0x74, 0x6c, 0x29, 0xc8, 0x58, 0xea, 0x55, - 0x68, 0x29, 0x91, 0xce, 0x13, 0x1a, 0xf3, 0x80, 0x45, 0x98, 0xe7, 0x0d, 0xbb, 0xa9, 0xd0, 0x13, - 0x05, 0x5a, 0xdf, 0x83, 0x2b, 0xe3, 0x5d, 0x30, 0x55, 0x67, 0x6c, 0xf8, 0x21, 0xcc, 0xab, 0xdc, - 0x57, 0xb8, 0xec, 0x21, 0x15, 0x9f, 0xf5, 0x29, 0xb4, 0xd3, 0x2c, 0x35, 0x2d, 0xfc, 0x83, 0x49, - 0xe1, 0xb3, 0xbf, 0x02, 0x5a, 0xf6, 0x09, 0xac, 0xe8, 0xb0, 0x9f, 0x96, 0xfc, 0xed, 0x49, 0xc9, - 0xb3, 0xe6, 0x22, 0x2d, 0xf7, 0x1f, 0x05, 0x58, 0xda, 0x89, 0xa9, 0x2b, 0xa8, 0x5a, 0xb3, 0xe9, - 0x8f, 0x86, 0x94, 0x0b, 0xf2, 0x12, 0x18, 0xb1, 0x1a, 0x76, 0x12, 0xbf, 0x1e, 0x03, 0xe4, 0x3a, - 0xd4, 0xb5, 0x1f, 0x64, 0x52, 0x2a, 0x28, 0xe8, 0x40, 0x3b, 0xca, 0xd4, 0xdb, 0xce, 0xdb, 0xa5, - 0xb5, 0xd2, 0xba, 0x61, 0x2f, 0x4c, 0x3e, 0xee, 0x5c, 0x96, 0x52, 0x2e, 0x1f, 0x45, 0x1e, 0x3a, - 0x6e, 0xcd, 0x56, 0x13, 0xf2, 0x3e, 0xb4, 0xfc, 0xae, 0x33, 0xa6, 0xe5, 0xe8, 0xba, 0xf5, 0xad, - 0x95, 0x4d, 0x55, 0x67, 0x6e, 0x26, 0x75, 0xe6, 0xe6, 0x89, 0x2c, 0xbd, 0xec, 0xa6, 0xdf, 0x1d, - 0x9b, 0x06, 0x85, 0x9e, 0xb2, 0xd8, 0x53, 0x09, 0xb4, 0x66, 0xab, 0x89, 0xf5, 0x9b, 0x02, 0x90, - 0x8c, 0x0a, 0x28, 0x1f, 0xb0, 0x88, 0xd3, 0xe7, 0xdc, 0xf5, 0x6d, 0x28, 0x67, 0x82, 0xf8, 0x46, - 0xae, 0x7a, 0x13, 0x51, 0x18, 0xbd, 0x48, 0x2e, 0x6b, 0xc6, 0x3e, 0xef, 0xe9, 0x78, 0x95, 0x43, - 0xf2, 0x26, 0x94, 0x7d, 0x57, 0xb8, 0x78, 0xcf, 0xfa, 0xd6, 0xf5, 0x0b, 0xb2, 0x01, 0x9e, 0x0e, - 0x89, 0xad, 0x3f, 0x17, 0xc0, 0xbc, 0x43, 0xc5, 0x17, 0x6a, 0x9c, 0xab, 0x60, 0x68, 0x02, 0x9d, - 0xe6, 0x0d, 0xbb, 0xa6, 0x00, 0xcd, 0x3d, 0xf4, 0x1e, 0x53, 0xa1, 0xb8, 0xcb, 0x9a, 0x1b, 0x21, - 0xe4, 0x26, 0x50, 0x1e, 0xb8, 0xe2, 0x0c, 0xed, 0x61, 0xd8, 0x38, 0x96, 0xe1, 0xf7, 0x59, 0x20, - 0xce, 0xd8, 0x50, 0x38, 0x3e, 0x15, 0x6e, 0x10, 0x6a, 0xbd, 0x37, 0x35, 0xba, 0x8b, 0xa0, 0xf5, - 0x5d, 0x20, 0xf7, 0x03, 0x9e, 0x3c, 0x7f, 0xb3, 0xdd, 0x26, 0xa7, 0x4a, 0x2c, 0xe6, 0x55, 0x89, - 0xd6, 0x6f, 0x0b, 0xb0, 0x34, 0x21, 0xfd, 0xcb, 0xb2, 0x6e, 0x69, 0x76, 0xeb, 0x1e, 0xc3, 0xd2, - 0x2e, 0x0d, 0xe9, 0x17, 0x1b, 0x7c, 0xd6, 0x8f, 0x61, 0x79, 0x52, 0xea, 0x7f, 0x55, 0x13, 0xd6, - 0x3f, 0x4b, 0xb0, 0x6c, 0x53, 0x2e, 0x58, 0xfc, 0xa5, 0xe5, 0x94, 0x37, 0x20, 0xf3, 0x6e, 0x38, - 0x7c, 0x78, 0x7a, 0x1a, 0x7c, 0xae, 0x5d, 0x39, 0x23, 0xe3, 0x08, 0x71, 0xc2, 0x26, 0x5e, 0xaa, - 0x98, 0x2a, 0xc9, 0xaa, 0x80, 0xf9, 0xe8, 0x59, 0x6a, 0x38, 0x77, 0xbb, 0xcc, 0xcb, 0x60, 0x2b, - 0x11, 0xea, 0x93, 0x32, 0x73, 0x10, 0x8d, 0x8f, 0x33, 0x5e, 0x25, 0x9b, 0xf1, 0xa6, 0x02, 0xaf, - 0xfa, 0xcc, 0xc0, 0xab, 0x65, 0x02, 0xef, 0x7c, 0x9a, 0x34, 0x2e, 0x91, 0x26, 0x57, 0x77, 0x61, - 0x25, 0xff, 0xd8, 0x97, 0xfa, 0xe4, 0xfd, 0x7d, 0x31, 0x35, 0x78, 0xfa, 0x82, 0xc9, 0x82, 0xe6, - 0x5c, 0x55, 0x74, 0x37, 0xa7, 0x2a, 0xba, 0x79, 0x91, 0x86, 0xff, 0x07, 0xcb, 0xa2, 0x0e, 0x60, - 0x49, 0xac, 0x2b, 0x1a, 0x34, 0xd3, 0x65, 0x9e, 0x73, 0x90, 0xcc, 0x6a, 0x6e, 0xfd, 0xb1, 0x0c, - 0x2f, 0xe8, 0x8b, 0x8e, 0xad, 0xf0, 0x95, 0x56, 0xdc, 0x77, 0xa0, 0x2e, 0x7d, 0x31, 0x51, 0x4e, - 0x05, 0x95, 0x73, 0x89, 0x42, 0x0a, 0x24, 0xb7, 0x9a, 0x93, 0xb7, 0x60, 0x45, 0xb8, 0x71, 0x8f, - 0x0a, 0x67, 0x3a, 0xff, 0xab, 0xd0, 0x58, 0x56, 0xab, 0x3b, 0x93, 0xbd, 0x02, 0x17, 0x5e, 0x1c, - 0x7f, 0xc5, 0xc4, 0x4a, 0x19, 0x8e, 0x70, 0xf9, 0x63, 0xde, 0xae, 0x5d, 0x50, 0xd6, 0xe5, 0xb9, - 0xaf, 0xfd, 0x42, 0x2a, 0x29, 0xa3, 0x55, 0xec, 0x7a, 0x68, 0xc1, 0xbe, 0x83, 0x85, 0xa8, 0xfa, - 0x34, 0x68, 0x24, 0xe0, 0x91, 0x2c, 0x48, 0x5f, 0x83, 0x05, 0xc1, 0xd2, 0x03, 0x64, 0xea, 0xd5, - 0xa6, 0x60, 0x5a, 0x1a, 0xd2, 0x65, 0x5d, 0xad, 0x3e, 0xe5, 0x6a, 0xaf, 0x40, 0x4b, 0x6b, 0x20, - 0x69, 0xa0, 0x34, 0x94, 0xb5, 0x14, 0xba, 0x8b, 0x6d, 0x14, 0xeb, 0x97, 0x25, 0x58, 0x9c, 0x48, - 0x48, 0x5f, 0x69, 0x0f, 0xf2, 0xa1, 0x3d, 0x91, 0x8c, 0xb3, 0x06, 0xac, 0x5c, 0xd0, 0xcf, 0xcb, - 0x8d, 0x23, 0x7b, 0x25, 0x9b, 0x7c, 0x2f, 0x32, 0x61, 0x75, 0x36, 0x13, 0xd6, 0x9e, 0x67, 0x42, - 0x63, 0xd2, 0x84, 0xd6, 0x1f, 0x0a, 0x69, 0x88, 0x7f, 0x29, 0x8f, 0x31, 0xb9, 0x3d, 0x51, 0x74, - 0xbe, 0xf6, 0xfc, 0xe7, 0x0c, 0xf5, 0xa6, 0xaa, 0x93, 0x7d, 0x58, 0xb9, 0x43, 0x45, 0x72, 0x55, - 0xe9, 0x00, 0xb3, 0xbd, 0xe4, 0xca, 0xf7, 0x8a, 0x89, 0xef, 0x59, 0x3f, 0x80, 0x7a, 0xe6, 0xa3, - 0x9b, 0xb4, 0xa1, 0x8a, 0xbd, 0xde, 0xce, 0xae, 0xee, 0x54, 0x24, 0x53, 0xf2, 0xf6, 0xb8, 0x7f, - 0x50, 0x44, 0x5b, 0x5f, 0xcd, 0x2f, 0xa3, 0x26, 0x5b, 0x07, 0xd6, 0xaf, 0x0b, 0x50, 0xd1, 0xb2, - 0xaf, 0x43, 0x9d, 0x46, 0x22, 0x0e, 0xa8, 0x6a, 0xf6, 0x29, 0xf9, 0xa0, 0xa1, 0x83, 0x61, 0x5f, - 0x56, 0xaa, 0xe9, 0xa7, 0xab, 0x73, 0x1a, 0xb3, 0x3e, 0x9e, 0xb3, 0x6c, 0x37, 0x53, 0x74, 0x3f, - 0x66, 0x7d, 0x72, 0x03, 0x1a, 0x63, 0x32, 0xc1, 0x50, 0xa3, 0x65, 0xbb, 0x9e, 0x62, 0xc7, 0x4c, - 0x3a, 0x71, 0xc8, 0x7a, 0x0e, 0x3e, 0xc9, 0xaa, 0xb4, 0xa8, 0x86, 0xac, 0x77, 0x28, 0x5f, 0x65, - 0xbd, 0x94, 0xe9, 0xed, 0xc8, 0x25, 0xe9, 0x2c, 0xd6, 0x3b, 0xd0, 0xb8, 0x47, 0x47, 0xf8, 0x18, - 0x1f, 0xba, 0x41, 0x3c, 0xeb, 0x3b, 0x6b, 0xfd, 0xab, 0x00, 0x80, 0x5c, 0xa8, 0x49, 0x72, 0x0d, - 0x8c, 0x2e, 0x63, 0xa1, 0x83, 0xb6, 0x95, 0xcc, 0xb5, 0xbb, 0x73, 0x76, 0x4d, 0x42, 0xbb, 0xae, - 0x70, 0xc9, 0x55, 0xa8, 0x05, 0x91, 0x50, 0xab, 0x52, 0xcc, 0xfc, 0xdd, 0x39, 0xbb, 0x1a, 0x44, - 0x02, 0x17, 0xaf, 0x81, 0x11, 0xb2, 0xa8, 0xa7, 0x56, 0xb1, 0xcb, 0x23, 0x79, 0x25, 0x84, 0xcb, - 0xd7, 0x01, 0x4e, 0x43, 0xe6, 0x6a, 0x6e, 0x79, 0xb3, 0xe2, 0xdd, 0x39, 0xdb, 0x40, 0x0c, 0x09, - 0x6e, 0x40, 0xdd, 0x67, 0xc3, 0x6e, 0x48, 0x15, 0x85, 0xbc, 0x60, 0xe1, 0xee, 0x9c, 0x0d, 0x0a, - 0x4c, 0x48, 0xb8, 0x88, 0x83, 0x64, 0x13, 0xec, 0x62, 0x49, 0x12, 0x05, 0x26, 0xdb, 0x74, 0x47, - 0x82, 0x72, 0x45, 0x21, 0xe3, 0xaf, 0x21, 0xb7, 0x41, 0x4c, 0x12, 0x6c, 0x57, 0x94, 0xe7, 0x5a, - 0x7f, 0x2f, 0x6b, 0xf7, 0x51, 0x6d, 0xdd, 0x0b, 0xdc, 0x27, 0xe9, 0x58, 0x14, 0x33, 0x1d, 0x8b, - 0x57, 0xa0, 0x15, 0x70, 0x67, 0x10, 0x07, 0x7d, 0x37, 0x1e, 0x39, 0x52, 0xd5, 0x25, 0x2c, 0xba, - 0x1a, 0x01, 0x3f, 0x54, 0xe0, 0x3d, 0x3a, 0x22, 0x6b, 0x50, 0xf7, 0x29, 0xf7, 0xe2, 0x60, 0x20, - 0x53, 0x85, 0x36, 0x67, 0x16, 0x22, 0xb7, 0xc1, 0x90, 0xa7, 0x51, 0xbf, 0x39, 0xcc, 0x63, 0x54, - 0x5e, 0xcb, 0x75, 0x4e, 0x79, 0xf6, 0xe3, 0xd1, 0x80, 0xda, 0x35, 0x5f, 0x8f, 0xc8, 0x36, 0xd4, - 0x25, 0x9b, 0xa3, 0x7f, 0x96, 0x50, 0x69, 0x2c, 0x3f, 0xa6, 0xb3, 0xbe, 0x61, 0x83, 0xe4, 0x52, - 0xbf, 0x43, 0x90, 0x5d, 0x68, 0xa8, 0xf6, 0xac, 0x16, 0x52, 0x9d, 0x55, 0x88, 0xea, 0xea, 0x6a, - 0x29, 0x2b, 0x50, 0x71, 0x87, 0x82, 0x75, 0x76, 0x31, 0x93, 0xd5, 0x6c, 0x3d, 0x23, 0x6f, 0xc3, - 0xbc, 0xea, 0x37, 0x1a, 0x78, 0xb3, 0xeb, 0xcf, 0x6e, 0x9c, 0xa9, 0x34, 0xa0, 0xa8, 0xc9, 0x47, - 0xd0, 0xa0, 0x21, 0xc5, 0xb6, 0x23, 0xea, 0x05, 0x66, 0xd1, 0x4b, 0x5d, 0xb3, 0xa0, 0x6a, 0x76, - 0xa1, 0xe9, 0xd3, 0x53, 0x77, 0x18, 0x0a, 0x47, 0x39, 0x7d, 0xfd, 0x82, 0x8f, 0xe3, 0xb1, 0xff, - 0xdb, 0x0d, 0xcd, 0x85, 0x10, 0xfe, 0x22, 0xc4, 0x1d, 0x7f, 0x14, 0xb9, 0xfd, 0xc0, 0xc3, 0x47, - 0xb2, 0x66, 0x1b, 0x01, 0xdf, 0x55, 0x00, 0x59, 0x07, 0x53, 0xfa, 0x40, 0x5a, 0x16, 0x48, 0x2f, - 0x68, 0x22, 0x51, 0x2b, 0xe0, 0xe9, 0x93, 0x7f, 0x8f, 0x8e, 0xac, 0xbf, 0x14, 0xc0, 0x9c, 0xfe, - 0x1d, 0x21, 0x75, 0xab, 0x42, 0xc6, 0xad, 0xa6, 0x1c, 0xa6, 0x78, 0xde, 0x61, 0xc6, 0xaa, 0x2e, - 0x4d, 0xa8, 0xfa, 0x5d, 0xa8, 0xa0, 0xbf, 0x26, 0xbd, 0xe3, 0x0b, 0x9a, 0x94, 0xc9, 0xef, 0x18, - 0x8a, 0x9e, 0x7c, 0x03, 0x96, 0x69, 0xe4, 0x62, 0xdc, 0xa9, 0x8b, 0x39, 0xb8, 0x80, 0xde, 0x58, - 0xb3, 0x89, 0x5a, 0xd3, 0x77, 0x46, 0x7e, 0xab, 0x05, 0x8d, 0x9d, 0x33, 0xea, 0x3d, 0xd6, 0x69, - 0xdb, 0x7a, 0x04, 0x4d, 0x3d, 0xd7, 0x8f, 0x50, 0xf2, 0xcc, 0x14, 0xfe, 0xa3, 0x67, 0xa6, 0x98, - 0x3e, 0x33, 0x1b, 0x3f, 0x81, 0x46, 0x96, 0x8e, 0xd4, 0xa1, 0x7a, 0x34, 0xf4, 0x3c, 0xca, 0xb9, - 0x39, 0x47, 0x16, 0xa0, 0x7e, 0xc0, 0x84, 0x73, 0x34, 0x1c, 0x0c, 0x58, 0x2c, 0xcc, 0x02, 0x59, - 0x84, 0xe6, 0x01, 0x73, 0x0e, 0x69, 0xdc, 0x0f, 0x38, 0x0f, 0x58, 0x64, 0x16, 0x49, 0x0d, 0xca, - 0xfb, 0x6e, 0x10, 0x9a, 0x25, 0xb2, 0x0c, 0x0b, 0xe8, 0xad, 0x54, 0xd0, 0xd8, 0xd9, 0x93, 0x55, - 0x85, 0xf9, 0xf3, 0x12, 0xb9, 0x06, 0x6d, 0x7d, 0x0b, 0xe7, 0x41, 0xf7, 0x87, 0xd4, 0x13, 0x8e, - 0x14, 0xb9, 0xcf, 0x86, 0x91, 0x6f, 0xfe, 0xa2, 0xb4, 0xf1, 0x39, 0x2c, 0xe5, 0x34, 0x52, 0x09, - 0x81, 0xd6, 0xf6, 0xc7, 0x3b, 0xf7, 0x1e, 0x1e, 0x3a, 0x9d, 0x83, 0xce, 0x71, 0xe7, 0xe3, 0xfb, - 0xe6, 0x1c, 0x59, 0x06, 0x53, 0x63, 0x7b, 0x8f, 0xf6, 0x76, 0x1e, 0x1e, 0x77, 0x0e, 0xee, 0x98, - 0x85, 0x0c, 0xe5, 0xd1, 0xc3, 0x9d, 0x9d, 0xbd, 0xa3, 0x23, 0xb3, 0x28, 0xcf, 0xad, 0xb1, 0xfd, - 0x8f, 0x3b, 0xf7, 0xcd, 0x52, 0x86, 0xe8, 0xb8, 0xf3, 0xc9, 0xde, 0x83, 0x87, 0xc7, 0x66, 0x79, - 0xe3, 0x24, 0xfd, 0xf6, 0x99, 0xdc, 0xba, 0x0e, 0xd5, 0xf1, 0x9e, 0x4d, 0x30, 0xb2, 0x9b, 0x49, - 0xed, 0xa4, 0xbb, 0xc8, 0x9b, 0x2b, 0xf1, 0x75, 0xa8, 0x8e, 0xe5, 0x3e, 0x92, 0x9e, 0x38, 0xf5, - 0xb3, 0x12, 0x40, 0xe5, 0x48, 0xc4, 0x2c, 0xea, 0x99, 0x73, 0x28, 0x83, 0x2a, 0xed, 0xa1, 0xc0, - 0x6d, 0xa9, 0x0a, 0xea, 0x9b, 0x45, 0xd2, 0x02, 0xd8, 0x7b, 0x42, 0x23, 0x31, 0x74, 0xc3, 0x70, - 0x64, 0x96, 0xe4, 0x7c, 0x67, 0xc8, 0x05, 0xeb, 0x07, 0x4f, 0xa9, 0x6f, 0x96, 0x37, 0x7e, 0x55, - 0x80, 0x5a, 0x12, 0x8d, 0x72, 0xf7, 0x03, 0x16, 0x51, 0x73, 0x4e, 0x8e, 0xb6, 0x19, 0x0b, 0xcd, - 0x82, 0x1c, 0x75, 0x22, 0xf1, 0xae, 0x59, 0x24, 0x06, 0xcc, 0x77, 0x22, 0xf1, 0xcd, 0x77, 0xcc, - 0x92, 0x1e, 0xbe, 0xb9, 0x65, 0x96, 0xf5, 0xf0, 0x9d, 0xb7, 0xcc, 0x79, 0x39, 0xdc, 0x97, 0x0f, - 0x83, 0x09, 0xf2, 0x70, 0xbb, 0xf8, 0x02, 0x98, 0x75, 0x7d, 0xd0, 0x20, 0xea, 0x99, 0xcb, 0xf2, - 0x6c, 0x27, 0x6e, 0xbc, 0x73, 0xe6, 0xc6, 0xe6, 0x0b, 0xc4, 0x84, 0xc6, 0x76, 0x10, 0xb9, 0xf1, - 0xe8, 0x84, 0x7a, 0x82, 0xc5, 0xa6, 0x2f, 0x95, 0x8c, 0x12, 0x34, 0x40, 0x37, 0x4e, 0x00, 0xc6, - 0x99, 0x46, 0x32, 0xe0, 0x4c, 0xf5, 0x28, 0x7d, 0x73, 0x4e, 0x3a, 0xcf, 0x18, 0x91, 0x5b, 0x14, - 0x52, 0x68, 0x37, 0x66, 0x83, 0x81, 0x84, 0x8a, 0x29, 0x1f, 0x42, 0xd4, 0x37, 0x4b, 0x5b, 0x7f, - 0x9a, 0x87, 0xa5, 0x4f, 0xd0, 0xbf, 0x95, 0xa7, 0x1c, 0xd1, 0xf8, 0x49, 0xe0, 0x51, 0xe2, 0x41, - 0x23, 0xdb, 0x00, 0x25, 0xf9, 0xdf, 0x72, 0x39, 0x3d, 0xd2, 0xd5, 0xd7, 0x9f, 0xd7, 0xe4, 0xd1, - 0x11, 0x61, 0xcd, 0x91, 0xef, 0x83, 0x91, 0x76, 0xf1, 0x48, 0xfe, 0xcf, 0x8a, 0xd3, 0x5d, 0xbe, - 0xcb, 0x88, 0xef, 0x42, 0x3d, 0xd3, 0xfa, 0x22, 0xf9, 0x9c, 0xe7, 0x5b, 0x6f, 0xab, 0xeb, 0xcf, - 0x27, 0x4c, 0xf7, 0xa0, 0xd0, 0xc8, 0x76, 0x95, 0x9e, 0xa1, 0xa7, 0x9c, 0x76, 0xd6, 0xea, 0xcd, - 0x19, 0x28, 0xd3, 0x6d, 0xce, 0xa0, 0x39, 0x51, 0x8f, 0x92, 0x9b, 0x33, 0xb7, 0x60, 0x56, 0x37, - 0x66, 0x21, 0x4d, 0x77, 0xea, 0x01, 0x8c, 0xcb, 0x5b, 0xf2, 0xc6, 0xb3, 0x8c, 0x92, 0x53, 0xff, - 0x5e, 0x72, 0xa3, 0x43, 0x98, 0xc7, 0xb4, 0x4b, 0xf2, 0x13, 0x6c, 0x36, 0x45, 0xaf, 0x5a, 0x17, - 0x91, 0x24, 0x12, 0xb7, 0xdf, 0xfb, 0xf4, 0x5b, 0xbd, 0x40, 0x9c, 0x0d, 0xbb, 0x9b, 0x1e, 0xeb, - 0xdf, 0x7a, 0x1a, 0x84, 0x61, 0xf0, 0x54, 0x50, 0xef, 0xec, 0x96, 0x62, 0xfe, 0xba, 0x62, 0xbb, - 0xe5, 0xb1, 0x58, 0xff, 0x21, 0xe3, 0x96, 0x42, 0x06, 0xdd, 0x6e, 0x05, 0xe7, 0x6f, 0xfe, 0x3b, - 0x00, 0x00, 0xff, 0xff, 0x81, 0x23, 0xbf, 0xea, 0xd3, 0x21, 0x00, 0x00, + // 2690 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xdc, 0x5a, 0x4b, 0x6f, 0x24, 0x49, + 0x11, 0x76, 0xbf, 0xbb, 0xa2, 0x1f, 0x2e, 0xa7, 0xbd, 0xde, 0x1e, 0xcf, 0xce, 0x8e, 0xa7, 0xd8, + 0x87, 0xc7, 0x2b, 0x3c, 0xe0, 0x7d, 0xb0, 0x3b, 0x62, 0x5f, 0x7e, 0xcd, 0x34, 0x33, 0xeb, 0xb1, + 0xca, 0x1e, 0x6b, 0xb4, 0x3c, 0x4a, 0xd5, 0x5d, 0xe9, 0x76, 0x31, 0xd5, 0x95, 0x4d, 0x65, 0xf6, + 0xec, 0xf6, 0x48, 0x70, 0x41, 0x48, 0x1c, 0x39, 0x70, 0x42, 0xfc, 0x01, 0x2e, 0x08, 0x84, 0xb8, + 0xf0, 0x0f, 0x40, 0x5c, 0xf8, 0x15, 0x08, 0xfe, 0x00, 0x57, 0x94, 0x91, 0x59, 0xd5, 0xd5, 0xed, + 0xb2, 0xdd, 0x46, 0x2b, 0x96, 0xe5, 0x96, 0x19, 0x19, 0x11, 0x99, 0x19, 0xf1, 0x45, 0x64, 0x54, + 0x74, 0x43, 0xbd, 0xe3, 0x76, 0x9f, 0x0e, 0x07, 0x1b, 0x83, 0x88, 0x09, 0x46, 0x16, 0xfb, 0x7e, + 0xf0, 0x6c, 0xc8, 0xd5, 0x6c, 0x43, 0x2d, 0xad, 0xbc, 0xd4, 0x63, 0xac, 0x17, 0xd0, 0x3b, 0x48, + 0xec, 0x0c, 0x4f, 0xee, 0x70, 0x11, 0x0d, 0xbb, 0x42, 0x31, 0x59, 0x7f, 0xcf, 0x81, 0xd1, 0x0e, + 0x3d, 0xfa, 0x79, 0x3b, 0x3c, 0x61, 0xe4, 0x06, 0xc0, 0x89, 0x4f, 0x03, 0xcf, 0x09, 0xdd, 0x3e, + 0x6d, 0xe5, 0x56, 0x73, 0x6b, 0x86, 0x6d, 0x20, 0x65, 0xdf, 0xed, 0x53, 0xb9, 0xec, 0x4b, 0x5e, + 0xb5, 0x9c, 0x57, 0xcb, 0x48, 0x99, 0x5c, 0x16, 0xa3, 0x01, 0x6d, 0x15, 0x52, 0xcb, 0x47, 0xa3, + 0x01, 0x25, 0x5b, 0x50, 0x1e, 0xb8, 0x91, 0xdb, 0xe7, 0xad, 0xe2, 0x6a, 0x61, 0xad, 0xb6, 0xb9, + 0xbe, 0x91, 0x71, 0xdc, 0x8d, 0xe4, 0x30, 0x1b, 0x07, 0xc8, 0xbc, 0x1b, 0x8a, 0x68, 0x64, 0x6b, + 0xc9, 0x95, 0xf7, 0xa0, 0x96, 0x22, 0x13, 0x13, 0x0a, 0x4f, 0xe9, 0x48, 0x1f, 0x54, 0x0e, 0xc9, + 0x12, 0x94, 0x9e, 0xb9, 0xc1, 0x30, 0x3e, 0x9d, 0x9a, 0xdc, 0xcd, 0xbf, 0x9b, 0xb3, 0xfe, 0x56, + 0x86, 0xa5, 0x6d, 0x16, 0x04, 0xb4, 0x2b, 0x7c, 0x16, 0x6e, 0xe1, 0x6e, 0x78, 0xe9, 0x26, 0xe4, + 0x7d, 0x4f, 0xeb, 0xc8, 0xfb, 0x1e, 0xb9, 0x07, 0xc0, 0x85, 0x2b, 0xa8, 0xd3, 0x65, 0x9e, 0xd2, + 0xd3, 0xdc, 0x5c, 0xcb, 0x3c, 0xab, 0x52, 0x72, 0xe4, 0xf2, 0xa7, 0x87, 0x52, 0x60, 0x9b, 0x79, + 0xd4, 0x36, 0x78, 0x3c, 0x24, 0x16, 0xd4, 0x69, 0x14, 0xb1, 0xe8, 0x13, 0xca, 0xb9, 0xdb, 0x8b, + 0x2d, 0x32, 0x41, 0x93, 0x36, 0xe3, 0xc2, 0x8d, 0x84, 0x23, 0xfc, 0x3e, 0x6d, 0x15, 0x57, 0x73, + 0x6b, 0x05, 0x54, 0x11, 0x89, 0x23, 0xbf, 0x4f, 0xc9, 0x35, 0xa8, 0xd2, 0xd0, 0x53, 0x8b, 0x25, + 0x5c, 0xac, 0xd0, 0xd0, 0xc3, 0xa5, 0x15, 0xa8, 0x0e, 0x22, 0xd6, 0x8b, 0x28, 0xe7, 0xad, 0xf2, + 0x6a, 0x6e, 0xad, 0x64, 0x27, 0x73, 0xf2, 0x35, 0x68, 0x74, 0x93, 0xab, 0x3a, 0xbe, 0xd7, 0xaa, + 0xa0, 0x6c, 0x7d, 0x4c, 0x6c, 0x7b, 0xe4, 0x45, 0xa8, 0x78, 0x1d, 0xe5, 0xca, 0x2a, 0x9e, 0xac, + 0xec, 0x75, 0xd0, 0x8f, 0xaf, 0xc3, 0x7c, 0x4a, 0x1a, 0x19, 0x0c, 0x64, 0x68, 0x8e, 0xc9, 0xc8, + 0xf8, 0x3e, 0x94, 0x79, 0xf7, 0x94, 0xf6, 0xdd, 0x16, 0xac, 0xe6, 0xd6, 0x6a, 0x9b, 0xaf, 0x66, + 0x5a, 0x69, 0x6c, 0xf4, 0x43, 0x64, 0xb6, 0xb5, 0x10, 0xde, 0xfd, 0xd4, 0x8d, 0x3c, 0xee, 0x84, + 0xc3, 0x7e, 0xab, 0x86, 0x77, 0x30, 0x14, 0x65, 0x7f, 0xd8, 0x27, 0x36, 0x2c, 0x74, 0x59, 0xc8, + 0x7d, 0x2e, 0x68, 0xd8, 0x1d, 0x39, 0x01, 0x7d, 0x46, 0x83, 0x56, 0x1d, 0xdd, 0x71, 0xde, 0x46, + 0x09, 0xf7, 0x43, 0xc9, 0x6c, 0x9b, 0xdd, 0x29, 0x0a, 0x79, 0x0c, 0x0b, 0x03, 0x37, 0x12, 0x3e, + 0xde, 0x4c, 0x89, 0xf1, 0x56, 0x03, 0xe1, 0x98, 0xed, 0xe2, 0x83, 0x98, 0x7b, 0x0c, 0x18, 0xdb, + 0x1c, 0x4c, 0x12, 0x39, 0xb9, 0x0d, 0xa6, 0xe2, 0x47, 0x4f, 0x71, 0xe1, 0xf6, 0x07, 0xad, 0xe6, + 0x6a, 0x6e, 0xad, 0x68, 0xcf, 0x2b, 0xfa, 0x51, 0x4c, 0x26, 0x04, 0x8a, 0xdc, 0x7f, 0x4e, 0x5b, + 0xf3, 0xe8, 0x11, 0x1c, 0x93, 0xeb, 0x60, 0x9c, 0xba, 0xdc, 0xc1, 0x50, 0x69, 0x99, 0xab, 0xb9, + 0xb5, 0xaa, 0x5d, 0x3d, 0x75, 0x39, 0x86, 0x02, 0xf9, 0x10, 0x6a, 0x2a, 0xaa, 0xfc, 0xf0, 0x84, + 0xf1, 0xd6, 0x02, 0x1e, 0xf6, 0xe5, 0x8b, 0x63, 0xc7, 0x56, 0x81, 0x28, 0x87, 0x5c, 0x9a, 0x39, + 0x60, 0xae, 0xe7, 0x20, 0x30, 0x5b, 0x44, 0x85, 0xa5, 0xa4, 0x20, 0x68, 0xc9, 0x5d, 0xb8, 0xa6, + 0xcf, 0x3e, 0x38, 0x1d, 0x71, 0xbf, 0xeb, 0x06, 0xa9, 0x4b, 0x2c, 0xe2, 0x25, 0x5e, 0x54, 0x0c, + 0x07, 0x7a, 0x3d, 0xb9, 0x8c, 0xf5, 0xf3, 0x3c, 0x2c, 0x66, 0x58, 0x88, 0xdc, 0x82, 0xfa, 0xd8, + 0xcc, 0x3a, 0xb8, 0x0a, 0x76, 0x2d, 0xa1, 0xb5, 0x3d, 0xf2, 0x2a, 0x34, 0xc7, 0x2c, 0xa9, 0x7c, + 0xd2, 0x48, 0xa8, 0x08, 0xb1, 0x33, 0x48, 0x2e, 0x64, 0x20, 0xf9, 0x11, 0xcc, 0x73, 0xda, 0xeb, + 0xd3, 0x50, 0x24, 0x3e, 0x55, 0x29, 0xe6, 0xb5, 0x4c, 0x33, 0x1d, 0x2a, 0xde, 0x94, 0x47, 0x9b, + 0x3c, 0x4d, 0xe2, 0x89, 0x93, 0x4a, 0x29, 0x27, 0x4d, 0x9a, 0xb1, 0x3c, 0x65, 0x46, 0xeb, 0x67, + 0x05, 0x58, 0x38, 0xa3, 0x18, 0x21, 0xae, 0x4f, 0x96, 0x98, 0xc1, 0xd0, 0x94, 0xb6, 0x77, 0xf6, + 0x76, 0xf9, 0x8c, 0xdb, 0x4d, 0x1b, 0xb3, 0x70, 0xd6, 0x98, 0x2f, 0x43, 0x2d, 0x1c, 0xf6, 0x1d, + 0x76, 0xe2, 0x44, 0xec, 0x33, 0x1e, 0xa7, 0x91, 0x70, 0xd8, 0x7f, 0x74, 0x62, 0xb3, 0xcf, 0x38, + 0xb9, 0x0b, 0x95, 0x8e, 0x1f, 0x06, 0xac, 0xc7, 0x5b, 0x25, 0x34, 0xcc, 0x6a, 0xa6, 0x61, 0xf6, + 0x64, 0xa6, 0xdf, 0x42, 0x46, 0x3b, 0x16, 0x20, 0x1f, 0x00, 0xa6, 0x34, 0x8e, 0xd2, 0xe5, 0x19, + 0xa5, 0xc7, 0x22, 0x52, 0xde, 0xa3, 0x81, 0x70, 0x51, 0xbe, 0x32, 0xab, 0x7c, 0x22, 0x92, 0xf8, + 0xa2, 0x9a, 0xf2, 0xc5, 0x35, 0xa8, 0xf6, 0x22, 0x36, 0x1c, 0x48, 0x73, 0x18, 0x2a, 0x2d, 0xe2, + 0xbc, 0xed, 0x59, 0x7f, 0x28, 0x00, 0xfc, 0x7f, 0x27, 0x77, 0x02, 0x45, 0x8c, 0x97, 0x0a, 0xee, + 0x88, 0xe3, 0xcc, 0x04, 0x54, 0xcd, 0x4e, 0x40, 0x4f, 0x80, 0xa4, 0x30, 0x17, 0xc7, 0x8b, 0x81, + 0x8e, 0xb9, 0x7d, 0x49, 0x02, 0x4f, 0x85, 0xcc, 0x42, 0x77, 0x8a, 0x3a, 0xf6, 0x14, 0xa4, 0x3c, + 0xf5, 0x2a, 0x34, 0x95, 0x4a, 0xe7, 0x19, 0x8d, 0xb8, 0xcf, 0x42, 0xcc, 0xf3, 0x86, 0xdd, 0x50, + 0xd4, 0x63, 0x45, 0xb4, 0xbe, 0x07, 0xd7, 0xc6, 0xbb, 0x60, 0xaa, 0x4e, 0xf9, 0xf0, 0x43, 0x28, + 0xa9, 0xdc, 0x97, 0xbb, 0xea, 0x21, 0x95, 0x9c, 0xf5, 0x29, 0xb4, 0x92, 0x2c, 0x35, 0xad, 0xfc, + 0x83, 0x49, 0xe5, 0xb3, 0xbf, 0x02, 0x5a, 0xf7, 0x31, 0x2c, 0xeb, 0xb0, 0x9f, 0xd6, 0xfc, 0xed, + 0x49, 0xcd, 0xb3, 0xe6, 0x22, 0xad, 0xf7, 0x9f, 0x39, 0x58, 0xdc, 0x8e, 0xa8, 0x2b, 0xa8, 0x5a, + 0xb3, 0xe9, 0x8f, 0x86, 0x94, 0x0b, 0xf2, 0x12, 0x18, 0x91, 0x1a, 0xb6, 0x63, 0x5c, 0x8f, 0x09, + 0xe4, 0x26, 0xd4, 0x34, 0x0e, 0x52, 0x29, 0x15, 0x14, 0x69, 0x5f, 0x03, 0x65, 0xea, 0x6d, 0xe7, + 0xad, 0xc2, 0x6a, 0x61, 0xcd, 0xb0, 0xe7, 0x27, 0x1f, 0x77, 0x2e, 0x4b, 0x29, 0x97, 0x8f, 0xc2, + 0x2e, 0x02, 0xb7, 0x6a, 0xab, 0x09, 0x79, 0x1f, 0x9a, 0x5e, 0xc7, 0x19, 0xf3, 0x72, 0x84, 0x6e, + 0x6d, 0x73, 0x79, 0x43, 0xd5, 0x99, 0x1b, 0x71, 0x9d, 0xb9, 0x71, 0x2c, 0x4b, 0x2f, 0xbb, 0xe1, + 0x75, 0xc6, 0xae, 0x41, 0xa5, 0x27, 0x2c, 0xea, 0xaa, 0x04, 0x5a, 0xb5, 0xd5, 0xc4, 0xfa, 0x5d, + 0x0e, 0x48, 0xca, 0x04, 0x94, 0x0f, 0x58, 0xc8, 0xe9, 0x25, 0x77, 0x7d, 0x1b, 0x8a, 0xa9, 0x20, + 0xbe, 0x95, 0x69, 0xde, 0x58, 0x15, 0x46, 0x2f, 0xb2, 0xcb, 0x9a, 0xb1, 0xcf, 0x7b, 0x3a, 0x5e, + 0xe5, 0x90, 0xbc, 0x09, 0x45, 0xcf, 0x15, 0x2e, 0xde, 0xb3, 0xb6, 0x79, 0xf3, 0x82, 0x6c, 0x80, + 0xa7, 0x43, 0x66, 0xeb, 0x2f, 0x39, 0x30, 0xef, 0x51, 0xf1, 0x85, 0x3a, 0xe7, 0x3a, 0x18, 0x9a, + 0x41, 0xa7, 0x79, 0xc3, 0xae, 0x2a, 0x82, 0x96, 0x1e, 0x76, 0x9f, 0x52, 0xa1, 0xa4, 0x8b, 0x5a, + 0x1a, 0x49, 0x28, 0x4d, 0xa0, 0x38, 0x70, 0xc5, 0x29, 0xfa, 0xc3, 0xb0, 0x71, 0x2c, 0xc3, 0xef, + 0x33, 0x5f, 0x9c, 0xb2, 0xa1, 0x70, 0x3c, 0x2a, 0x5c, 0x3f, 0xd0, 0x76, 0x6f, 0x68, 0xea, 0x0e, + 0x12, 0xad, 0xef, 0x02, 0x79, 0xe8, 0xf3, 0xf8, 0xf9, 0x9b, 0xed, 0x36, 0x19, 0x55, 0x62, 0x3e, + 0xab, 0x4a, 0xb4, 0x7e, 0x9f, 0x83, 0xc5, 0x09, 0xed, 0x5f, 0x96, 0x77, 0x0b, 0xb3, 0x7b, 0xf7, + 0x08, 0x16, 0x77, 0x68, 0x40, 0xbf, 0xd8, 0xe0, 0xb3, 0x7e, 0x0c, 0x4b, 0x93, 0x5a, 0xff, 0xab, + 0x96, 0xb0, 0x7e, 0x5b, 0x84, 0x25, 0x9b, 0x72, 0xc1, 0xa2, 0x2f, 0x2d, 0xa7, 0xbc, 0x01, 0xa9, + 0x77, 0xc3, 0xe1, 0xc3, 0x93, 0x13, 0xff, 0x73, 0x0d, 0xe5, 0x94, 0x8e, 0x43, 0xa4, 0x13, 0x36, + 0xf1, 0x52, 0x45, 0x54, 0x69, 0x56, 0x05, 0xcc, 0x47, 0xe7, 0x99, 0xe1, 0xcc, 0xed, 0x52, 0x2f, + 0x83, 0xad, 0x54, 0xa8, 0x4f, 0xca, 0xd4, 0x41, 0x34, 0x7d, 0x9c, 0xf1, 0xca, 0xe9, 0x8c, 0x37, + 0x15, 0x78, 0x95, 0x73, 0x03, 0xaf, 0x9a, 0x0a, 0xbc, 0xb3, 0x69, 0xd2, 0xb8, 0x4a, 0x9a, 0x5c, + 0x81, 0x6a, 0x9f, 0x0a, 0xf7, 0x51, 0x18, 0x8c, 0xf0, 0x39, 0xad, 0xda, 0xc9, 0x5c, 0x56, 0x1e, + 0x91, 0xba, 0x27, 0xd6, 0xfb, 0xf8, 0xa0, 0x56, 0xed, 0x09, 0xda, 0xca, 0x0e, 0x2c, 0x67, 0x5f, + 0xfb, 0x4a, 0x9f, 0xcc, 0x7f, 0xcc, 0x27, 0x80, 0x49, 0x5e, 0x40, 0x59, 0x10, 0x9d, 0xa9, 0xaa, + 0xee, 0x67, 0x54, 0x55, 0xb7, 0x2f, 0xf2, 0xd0, 0xff, 0x60, 0x59, 0xd5, 0x06, 0x2c, 0xa9, 0x75, + 0x45, 0x84, 0x6e, 0xbe, 0x4a, 0x39, 0x00, 0x52, 0x58, 0xcd, 0xad, 0x9f, 0x96, 0xe0, 0x05, 0x7d, + 0xd1, 0xb1, 0x17, 0xbe, 0xd2, 0x86, 0xfb, 0x0e, 0xd4, 0x24, 0x96, 0x63, 0xe3, 0x94, 0xd1, 0x38, + 0x57, 0x28, 0xc4, 0x40, 0x4a, 0xab, 0x39, 0x79, 0x0b, 0x96, 0x85, 0x1b, 0xf5, 0xa8, 0x70, 0xa6, + 0xdf, 0x0f, 0x15, 0x5a, 0x4b, 0x6a, 0x75, 0x7b, 0xb2, 0xd7, 0xe0, 0xc2, 0x8b, 0xe3, 0xaf, 0x20, + 0x8d, 0x75, 0x47, 0xb8, 0xfc, 0x29, 0x6f, 0x55, 0x2f, 0x28, 0x0b, 0xb3, 0xe0, 0x6b, 0xbf, 0x90, + 0x68, 0x4a, 0x59, 0x15, 0xbb, 0x26, 0x5a, 0xb1, 0xe7, 0x60, 0x21, 0xab, 0x3e, 0x2d, 0xe2, 0xc8, + 0xf2, 0x0e, 0x65, 0x41, 0xfb, 0x1a, 0xcc, 0x0b, 0x96, 0x1c, 0x20, 0x55, 0xef, 0x36, 0x04, 0xd3, + 0xda, 0x90, 0x2f, 0x0d, 0xb5, 0xda, 0x14, 0xd4, 0x5e, 0x81, 0xa6, 0xb6, 0x40, 0xdc, 0x80, 0xa9, + 0x2b, 0x6f, 0x29, 0xea, 0x8e, 0x6a, 0xc3, 0xa4, 0x73, 0x40, 0xe3, 0x92, 0x1c, 0xd0, 0x3c, 0x9b, + 0x03, 0xac, 0x5f, 0x15, 0x60, 0x61, 0x22, 0x21, 0x7e, 0xa5, 0x11, 0xe8, 0x41, 0x6b, 0xe2, 0x31, + 0x48, 0x03, 0xa0, 0x7c, 0x41, 0x3f, 0x31, 0x33, 0x0e, 0xed, 0xe5, 0x74, 0xf2, 0xbf, 0x08, 0x02, + 0x95, 0xd9, 0x20, 0x50, 0xbd, 0x0c, 0x02, 0xc6, 0x24, 0x04, 0xac, 0x3f, 0xe5, 0x92, 0x14, 0xf1, + 0xa5, 0x14, 0x03, 0xe4, 0xee, 0x44, 0xd1, 0xfb, 0xda, 0xe5, 0xcf, 0x29, 0xda, 0x4d, 0x55, 0x47, + 0x7b, 0xb0, 0x7c, 0x8f, 0x8a, 0xf8, 0xaa, 0x12, 0x00, 0xb3, 0x55, 0x12, 0x0a, 0x7b, 0xf9, 0x18, + 0x7b, 0xd6, 0x0f, 0xa0, 0x96, 0xfa, 0xe8, 0x27, 0x2d, 0xa8, 0x60, 0xaf, 0xb9, 0xbd, 0xa3, 0x3b, + 0x25, 0xf1, 0x94, 0xbc, 0x3d, 0xee, 0x5f, 0xe4, 0xd1, 0xd7, 0xd7, 0xb3, 0xcb, 0xb8, 0xc9, 0xd6, + 0x85, 0xf5, 0x9b, 0x1c, 0x94, 0xb5, 0xee, 0x9b, 0x50, 0xa3, 0xa1, 0x88, 0x7c, 0xaa, 0x9a, 0x8d, + 0x4a, 0x3f, 0x68, 0xd2, 0xfe, 0xb0, 0x2f, 0x2b, 0xe5, 0xe4, 0xd3, 0xd9, 0x39, 0x89, 0x58, 0x1f, + 0xcf, 0x59, 0xb4, 0x1b, 0x09, 0x75, 0x2f, 0x62, 0x7d, 0x72, 0x0b, 0xea, 0x63, 0x36, 0xc1, 0xd0, + 0xa2, 0x45, 0xbb, 0x96, 0xd0, 0x8e, 0x98, 0x04, 0x71, 0xc0, 0x7a, 0x0e, 0x96, 0x04, 0xaa, 0xb4, + 0xa9, 0x04, 0xac, 0x77, 0x20, 0xab, 0x02, 0xbd, 0x94, 0xea, 0x2d, 0xc9, 0x25, 0x09, 0x16, 0xeb, + 0x1d, 0xa8, 0x3f, 0xa0, 0x23, 0x2c, 0x06, 0x0e, 0x5c, 0x3f, 0x9a, 0xf5, 0x9d, 0xb6, 0xfe, 0x95, + 0x03, 0x40, 0x29, 0xb4, 0x24, 0xb9, 0x01, 0x46, 0x87, 0xb1, 0xc0, 0x41, 0xdf, 0x4a, 0xe1, 0xea, + 0xfd, 0x39, 0xbb, 0x2a, 0x49, 0x3b, 0xae, 0x70, 0xc9, 0x75, 0xa8, 0xfa, 0xa1, 0x50, 0xab, 0x52, + 0x4d, 0xe9, 0xfe, 0x9c, 0x5d, 0xf1, 0x43, 0x81, 0x8b, 0x37, 0xc0, 0x08, 0x58, 0xd8, 0x53, 0xab, + 0xd8, 0x65, 0x92, 0xb2, 0x92, 0x84, 0xcb, 0x37, 0x01, 0x4e, 0x02, 0xe6, 0x6a, 0x69, 0x79, 0xb3, + 0xfc, 0xfd, 0x39, 0xdb, 0x40, 0x1a, 0x32, 0xdc, 0x82, 0x9a, 0xc7, 0x86, 0x9d, 0x80, 0x2a, 0x0e, + 0x79, 0xc1, 0xdc, 0xfd, 0x39, 0x1b, 0x14, 0x31, 0x66, 0xe1, 0x22, 0xf2, 0xe3, 0x4d, 0xb0, 0x8b, + 0x26, 0x59, 0x14, 0x31, 0xde, 0xa6, 0x33, 0x12, 0x94, 0x2b, 0x0e, 0x19, 0x7f, 0x75, 0xb9, 0x0d, + 0xd2, 0x24, 0xc3, 0x56, 0x59, 0x21, 0xd7, 0xfa, 0x47, 0x51, 0xc3, 0x47, 0xb5, 0x95, 0x2f, 0x80, + 0x4f, 0xdc, 0x31, 0xc9, 0xa7, 0x3a, 0x26, 0xaf, 0x40, 0xd3, 0xe7, 0xce, 0x20, 0xf2, 0xfb, 0x6e, + 0x34, 0x72, 0xa4, 0xa9, 0x0b, 0x2a, 0x87, 0xfa, 0xfc, 0x40, 0x11, 0x1f, 0xd0, 0x11, 0x59, 0x85, + 0x9a, 0x47, 0x79, 0x37, 0xf2, 0x07, 0x32, 0x55, 0x68, 0x77, 0xa6, 0x49, 0xe4, 0x2e, 0x18, 0xf2, + 0x34, 0xea, 0x37, 0x8f, 0x12, 0x46, 0xe5, 0x8d, 0x4c, 0x70, 0xca, 0xb3, 0x1f, 0x8d, 0x06, 0xd4, + 0xae, 0x7a, 0x7a, 0x44, 0xb6, 0xa0, 0x26, 0xc5, 0x1c, 0xfd, 0xb3, 0x88, 0x4a, 0x63, 0xd9, 0x31, + 0x9d, 0xc6, 0x86, 0x0d, 0x52, 0x4a, 0xfd, 0x0e, 0x42, 0x76, 0xa0, 0xae, 0xda, 0xc3, 0x5a, 0x49, + 0x65, 0x56, 0x25, 0xaa, 0xab, 0xac, 0xb5, 0x2c, 0x43, 0xd9, 0x1d, 0x0a, 0xd6, 0xde, 0xc1, 0x4c, + 0x56, 0xb5, 0xf5, 0x8c, 0xbc, 0x0d, 0x25, 0xd5, 0xef, 0x34, 0xf0, 0x66, 0x37, 0xcf, 0x6f, 0xdc, + 0xa9, 0x34, 0xa0, 0xb8, 0xc9, 0x47, 0x50, 0xa7, 0x01, 0xc5, 0xb6, 0x27, 0xda, 0x05, 0x66, 0xb1, + 0x4b, 0x4d, 0x8b, 0xa0, 0x69, 0x76, 0xa0, 0xe1, 0xd1, 0x13, 0x77, 0x18, 0x08, 0x47, 0x81, 0xbe, + 0x76, 0xc1, 0xc7, 0xf9, 0x18, 0xff, 0x76, 0x5d, 0x4b, 0x21, 0x09, 0x7f, 0x91, 0xe2, 0x8e, 0x37, + 0x0a, 0xdd, 0xbe, 0xdf, 0xc5, 0x47, 0xb6, 0x6a, 0x1b, 0x3e, 0xdf, 0x51, 0x04, 0xb2, 0x06, 0xa6, + 0xc4, 0x40, 0x52, 0x56, 0x48, 0x14, 0xa8, 0x97, 0xb6, 0xe9, 0xf3, 0xa4, 0x64, 0x78, 0x40, 0x47, + 0xd6, 0x5f, 0x73, 0x60, 0x4e, 0xff, 0x8e, 0x91, 0xc0, 0x2a, 0x97, 0x82, 0xd5, 0x14, 0x60, 0xf2, + 0x67, 0x01, 0x33, 0x36, 0x75, 0x61, 0xc2, 0xd4, 0xef, 0x42, 0x19, 0xf1, 0x1a, 0xf7, 0xae, 0x2f, + 0x68, 0x92, 0xc6, 0xbf, 0xa3, 0x28, 0x7e, 0xf2, 0x0d, 0x58, 0xa2, 0xa1, 0x8b, 0x71, 0xa7, 0x2e, + 0xe6, 0xe0, 0x02, 0xa2, 0xb1, 0x6a, 0x13, 0xb5, 0xa6, 0xef, 0x8c, 0xf2, 0x56, 0x13, 0xea, 0xdb, + 0xa7, 0xb4, 0xfb, 0x54, 0xa7, 0x6d, 0xeb, 0x09, 0x34, 0xf4, 0x5c, 0x3f, 0x42, 0xf1, 0x33, 0x93, + 0xfb, 0x8f, 0x9e, 0x99, 0x7c, 0xf2, 0xcc, 0xac, 0xff, 0x04, 0xea, 0x69, 0x3e, 0x52, 0x83, 0xca, + 0xe1, 0xb0, 0xdb, 0xa5, 0x9c, 0x9b, 0x73, 0x64, 0x1e, 0x6a, 0xfb, 0x4c, 0x38, 0x87, 0xc3, 0xc1, + 0x80, 0x45, 0xc2, 0xcc, 0x91, 0x05, 0x68, 0xec, 0x33, 0xe7, 0x80, 0x46, 0x7d, 0x9f, 0x73, 0x9f, + 0x85, 0x66, 0x9e, 0x54, 0xa1, 0xb8, 0xe7, 0xfa, 0x81, 0x59, 0x20, 0x4b, 0x30, 0x8f, 0x68, 0xa5, + 0x82, 0x46, 0xce, 0xae, 0xac, 0x2a, 0xcc, 0x5f, 0x14, 0xc8, 0x0d, 0x68, 0xe9, 0x5b, 0x38, 0x8f, + 0x3a, 0x3f, 0xa4, 0x5d, 0xe1, 0x48, 0x95, 0x7b, 0x6c, 0x18, 0x7a, 0xe6, 0x2f, 0x0b, 0xeb, 0x9f, + 0xc3, 0x62, 0x46, 0x23, 0x97, 0x10, 0x68, 0x6e, 0x7d, 0xbc, 0xfd, 0xe0, 0xf1, 0x81, 0xd3, 0xde, + 0x6f, 0x1f, 0xb5, 0x3f, 0x7e, 0x68, 0xce, 0x91, 0x25, 0x30, 0x35, 0x6d, 0xf7, 0xc9, 0xee, 0xf6, + 0xe3, 0xa3, 0xf6, 0xfe, 0x3d, 0x33, 0x97, 0xe2, 0x3c, 0x7c, 0xbc, 0xbd, 0xbd, 0x7b, 0x78, 0x68, + 0xe6, 0xe5, 0xb9, 0x35, 0x6d, 0xef, 0xe3, 0xf6, 0x43, 0xb3, 0x90, 0x62, 0x3a, 0x6a, 0x7f, 0xb2, + 0xfb, 0xe8, 0xf1, 0x91, 0x59, 0x5c, 0x3f, 0x4e, 0xbe, 0x9d, 0x26, 0xb7, 0xae, 0x41, 0x65, 0xbc, + 0x67, 0x03, 0x8c, 0xf4, 0x66, 0xd2, 0x3a, 0xc9, 0x2e, 0xf2, 0xe6, 0x4a, 0x7d, 0x0d, 0x2a, 0x63, + 0xbd, 0x4f, 0x24, 0x12, 0xa7, 0x7e, 0xd6, 0x02, 0x28, 0x1f, 0x8a, 0x88, 0x85, 0x3d, 0x73, 0x0e, + 0x75, 0x50, 0x65, 0x3d, 0x54, 0xb8, 0x25, 0x4d, 0x41, 0x3d, 0x33, 0x4f, 0x9a, 0x00, 0xbb, 0xcf, + 0x68, 0x28, 0x86, 0x6e, 0x10, 0x8c, 0xcc, 0x82, 0x9c, 0x6f, 0x0f, 0xb9, 0x60, 0x7d, 0xff, 0x39, + 0xf5, 0xcc, 0xe2, 0xfa, 0xaf, 0x73, 0x50, 0x8d, 0xa3, 0x51, 0xee, 0xbe, 0xcf, 0x42, 0x6a, 0xce, + 0xc9, 0xd1, 0x16, 0x63, 0x81, 0x99, 0x93, 0xa3, 0x76, 0x28, 0xde, 0x35, 0xf3, 0xc4, 0x80, 0x52, + 0x3b, 0x14, 0xdf, 0x7c, 0xc7, 0x2c, 0xe8, 0xe1, 0x9b, 0x9b, 0x66, 0x51, 0x0f, 0xdf, 0x79, 0xcb, + 0x2c, 0xc9, 0xe1, 0x9e, 0x7c, 0x18, 0x4c, 0x90, 0x87, 0xdb, 0xc1, 0x17, 0xc0, 0xac, 0xe9, 0x83, + 0xfa, 0x61, 0xcf, 0x5c, 0x92, 0x67, 0x3b, 0x76, 0xa3, 0xed, 0x53, 0x37, 0x32, 0x5f, 0x20, 0x26, + 0xd4, 0xb7, 0xfc, 0xd0, 0x8d, 0x46, 0xc7, 0xb4, 0x2b, 0x58, 0x64, 0x7a, 0xd2, 0xc8, 0xa8, 0x41, + 0x13, 0xe8, 0xfa, 0x31, 0xc0, 0x38, 0xd3, 0x48, 0x01, 0x9c, 0xa9, 0x1e, 0xa9, 0x67, 0xce, 0x49, + 0xf0, 0x8c, 0x29, 0x72, 0x8b, 0x5c, 0x42, 0xda, 0x89, 0xd8, 0x60, 0x20, 0x49, 0xf9, 0x44, 0x0e, + 0x49, 0xd4, 0x33, 0x0b, 0x9b, 0x7f, 0x2e, 0xc1, 0xe2, 0x27, 0x88, 0x6f, 0x85, 0x94, 0x43, 0x1a, + 0x3d, 0xf3, 0xbb, 0x94, 0x74, 0xa1, 0x9e, 0x6e, 0xc0, 0x92, 0xec, 0x6f, 0xc1, 0x8c, 0x1e, 0xed, + 0xca, 0xeb, 0x97, 0x35, 0x99, 0x74, 0x44, 0x58, 0x73, 0xe4, 0xfb, 0x60, 0x24, 0x5d, 0x44, 0x92, + 0xfd, 0xb3, 0xe6, 0x74, 0x97, 0xf1, 0x2a, 0xea, 0x3b, 0x50, 0x4b, 0xb5, 0xde, 0x48, 0xb6, 0xe4, + 0xd9, 0xd6, 0xdf, 0xca, 0xda, 0xe5, 0x8c, 0xc9, 0x1e, 0x14, 0xea, 0xe9, 0xae, 0xd6, 0x39, 0x76, + 0xca, 0x68, 0xa7, 0xad, 0xdc, 0x9e, 0x81, 0x33, 0xd9, 0xe6, 0x14, 0x1a, 0x13, 0xf5, 0x28, 0xb9, + 0x3d, 0x73, 0x0b, 0x68, 0x65, 0x7d, 0x16, 0xd6, 0x64, 0xa7, 0x1e, 0xc0, 0xb8, 0xbc, 0x25, 0x6f, + 0x9c, 0xe7, 0x94, 0x8c, 0xfa, 0xf7, 0x8a, 0x1b, 0x1d, 0x40, 0x09, 0xd3, 0x2e, 0xc9, 0x4e, 0xb0, + 0xe9, 0x14, 0xbd, 0x62, 0x5d, 0xc4, 0x12, 0x6b, 0xdc, 0x7a, 0xef, 0xd3, 0x6f, 0xf5, 0x7c, 0x71, + 0x3a, 0xec, 0x6c, 0x74, 0x59, 0xff, 0xce, 0x73, 0x3f, 0x08, 0xfc, 0xe7, 0x82, 0x76, 0x4f, 0xef, + 0x28, 0xe1, 0xaf, 0x2b, 0xb1, 0x3b, 0x5d, 0x16, 0xe9, 0x3f, 0x84, 0xdc, 0x51, 0x94, 0x41, 0xa7, + 0x53, 0xc6, 0xf9, 0x9b, 0xff, 0x0e, 0x00, 0x00, 0xff, 0xff, 0xc3, 0x98, 0xcb, 0xc0, 0x53, 0x22, + 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. diff --git a/docs/docs.go b/docs/docs.go index 1f52e9a..747a295 100644 --- a/docs/docs.go +++ b/docs/docs.go @@ -499,6 +499,10 @@ const docTemplate = `{ "description": "database and collections to backup. A json string. To support database. 2023.7.7", "type": "string" }, + "force": { + "description": "force backup skip flush, Should make sure data has been stored into disk when using it", + "type": "boolean" + }, "requestId": { "description": "uuid of request, will generate one if not set", "type": "string" @@ -778,6 +782,10 @@ const docTemplate = `{ "description": "database and collections to restore. A json string. To support database. 2023.7.7", "type": "string" }, + "metaOnly": { + "description": "if true only restore meta", + "type": "boolean" + }, "path": { "description": "if bucket_name and path is set. will override bucket/path in config.", "type": "string" @@ -785,6 +793,10 @@ const docTemplate = `{ "requestId": { "description": "uuid of request, will generate one if not set", "type": "string" + }, + "restoreIndex": { + "description": "if true restore index info", + "type": "boolean" } } }, @@ -867,6 +879,10 @@ const docTemplate = `{ "id": { "type": "string" }, + "metaOnly": { + "description": "if true only restore meta", + "type": "boolean" + }, "partition_restore_tasks": { "type": "array", "items": { @@ -876,6 +892,10 @@ const docTemplate = `{ "progress": { "type": "integer" }, + "restoreIndex": { + "description": "if true restore index info", + "type": "boolean" + }, "restored_size": { "type": "integer" }, diff --git a/docs/swagger.json b/docs/swagger.json index 7cade46..a3f4ac7 100644 --- a/docs/swagger.json +++ b/docs/swagger.json @@ -491,6 +491,10 @@ "description": "database and collections to backup. A json string. To support database. 2023.7.7", "type": "string" }, + "force": { + "description": "force backup skip flush, Should make sure data has been stored into disk when using it", + "type": "boolean" + }, "requestId": { "description": "uuid of request, will generate one if not set", "type": "string" @@ -770,6 +774,10 @@ "description": "database and collections to restore. A json string. To support database. 2023.7.7", "type": "string" }, + "metaOnly": { + "description": "if true only restore meta", + "type": "boolean" + }, "path": { "description": "if bucket_name and path is set. will override bucket/path in config.", "type": "string" @@ -777,6 +785,10 @@ "requestId": { "description": "uuid of request, will generate one if not set", "type": "string" + }, + "restoreIndex": { + "description": "if true restore index info", + "type": "boolean" } } }, @@ -859,6 +871,10 @@ "id": { "type": "string" }, + "metaOnly": { + "description": "if true only restore meta", + "type": "boolean" + }, "partition_restore_tasks": { "type": "array", "items": { @@ -868,6 +884,10 @@ "progress": { "type": "integer" }, + "restoreIndex": { + "description": "if true restore index info", + "type": "boolean" + }, "restored_size": { "type": "integer" }, diff --git a/docs/swagger.yaml b/docs/swagger.yaml index fd258e5..4d182a3 100644 --- a/docs/swagger.yaml +++ b/docs/swagger.yaml @@ -166,6 +166,10 @@ definitions: description: database and collections to backup. A json string. To support database. 2023.7.7 type: string + force: + description: force backup skip flush, Should make sure data has been stored + into disk when using it + type: boolean requestId: description: uuid of request, will generate one if not set type: string @@ -370,6 +374,9 @@ definitions: description: database and collections to restore. A json string. To support database. 2023.7.7 type: string + metaOnly: + description: if true only restore meta + type: boolean path: description: if bucket_name and path is set. will override bucket/path in config. @@ -377,6 +384,9 @@ definitions: requestId: description: uuid of request, will generate one if not set type: string + restoreIndex: + description: if true restore index info + type: boolean type: object backuppb.RestoreBackupResponse: properties: @@ -428,12 +438,18 @@ definitions: type: string id: type: string + metaOnly: + description: if true only restore meta + type: boolean partition_restore_tasks: items: $ref: '#/definitions/backuppb.RestorePartitionTask' type: array progress: type: integer + restoreIndex: + description: if true restore index info + type: boolean restored_size: type: integer start_time: diff --git a/example/partition_data/clean_data.py b/example/partition_data/clean_data.py new file mode 100644 index 0000000..41c38ad --- /dev/null +++ b/example/partition_data/clean_data.py @@ -0,0 +1,20 @@ +import os +from pymilvus import ( + connections, + utility, +) + +fmt = "\n=== {:30} ===\n" + +print(fmt.format("start connecting to Milvus")) +host = os.environ.get('MILVUS_HOST') +if host == None: + host = "localhost" +print(fmt.format(f"Milvus host: {host}")) +connections.connect("default", host=host, port="19530") + +print(fmt.format("Drop collection `hello_milvus_part`")) +utility.drop_collection("hello_milvus_part") + +print(fmt.format(f"Drop collection `hello_milvus_part_recover`")) +utility.drop_collection("hello_milvus_part_recover") \ No newline at end of file diff --git a/example/partition_data/prepare_data.py b/example/partition_data/prepare_data.py new file mode 100644 index 0000000..3a00031 --- /dev/null +++ b/example/partition_data/prepare_data.py @@ -0,0 +1,101 @@ +# hello_milvus.py demonstrates the basic operations of PyMilvus, a Python SDK of Milvus. +# 1. connect to Milvus +# 2. create collection +# 3. insert data +# 4. create index +# 5. search, query, and hybrid search on entities +# 6. delete entities by PK +# 7. drop collection +import time +import os +import numpy as np +from pymilvus import ( + connections, + utility, + FieldSchema, CollectionSchema, DataType, + Collection, Partition +) + +fmt = "\n=== {:30} ===\n" +search_latency_fmt = "search latency = {:.4f}s" +dim = 8 + +################################################################################# +# 1. connect to Milvus +# Add a new connection alias `default` for Milvus server in `localhost:19530` +# Actually the "default" alias is a buildin in PyMilvus. +# If the address of Milvus is the same as `localhost:19530`, you can omit all +# parameters and call the method as: `connections.connect()`. +# +# Note: the `using` parameter of the following methods is default to "default". +print(fmt.format("start connecting to Milvus")) + +host = os.environ.get('MILVUS_HOST') +if host == None: + host = "localhost" +print(fmt.format(f"Milvus host: {host}")) +connections.connect("default", host=host, port="19530") + +collection_name = "hello_milvus_part" +has = utility.has_collection(collection_name) +print(f"Does collection hello_milvus_part exist in Milvus: {has}") + +################################################################################# +# 2. create collection +# We're going to create a collection with 3 fields. +# +-+------------+------------+------------------+------------------------------+ +# | | field name | field type | other attributes | field description | +# +-+------------+------------+------------------+------------------------------+ +# |1| "pk" | Int64 | is_primary=True | "primary field" | +# | | | | auto_id=False | | +# +-+------------+------------+------------------+------------------------------+ +# |2| "random" | Double | | "a double field" | +# +-+------------+------------+------------------+------------------------------+ +# |3|"embeddings"| FloatVector| dim=8 | "float vector with dim 8" | +# +-+------------+------------+------------------+------------------------------+ +fields = [ + FieldSchema(name="pk", dtype=DataType.INT64, is_primary=True, auto_id=True), + FieldSchema(name="random", dtype=DataType.DOUBLE), + FieldSchema(name="var", dtype=DataType.VARCHAR, max_length=65535), + FieldSchema(name="embeddings", dtype=DataType.FLOAT_VECTOR, dim=dim) +] + +schema = CollectionSchema(fields, collection_name) + +print(fmt.format(f"Create collection {collection_name}")) +hello_milvus = Collection(collection_name, schema, consistency_level="Strong") +part1 = Partition(collection_name, "part1") +part2 = Partition(collection_name, "part2") + +################################################################################ +# 3. insert data +# We are going to insert 3000 rows of data into `hello_milvus` +# Data to be inserted must be organized in fields. +# +# The insert() method returns: +# - either automatically generated primary keys by Milvus if auto_id=True in the schema; +# - or the existing primary key field from the entities if auto_id=False in the schema. + +print(fmt.format("Start inserting entities")) +rng = np.random.default_rng(seed=19530) + +num_entities = 3000 +entities = [ + # [i for i in range(num_entities)], + rng.random(num_entities).tolist(), # field random, only supports list + [str(i) for i in range(num_entities)], + rng.random((num_entities, dim)), # field embeddings, supports numpy.ndarray and list +] + +num_entities = 6000 +entities2 = [ + # [i for i in range(num_entities)], + rng.random(num_entities).tolist(), # field random, only supports list + [str(i) for i in range(num_entities)], + rng.random((num_entities, dim)), # field embeddings, supports numpy.ndarray and list +] + +insert_result = part1.insert(entities) +insert_result = part2.insert(entities2) +hello_milvus.flush() +print(f"Number of entities in {collection_name}: {hello_milvus.num_entities}") # check the num_entites diff --git a/example/partition_data/verify_data.py b/example/partition_data/verify_data.py new file mode 100644 index 0000000..7f6e239 --- /dev/null +++ b/example/partition_data/verify_data.py @@ -0,0 +1,113 @@ +import time +import os +import numpy as np +from pymilvus import ( + connections, + utility, + FieldSchema, CollectionSchema, DataType, + Collection, +) + +fmt = "\n=== {:30} ===\n" +search_latency_fmt = "search latency = {:.4f}s" +num_entities, dim = 3000, 8 +rng = np.random.default_rng(seed=19530) +entities = [ + # provide the pk field because `auto_id` is set to False + [i for i in range(num_entities)], + rng.random(num_entities).tolist(), # field random, only supports list + rng.random((num_entities, dim)), # field embeddings, supports numpy.ndarray and list +] + +################################################################################ +# 1. get recovered collection hello_milvus_recover +print(fmt.format("start connecting to Milvus")) +host = os.environ.get('MILVUS_HOST') +if host == None: + host = "localhost" +print(fmt.format(f"Milvus host: {host}")) +connections.connect("default", host=host, port="19530") + +recover_collections = ["hello_milvus_part_recover"] + +for recover_collection_name in recover_collections: + has = utility.has_collection(recover_collection_name) + print(f"Does collection {recover_collection_name} exist in Milvus: {has}") + recover_collection = Collection(recover_collection_name) + print(recover_collection.schema) + recover_collection.flush() + + print(f"Number of entities in Milvus: {recover_collection_name} : {recover_collection.num_entities}") # check the num_entites + + ################################################################################ + # 4. create index + # We are going to create an IVF_FLAT index for hello_milvus_recover collection. + # create_index() can only be applied to `FloatVector` and `BinaryVector` fields. + print(fmt.format("Start Creating index IVF_FLAT")) + index = { + "index_type": "IVF_FLAT", + "metric_type": "L2", + "params": {"nlist": 128}, + } + + recover_collection.create_index("embeddings", index) + + ################################################################################ + # 5. search, query, and hybrid search + # After data were inserted into Milvus and indexed, you can perform: + # - search based on vector similarity + # - query based on scalar filtering(boolean, int, etc.) + # - hybrid search based on vector similarity and scalar filtering. + # + + # Before conducting a search or a query, you need to load the data in `hello_milvus` into memory. + print(fmt.format("Start loading")) + recover_collection.load() + + # ----------------------------------------------------------------------------- + # search based on vector similarity + print(fmt.format("Start searching based on vector similarity")) + vectors_to_search = entities[-1][-2:] + search_params = { + "metric_type": "L2", + "params": {"nprobe": 10}, + } + + start_time = time.time() + result = recover_collection.search(vectors_to_search, "embeddings", search_params, limit=3, output_fields=["random"]) + end_time = time.time() + + for hits in result: + for hit in hits: + print(f"hit: {hit}, random field: {hit.entity.get('random')}") + print(search_latency_fmt.format(end_time - start_time)) + + # ----------------------------------------------------------------------------- + # query based on scalar filtering(boolean, int, etc.) + print(fmt.format("Start querying with `random > 0.5`")) + + start_time = time.time() + result = recover_collection.query(expr="random > 0.5", output_fields=["random", "embeddings"]) + end_time = time.time() + + print(f"query result:\n-{result[0]}") + print(search_latency_fmt.format(end_time - start_time)) + + # ----------------------------------------------------------------------------- + # hybrid search + print(fmt.format("Start hybrid searching with `random > 0.5`")) + + start_time = time.time() + result = recover_collection.search(vectors_to_search, "embeddings", search_params, limit=3, expr="random > 0.5", output_fields=["random"]) + end_time = time.time() + + for hits in result: + for hit in hits: + print(f"hit: {hit}, random field: {hit.entity.get('random')}") + print(search_latency_fmt.format(end_time - start_time)) + + ############################################################################### + # 7. drop collection + # Finally, drop the hello_milvus, hello_milvus_recover collection + # print(fmt.format(f"Drop collection {recover_collection_name}")) + # utility.drop_collection(recover_collection_name) \ No newline at end of file diff --git a/example/partition_key_support/clean_data.py b/example/partition_key_support/clean_data.py index 6b5cc1b..dee61a4 100644 --- a/example/partition_key_support/clean_data.py +++ b/example/partition_key_support/clean_data.py @@ -17,4 +17,4 @@ utility.drop_collection("hello_milvus_pk") print(fmt.format(f"Drop collection `hello_milvus_pk_recover`")) -utility.drop_collection("hello_milvus_recover_pk") \ No newline at end of file +utility.drop_collection("hello_milvus_pk_recover") \ No newline at end of file diff --git a/example/partition_key_support/prepare_data.py b/example/partition_key_support/prepare_data.py index 0c6bb12..ec6e7e1 100644 --- a/example/partition_key_support/prepare_data.py +++ b/example/partition_key_support/prepare_data.py @@ -40,15 +40,15 @@ FieldSchema(name="embeddings", dtype=DataType.FLOAT_VECTOR, dim=dim) ] default_schema = CollectionSchema(fields=default_fields, description="test partition-key collection", partition_key_field="key") -hello_milvus = Collection(name="hello_milvus_pk", schema=default_schema, shard_num=1, num_partitions=100) +hello_milvus = Collection(name="hello_milvus_pk", schema=default_schema, shard_num=1, num_partitions=20) -nb = 100 +nb = 20 rng = np.random.default_rng(seed=19530) random_data = rng.random(nb).tolist() vec_data = [[random.random() for _ in range(dim)] for _ in range(nb)] -_len = int(100) +_len = int(20) _str = string.ascii_letters + string.digits _s = _str print("_str size ", len(_str))