2023-10-25 10:49:50 +02:00
use std ::fs ::{ read_dir , read_to_string , remove_file , File } ;
use std ::io ::BufWriter ;
use std ::path ::PathBuf ;
2024-09-05 10:08:38 +02:00
use anyhow ::{ bail , Context } ;
2023-10-25 10:49:50 +02:00
use clap ::{ Parser , Subcommand } ;
use dump ::{ DumpWriter , IndexMetadata } ;
use file_store ::FileStore ;
use meilisearch_auth ::AuthController ;
2023-11-22 18:21:19 +01:00
use meilisearch_types ::heed ::types ::{ SerdeJson , Str } ;
use meilisearch_types ::heed ::{ Database , Env , EnvOpenOptions , RoTxn , RwTxn , Unspecified } ;
2023-10-25 10:49:50 +02:00
use meilisearch_types ::milli ::documents ::{ obkv_to_object , DocumentsBatchReader } ;
2024-09-05 10:08:38 +02:00
use meilisearch_types ::milli ::index ::{ db_name , main_key } ;
2023-10-25 10:49:50 +02:00
use meilisearch_types ::milli ::{ obkv_to_json , BEU32 } ;
use meilisearch_types ::tasks ::{ Status , Task } ;
2024-09-05 10:08:38 +02:00
use meilisearch_types ::versioning ::{ create_version_file , get_version , parse_version } ;
2023-10-25 10:49:50 +02:00
use meilisearch_types ::Index ;
use time ::macros ::format_description ;
use time ::OffsetDateTime ;
use uuid_codec ::UuidCodec ;
mod uuid_codec ;
#[ derive(Parser) ]
#[ command(author, version, about, long_about = None) ]
struct Cli {
/// The database path where the Meilisearch is running.
#[ arg(long, default_value = " data.ms/ " ) ]
db_path : PathBuf ,
#[ command(subcommand) ]
command : Command ,
}
#[ derive(Subcommand) ]
enum Command {
/// Clears the task queue and make it empty.
///
/// This command can be safely executed even if Meilisearch is running and processing tasks.
/// Once the task queue is empty you can restart Meilisearch and no more tasks must be visible,
/// even the ones that were processing. However, it's highly possible that you see the processing
/// tasks in the queue again with an associated internal error message.
ClearTaskQueue ,
/// Exports a dump from the Meilisearch database.
///
/// Make sure to run this command when Meilisearch is not running or running but not processing tasks.
/// If tasks are being processed while a dump is being exported there are chances for the dump to be
/// malformed with missing tasks.
///
/// TODO Verify this claim or make sure it cannot happen and we can export dumps
/// without caring about killing Meilisearch first!
ExportADump {
/// The directory in which the dump will be created.
#[ arg(long, default_value = " dumps/ " ) ]
dump_dir : PathBuf ,
/// Skip dumping the enqueued or processing tasks.
///
/// Can be useful when there are a lot of them and it is not particularly useful
/// to keep them. Note that only the enqueued tasks takes up space so skipping
/// the processed ones is not particularly interesting.
#[ arg(long) ]
skip_enqueued_tasks : bool ,
} ,
2024-09-05 10:08:38 +02:00
/// Attempts to upgrade from one major version to the next without a dump.
///
/// Make sure to run this commmand when Meilisearch is not running!
/// If Meilisearch is running while executing this command, the database could be corrupted
/// (contain data from both the old and the new versions)
///
/// Supported upgrade paths:
///
/// - v1.9.0 -> v1.10.0
OfflineUpgrade {
#[ arg(long) ]
target_version : String ,
} ,
2023-10-25 10:49:50 +02:00
}
fn main ( ) -> anyhow ::Result < ( ) > {
let Cli { db_path , command } = Cli ::parse ( ) ;
2024-09-05 10:08:38 +02:00
let detected_version = get_version ( & db_path ) . context ( " While checking the version file " ) ? ;
2023-10-25 10:49:50 +02:00
match command {
Command ::ClearTaskQueue = > clear_task_queue ( db_path ) ,
Command ::ExportADump { dump_dir , skip_enqueued_tasks } = > {
export_a_dump ( db_path , dump_dir , skip_enqueued_tasks )
}
2024-09-05 10:08:38 +02:00
Command ::OfflineUpgrade { target_version } = > {
let target_version = parse_version ( & target_version ) . context ( " While parsing `--target-version`. Make sure `--target-version` is in the format MAJOR.MINOR.PATCH " ) ? ;
OfflineUpgrade { db_path , current_version : detected_version , target_version } . upgrade ( )
}
2023-10-25 10:49:50 +02:00
}
}
2024-09-05 10:08:38 +02:00
struct OfflineUpgrade {
db_path : PathBuf ,
current_version : ( String , String , String ) ,
target_version : ( String , String , String ) ,
}
impl OfflineUpgrade {
fn upgrade ( self ) -> anyhow ::Result < ( ) > {
// TODO: if we make this process support more versions, introduce a more flexible way of checking for the version
// currently only supports v1.9 to v1.10
let ( current_major , current_minor , current_patch ) = & self . current_version ;
match ( current_major . as_str ( ) , current_minor . as_str ( ) , current_patch . as_str ( ) ) {
( " 1 " , " 9 " , _ ) = > { }
_ = > {
bail! ( " Unsupported current version {current_major}.{current_minor}.{current_patch}. Can only upgrade from v1.9 " )
}
}
let ( target_major , target_minor , target_patch ) = & self . target_version ;
match ( target_major . as_str ( ) , target_minor . as_str ( ) , target_patch . as_str ( ) ) {
( " 1 " , " 10 " , _ ) = > { }
_ = > {
bail! ( " Unsupported target version {target_major}.{target_minor}.{target_patch}. Can only upgrade to v1.10 " )
}
}
println! ( " Upgrading from {current_major} . {current_minor} . {current_patch} to {target_major} . {target_minor} . {target_patch} " ) ;
self . v1_9_to_v1_10 ( ) ? ;
println! ( " Writing VERSION file " ) ;
create_version_file ( & self . db_path , target_major , target_minor , target_patch )
. context ( " while writing VERSION file after the upgrade " ) ? ;
println! ( " Success " ) ;
Ok ( ( ) )
}
fn v1_9_to_v1_10 ( & self ) -> anyhow ::Result < ( ) > {
// 2 changes here
// 1. date format. needs to be done before opening the Index
// 2. REST embedders. We don't support this case right now, so bail
let index_scheduler_path = self . db_path . join ( " tasks " ) ;
let env = unsafe { EnvOpenOptions ::new ( ) . max_dbs ( 100 ) . open ( & index_scheduler_path ) }
. with_context ( | | {
format! ( " While trying to open {:?} " , index_scheduler_path . display ( ) )
} ) ? ;
let mut sched_wtxn = env . write_txn ( ) ? ;
let index_mapping : Database < Str , UuidCodec > =
try_opening_database ( & env , & sched_wtxn , " index-mapping " ) ? ;
let index_stats : Database < UuidCodec , Unspecified > =
try_opening_database ( & env , & sched_wtxn , " index-stats " ) . with_context ( | | {
format! ( " While trying to open {:?} " , index_scheduler_path . display ( ) )
} ) ? ;
let index_count =
index_mapping . len ( & sched_wtxn ) . context ( " while reading the number of indexes " ) ? ;
// FIXME: not ideal, we have to pre-populate all indexes to prevent double borrow of sched_wtxn
// 1. immutably for the iteration
// 2. mutably for updating index stats
let indexes : Vec < _ > = index_mapping
. iter ( & sched_wtxn ) ?
. map ( | res | res . map ( | ( uid , uuid ) | ( uid . to_owned ( ) , uuid ) ) )
. collect ( ) ;
2024-09-05 10:49:59 +02:00
let mut rest_embedders = Vec ::new ( ) ;
let mut unwrapped_indexes = Vec ::new ( ) ;
// check that update can take place
2024-09-05 10:08:38 +02:00
for ( index_index , result ) in indexes . into_iter ( ) . enumerate ( ) {
let ( uid , uuid ) = result ? ;
let index_path = self . db_path . join ( " indexes " ) . join ( uuid . to_string ( ) ) ;
println! (
2024-09-05 10:49:59 +02:00
" [{}/{index_count}]Checking that update can take place for `{uid}` at `{}` " ,
index_index + 1 ,
2024-09-05 10:08:38 +02:00
index_path . display ( )
) ;
let index_env = unsafe {
// FIXME: fetch the 25 magic number from the index file
EnvOpenOptions ::new ( ) . max_dbs ( 25 ) . open ( & index_path ) . with_context ( | | {
format! ( " while opening index {uid} at ' {} ' " , index_path . display ( ) )
} ) ?
} ;
2024-09-05 10:49:59 +02:00
let index_txn = index_env . read_txn ( ) . with_context ( | | {
2024-09-05 10:08:38 +02:00
format! (
" while obtaining a write transaction for index {uid} at {} " ,
index_path . display ( )
)
} ) ? ;
2024-09-05 10:49:59 +02:00
println! ( " \t - Checking for incompatible embedders (REST embedders) " ) ;
let rest_embedders_for_index = find_rest_embedders ( & uid , & index_env , & index_txn ) ? ;
if rest_embedders_for_index . is_empty ( ) {
unwrapped_indexes . push ( ( uid , uuid ) ) ;
} else {
// no need to add to unwrapped indexes because we'll exit early
rest_embedders . push ( ( uid , rest_embedders_for_index ) ) ;
}
}
if ! rest_embedders . is_empty ( ) {
let rest_embedders = rest_embedders
. into_iter ( )
. flat_map ( | ( index , embedders ) | std ::iter ::repeat ( index . clone ( ) ) . zip ( embedders ) )
. map ( | ( index , embedder ) | format! ( " \t - embedder ` {embedder} ` in index ` {index} ` " ) )
. collect ::< Vec < _ > > ( )
. join ( " \n " ) ;
bail! ( " The update cannot take place because there are REST embedder(s). Remove them before proceeding with the update: \n {rest_embedders} \n \n \
The database has not been modified and is still a valid v1 . 9 database . " );
}
println! ( " Update can take place, updating " ) ;
for ( index_index , ( uid , uuid ) ) in unwrapped_indexes . into_iter ( ) . enumerate ( ) {
let index_path = self . db_path . join ( " indexes " ) . join ( uuid . to_string ( ) ) ;
println! (
" [{}/{index_count}]Updating index `{uid}` at `{}` " ,
index_index + 1 ,
index_path . display ( )
) ;
let index_env = unsafe {
// FIXME: fetch the 25 magic number from the index file
EnvOpenOptions ::new ( ) . max_dbs ( 25 ) . open ( & index_path ) . with_context ( | | {
format! ( " while opening index {uid} at ' {} ' " , index_path . display ( ) )
} ) ?
} ;
let mut index_wtxn = index_env . write_txn ( ) . with_context ( | | {
format! (
" while obtaining a write transaction for index `{uid}` at `{}` " ,
index_path . display ( )
)
} ) ? ;
println! ( " \t - Updating index stats " ) ;
2024-09-05 10:08:38 +02:00
update_index_stats ( index_stats , & uid , uuid , & mut sched_wtxn ) ? ;
2024-09-05 10:49:59 +02:00
println! ( " \t - Updating date format " ) ;
2024-09-05 10:08:38 +02:00
update_date_format ( & uid , & index_env , & mut index_wtxn ) ? ;
index_wtxn . commit ( ) . with_context ( | | {
format! (
2024-09-05 10:49:59 +02:00
" while committing the write txn for index `{uid}` at {} " ,
2024-09-05 10:08:38 +02:00
index_path . display ( )
)
} ) ? ;
}
sched_wtxn . commit ( ) . context ( " while committing the write txn for the index-scheduler " ) ? ;
println! ( " Upgrading database succeeded " ) ;
Ok ( ( ) )
}
}
pub mod v1_9 {
pub type FieldDistribution = std ::collections ::BTreeMap < String , u64 > ;
/// The statistics that can be computed from an `Index` object.
#[ derive(serde::Serialize, serde::Deserialize, Debug) ]
pub struct IndexStats {
/// Number of documents in the index.
pub number_of_documents : u64 ,
/// Size taken up by the index' DB, in bytes.
///
/// This includes the size taken by both the used and free pages of the DB, and as the free pages
/// are not returned to the disk after a deletion, this number is typically larger than
/// `used_database_size` that only includes the size of the used pages.
pub database_size : u64 ,
/// Size taken by the used pages of the index' DB, in bytes.
///
/// As the DB backend does not return to the disk the pages that are not currently used by the DB,
/// this value is typically smaller than `database_size`.
pub used_database_size : u64 ,
/// Association of every field name with the number of times it occurs in the documents.
pub field_distribution : FieldDistribution ,
/// Creation date of the index.
pub created_at : time ::OffsetDateTime ,
/// Date of the last update of the index.
pub updated_at : time ::OffsetDateTime ,
}
use serde ::{ Deserialize , Serialize } ;
#[ derive(Debug, Deserialize, Serialize) ]
pub struct IndexEmbeddingConfig {
pub name : String ,
pub config : EmbeddingConfig ,
}
#[ derive(Debug, Clone, Default, serde::Deserialize, serde::Serialize) ]
pub struct EmbeddingConfig {
/// Options of the embedder, specific to each kind of embedder
pub embedder_options : EmbedderOptions ,
}
/// Options of an embedder, specific to each kind of embedder.
#[ derive(Debug, Clone, Hash, PartialEq, Eq, serde::Deserialize, serde::Serialize) ]
pub enum EmbedderOptions {
HuggingFace ( hf ::EmbedderOptions ) ,
OpenAi ( openai ::EmbedderOptions ) ,
Ollama ( ollama ::EmbedderOptions ) ,
UserProvided ( manual ::EmbedderOptions ) ,
Rest ( rest ::EmbedderOptions ) ,
}
impl Default for EmbedderOptions {
fn default ( ) -> Self {
Self ::OpenAi ( openai ::EmbedderOptions { api_key : None , dimensions : None } )
}
}
mod hf {
#[ derive(Debug, Clone, Hash, PartialEq, Eq, serde::Deserialize, serde::Serialize) ]
pub struct EmbedderOptions {
pub model : String ,
pub revision : Option < String > ,
}
2023-10-25 10:49:50 +02:00
}
2024-09-05 10:08:38 +02:00
mod openai {
#[ derive(Debug, Clone, Hash, PartialEq, Eq, serde::Deserialize, serde::Serialize) ]
pub struct EmbedderOptions {
pub api_key : Option < String > ,
pub dimensions : Option < usize > ,
}
}
mod ollama {
#[ derive(Debug, Clone, Hash, PartialEq, Eq, serde::Deserialize, serde::Serialize) ]
pub struct EmbedderOptions {
pub embedding_model : String ,
pub url : Option < String > ,
pub api_key : Option < String > ,
}
}
mod manual {
#[ derive(Debug, Clone, Hash, PartialEq, Eq, serde::Deserialize, serde::Serialize) ]
pub struct EmbedderOptions {
pub dimensions : usize ,
}
}
mod rest {
#[ derive(Debug, Clone, PartialEq, Eq, serde::Deserialize, serde::Serialize, Hash) ]
pub struct EmbedderOptions {
pub api_key : Option < String > ,
pub dimensions : Option < usize > ,
pub url : String ,
pub input_field : Vec < String > ,
// path to the array of embeddings
pub path_to_embeddings : Vec < String > ,
// shape of a single embedding
pub embedding_object : Vec < String > ,
}
}
pub type OffsetDateTime = time ::OffsetDateTime ;
}
pub mod v1_10 {
use crate ::v1_9 ;
pub type FieldDistribution = std ::collections ::BTreeMap < String , u64 > ;
/// The statistics that can be computed from an `Index` object.
#[ derive(serde::Serialize, serde::Deserialize, Debug) ]
pub struct IndexStats {
/// Number of documents in the index.
pub number_of_documents : u64 ,
/// Size taken up by the index' DB, in bytes.
///
/// This includes the size taken by both the used and free pages of the DB, and as the free pages
/// are not returned to the disk after a deletion, this number is typically larger than
/// `used_database_size` that only includes the size of the used pages.
pub database_size : u64 ,
/// Size taken by the used pages of the index' DB, in bytes.
///
/// As the DB backend does not return to the disk the pages that are not currently used by the DB,
/// this value is typically smaller than `database_size`.
pub used_database_size : u64 ,
/// Association of every field name with the number of times it occurs in the documents.
pub field_distribution : FieldDistribution ,
/// Creation date of the index.
#[ serde(with = " time::serde::rfc3339 " ) ]
pub created_at : time ::OffsetDateTime ,
/// Date of the last update of the index.
#[ serde(with = " time::serde::rfc3339 " ) ]
pub updated_at : time ::OffsetDateTime ,
}
impl From < v1_9 ::IndexStats > for IndexStats {
fn from (
v1_9 ::IndexStats {
number_of_documents ,
database_size ,
used_database_size ,
field_distribution ,
created_at ,
updated_at ,
} : v1_9 ::IndexStats ,
) -> Self {
IndexStats {
number_of_documents ,
database_size ,
used_database_size ,
field_distribution ,
created_at ,
updated_at ,
}
}
}
#[ derive(serde::Serialize, serde::Deserialize) ]
#[ serde(transparent) ]
pub struct OffsetDateTime ( #[ serde(with = " time::serde::rfc3339 " ) ] pub time ::OffsetDateTime ) ;
}
fn update_index_stats (
index_stats : Database < UuidCodec , Unspecified > ,
index_uid : & str ,
index_uuid : uuid ::Uuid ,
sched_wtxn : & mut RwTxn ,
) -> anyhow ::Result < ( ) > {
2024-09-05 10:49:59 +02:00
let ctx = | | format! ( " while updating index stats for index ` {index_uid} ` " ) ;
2024-09-05 10:08:38 +02:00
let stats : Option < v1_9 ::IndexStats > = index_stats
. remap_data_type ::< SerdeJson < v1_9 ::IndexStats > > ( )
. get ( sched_wtxn , & index_uuid )
. with_context ( ctx ) ? ;
if let Some ( stats ) = stats {
let stats : v1_10 ::IndexStats = stats . into ( ) ;
index_stats
. remap_data_type ::< SerdeJson < v1_10 ::IndexStats > > ( )
. put ( sched_wtxn , & index_uuid , & stats )
. with_context ( ctx ) ? ;
}
Ok ( ( ) )
}
fn update_date_format (
index_uid : & str ,
index_env : & Env ,
index_wtxn : & mut RwTxn ,
) -> anyhow ::Result < ( ) > {
let main = try_opening_poly_database ( index_env , index_wtxn , db_name ::MAIN )
2024-09-05 10:49:59 +02:00
. with_context ( | | format! ( " while updating date format for index ` {index_uid} ` " ) ) ? ;
2024-09-05 10:08:38 +02:00
date_round_trip ( index_wtxn , index_uid , main , main_key ::CREATED_AT_KEY ) ? ;
date_round_trip ( index_wtxn , index_uid , main , main_key ::UPDATED_AT_KEY ) ? ;
Ok ( ( ) )
}
2024-09-05 10:49:59 +02:00
fn find_rest_embedders (
index_uid : & str ,
index_env : & Env ,
index_txn : & RoTxn ,
) -> anyhow ::Result < Vec < String > > {
2024-09-05 10:08:38 +02:00
let main = try_opening_poly_database ( index_env , index_txn , db_name ::MAIN )
2024-09-05 10:49:59 +02:00
. with_context ( | | format! ( " while checking REST embedders for index ` {index_uid} ` " ) ) ? ;
let mut rest_embedders = vec! [ ] ;
2024-09-05 10:08:38 +02:00
for config in main
. remap_types ::< Str , SerdeJson < Vec < v1_9 ::IndexEmbeddingConfig > > > ( )
. get ( index_txn , main_key ::EMBEDDING_CONFIGS ) ?
. unwrap_or_default ( )
{
if let v1_9 ::EmbedderOptions ::Rest ( _ ) = config . config . embedder_options {
2024-09-05 10:49:59 +02:00
rest_embedders . push ( config . name ) ;
2024-09-05 10:08:38 +02:00
}
}
2024-09-05 10:49:59 +02:00
Ok ( rest_embedders )
2024-09-05 10:08:38 +02:00
}
fn date_round_trip (
wtxn : & mut RwTxn ,
index_uid : & str ,
db : Database < Unspecified , Unspecified > ,
key : & str ,
) -> anyhow ::Result < ( ) > {
let datetime =
db . remap_types ::< Str , SerdeJson < v1_9 ::OffsetDateTime > > ( ) . get ( wtxn , key ) . with_context (
2024-09-05 10:49:59 +02:00
| | format! ( " could not read ` {key} ` while updating date format for index ` {index_uid} ` " ) ,
2024-09-05 10:08:38 +02:00
) ? ;
if let Some ( datetime ) = datetime {
db . remap_types ::< Str , SerdeJson < v1_10 ::OffsetDateTime > > ( )
. put ( wtxn , key , & v1_10 ::OffsetDateTime ( datetime ) )
. with_context ( | | {
2024-09-05 10:49:59 +02:00
format! (
" could not write `{key}` while updating date format for index `{index_uid}` "
)
2024-09-05 10:08:38 +02:00
} ) ? ;
}
Ok ( ( ) )
2023-10-25 10:49:50 +02:00
}
/// Clears the task queue located at `db_path`.
fn clear_task_queue ( db_path : PathBuf ) -> anyhow ::Result < ( ) > {
let path = db_path . join ( " tasks " ) ;
2024-05-16 16:10:55 +02:00
let env = unsafe { EnvOpenOptions ::new ( ) . max_dbs ( 100 ) . open ( & path ) }
2023-10-25 10:49:50 +02:00
. with_context ( | | format! ( " While trying to open {:?} " , path . display ( ) ) ) ? ;
eprintln! ( " Deleting tasks from the database... " ) ;
let mut wtxn = env . write_txn ( ) ? ;
let all_tasks = try_opening_poly_database ( & env , & wtxn , " all-tasks " ) ? ;
let total = all_tasks . len ( & wtxn ) ? ;
let status = try_opening_poly_database ( & env , & wtxn , " status " ) ? ;
let kind = try_opening_poly_database ( & env , & wtxn , " kind " ) ? ;
let index_tasks = try_opening_poly_database ( & env , & wtxn , " index-tasks " ) ? ;
let canceled_by = try_opening_poly_database ( & env , & wtxn , " canceled_by " ) ? ;
let enqueued_at = try_opening_poly_database ( & env , & wtxn , " enqueued-at " ) ? ;
let started_at = try_opening_poly_database ( & env , & wtxn , " started-at " ) ? ;
let finished_at = try_opening_poly_database ( & env , & wtxn , " finished-at " ) ? ;
try_clearing_poly_database ( & mut wtxn , all_tasks , " all-tasks " ) ? ;
try_clearing_poly_database ( & mut wtxn , status , " status " ) ? ;
try_clearing_poly_database ( & mut wtxn , kind , " kind " ) ? ;
try_clearing_poly_database ( & mut wtxn , index_tasks , " index-tasks " ) ? ;
try_clearing_poly_database ( & mut wtxn , canceled_by , " canceled_by " ) ? ;
try_clearing_poly_database ( & mut wtxn , enqueued_at , " enqueued-at " ) ? ;
try_clearing_poly_database ( & mut wtxn , started_at , " started-at " ) ? ;
try_clearing_poly_database ( & mut wtxn , finished_at , " finished-at " ) ? ;
wtxn . commit ( ) . context ( " While committing the transaction " ) ? ;
eprintln! ( " Successfully deleted {total} tasks from the tasks database! " ) ;
eprintln! ( " Deleting the content files from disk... " ) ;
let mut count = 0 usize ;
let update_files = db_path . join ( " update_files " ) ;
let entries = read_dir ( & update_files ) . with_context ( | | {
format! ( " While trying to read the content of {:?} " , update_files . display ( ) )
} ) ? ;
for result in entries {
match result {
Ok ( ent ) = > match remove_file ( ent . path ( ) ) {
Ok ( _ ) = > count + = 1 ,
Err ( e ) = > eprintln! ( " Error while deleting {:?} : {} " , ent . path ( ) . display ( ) , e ) ,
} ,
Err ( e ) = > {
eprintln! ( " Error while reading a file in {:?} : {} " , update_files . display ( ) , e )
}
}
}
2024-04-18 08:12:52 +02:00
eprintln! ( " Successfully deleted {count} content files from disk! " ) ;
2023-10-25 10:49:50 +02:00
Ok ( ( ) )
}
fn try_opening_database < KC : 'static , DC : 'static > (
env : & Env ,
rtxn : & RoTxn ,
db_name : & str ,
) -> anyhow ::Result < Database < KC , DC > > {
env . open_database ( rtxn , Some ( db_name ) )
. with_context ( | | format! ( " While opening the {db_name:?} database " ) ) ?
. with_context ( | | format! ( " Missing the {db_name:?} database " ) )
}
fn try_opening_poly_database (
env : & Env ,
rtxn : & RoTxn ,
db_name : & str ,
2023-11-22 18:21:19 +01:00
) -> anyhow ::Result < Database < Unspecified , Unspecified > > {
env . database_options ( )
. name ( db_name )
. open ( rtxn )
2023-10-25 10:49:50 +02:00
. with_context ( | | format! ( " While opening the {db_name:?} poly database " ) ) ?
. with_context ( | | format! ( " Missing the {db_name:?} poly database " ) )
}
fn try_clearing_poly_database (
wtxn : & mut RwTxn ,
2023-11-22 18:21:19 +01:00
database : Database < Unspecified , Unspecified > ,
2023-10-25 10:49:50 +02:00
db_name : & str ,
) -> anyhow ::Result < ( ) > {
database . clear ( wtxn ) . with_context ( | | format! ( " While clearing the {db_name:?} database " ) )
}
/// Exports a dump into the dump directory.
fn export_a_dump (
db_path : PathBuf ,
dump_dir : PathBuf ,
skip_enqueued_tasks : bool ,
) -> Result < ( ) , anyhow ::Error > {
let started_at = OffsetDateTime ::now_utc ( ) ;
// 1. Extracts the instance UID from disk
let instance_uid_path = db_path . join ( " instance-uid " ) ;
let instance_uid = match read_to_string ( & instance_uid_path ) {
Ok ( content ) = > match content . trim ( ) . parse ( ) {
Ok ( uuid ) = > Some ( uuid ) ,
Err ( e ) = > {
eprintln! ( " Impossible to parse instance-uid: {e} " ) ;
None
}
} ,
Err ( e ) = > {
eprintln! ( " Impossible to read {} : {} " , instance_uid_path . display ( ) , e ) ;
None
}
} ;
let dump = DumpWriter ::new ( instance_uid ) . context ( " While creating a new dump " ) ? ;
let file_store =
FileStore ::new ( db_path . join ( " update_files " ) ) . context ( " While opening the FileStore " ) ? ;
let index_scheduler_path = db_path . join ( " tasks " ) ;
2024-05-16 16:10:55 +02:00
let env = unsafe { EnvOpenOptions ::new ( ) . max_dbs ( 100 ) . open ( & index_scheduler_path ) }
2023-10-25 10:49:50 +02:00
. with_context ( | | format! ( " While trying to open {:?} " , index_scheduler_path . display ( ) ) ) ? ;
eprintln! ( " Dumping the keys... " ) ;
// 2. dump the keys
let auth_store = AuthController ::new ( & db_path , & None )
. with_context ( | | format! ( " While opening the auth store at {} " , db_path . display ( ) ) ) ? ;
let mut dump_keys = dump . create_keys ( ) ? ;
let mut count = 0 ;
for key in auth_store . list_keys ( ) ? {
dump_keys . push_key ( & key ) ? ;
count + = 1 ;
}
dump_keys . flush ( ) ? ;
eprintln! ( " Successfully dumped {count} keys! " ) ;
let rtxn = env . read_txn ( ) ? ;
2023-11-22 18:21:19 +01:00
let all_tasks : Database < BEU32 , SerdeJson < Task > > =
2023-10-25 10:49:50 +02:00
try_opening_database ( & env , & rtxn , " all-tasks " ) ? ;
let index_mapping : Database < Str , UuidCodec > =
try_opening_database ( & env , & rtxn , " index-mapping " ) ? ;
if skip_enqueued_tasks {
eprintln! ( " Skip dumping the enqueued tasks... " ) ;
} else {
eprintln! ( " Dumping the enqueued tasks... " ) ;
// 3. dump the tasks
let mut dump_tasks = dump . create_tasks_queue ( ) ? ;
let mut count = 0 ;
for ret in all_tasks . iter ( & rtxn ) ? {
let ( _ , t ) = ret ? ;
let status = t . status ;
let content_file = t . content_uuid ( ) ;
let mut dump_content_file = dump_tasks . push_task ( & t . into ( ) ) ? ;
// 3.1. Dump the `content_file` associated with the task if there is one and the task is not finished yet.
if let Some ( content_file_uuid ) = content_file {
if status = = Status ::Enqueued {
let content_file = file_store . get_update ( content_file_uuid ) ? ;
let reader =
DocumentsBatchReader ::from_reader ( content_file ) . with_context ( | | {
format! ( " While reading content file {:?} " , content_file_uuid )
} ) ? ;
let ( mut cursor , documents_batch_index ) = reader . into_cursor_and_fields_index ( ) ;
while let Some ( doc ) = cursor . next_document ( ) . with_context ( | | {
format! ( " While iterating on content file {:?} " , content_file_uuid )
} ) ? {
dump_content_file
2024-08-30 11:49:47 +02:00
. push_document ( & obkv_to_object ( doc , & documents_batch_index ) ? ) ? ;
2023-10-25 10:49:50 +02:00
}
dump_content_file . flush ( ) ? ;
count + = 1 ;
}
}
}
dump_tasks . flush ( ) ? ;
eprintln! ( " Successfully dumped {count} enqueued tasks! " ) ;
}
eprintln! ( " Dumping the indexes... " ) ;
// 4. Dump the indexes
let mut count = 0 ;
for result in index_mapping . iter ( & rtxn ) ? {
let ( uid , uuid ) = result ? ;
let index_path = db_path . join ( " indexes " ) . join ( uuid . to_string ( ) ) ;
let index = Index ::new ( EnvOpenOptions ::new ( ) , & index_path ) . with_context ( | | {
format! ( " While trying to open the index at path {:?} " , index_path . display ( ) )
} ) ? ;
let rtxn = index . read_txn ( ) ? ;
let metadata = IndexMetadata {
uid : uid . to_owned ( ) ,
primary_key : index . primary_key ( & rtxn ) ? . map ( String ::from ) ,
created_at : index . created_at ( & rtxn ) ? ,
updated_at : index . updated_at ( & rtxn ) ? ,
} ;
let mut index_dumper = dump . create_index ( uid , & metadata ) ? ;
let fields_ids_map = index . fields_ids_map ( & rtxn ) ? ;
let all_fields : Vec < _ > = fields_ids_map . iter ( ) . map ( | ( id , _ ) | id ) . collect ( ) ;
// 4.1. Dump the documents
for ret in index . all_documents ( & rtxn ) ? {
let ( _id , doc ) = ret ? ;
let document = obkv_to_json ( & all_fields , & fields_ids_map , doc ) ? ;
index_dumper . push_document ( & document ) ? ;
}
// 4.2. Dump the settings
2024-03-26 10:36:24 +01:00
let settings = meilisearch_types ::settings ::settings (
& index ,
& rtxn ,
meilisearch_types ::settings ::SecretPolicy ::RevealSecrets ,
) ? ;
2023-10-25 10:49:50 +02:00
index_dumper . settings ( & settings ) ? ;
count + = 1 ;
}
eprintln! ( " Successfully dumped {count} indexes! " ) ;
// We will not dump experimental feature settings
eprintln! ( " The tool is not dumping experimental features, please set them by hand afterward " ) ;
let dump_uid = started_at . format ( format_description! (
" [year repr:full][month repr:numerical][day padding:zero]-[hour padding:zero][minute padding:zero][second padding:zero][subsecond digits:3] "
) ) . unwrap ( ) ;
let path = dump_dir . join ( format! ( " {} .dump " , dump_uid ) ) ;
let file = File ::create ( & path ) ? ;
dump . persist_to ( BufWriter ::new ( file ) ) ? ;
eprintln! ( " Dump exported at path {:?} " , path . display ( ) ) ;
Ok ( ( ) )
}