What is Smuggler

Smuggler gives you the ability to export or import data from or to a database using JSON format. It is exposed via the DocumentStore.Smuggler property.

ForDatabase

By default, the DocumentStore.Smuggler works on the default document store database from the DocumentStore.Database property.

In order to switch it to a different database use the .ForDatabase method.

var northwindSmuggler = store
  .Smuggler
  .ForDatabase("Northwind");

Export

Syntax

Task<Operation> ExportAsync(
  DatabaseSmugglerExportOptions options,
  DatabaseSmuggler toDatabase,
  CancellationToken token = default(CancellationToken));

Task<Operation> ExportAsync(
  DatabaseSmugglerExportOptions options,
  string toFile,
  CancellationToken token = default(CancellationToken));

Parameters
options	DatabaseSmugglerExportOptions	Options that will be used during the export. Read more here.
toDatabase	DatabaseSmuggler	DatabaseSmuggler instance used as a destination
toFile	string	Path to a file where exported data will be written
token	CancellationToken	Token used to cancel the operation

Return Value
Operation	Instance of Operation class which gives you an ability to wait for the operation to complete and subscribe to operation progress events

DatabaseSmugglerExportOptions

Parameters
Collections	List<string>	List of specific collections to export. If empty, then all collections will be exported. Default: empty
OperateOnTypes	DatabaseItemType	Indicates what should be exported. Default: Indexes, Documents, RevisionDocuments, Conflicts, DatabaseRecord, Identities, CompareExchange
IncludeExpired	bool	Should expired documents be included in the export. Default: true
RemoveAnalyzers	bool	Should analyzers be removed from Indexes. Default: false
TransformScript	string	JavaScript-based script applied to every exported document. Read more here.
MaxStepsForTransformScript	int	Maximum number of steps that transform script can process before failing. Default: 10000

Example

// export only Indexes and Documents to a given file
var exportOperation = await store
  .Smuggler
  .ExportAsync(
      new DatabaseSmugglerExportOptions
      {
          OperateOnTypes = DatabaseItemType.Indexes
                           | DatabaseItemType.Documents
      },
      @"C:\ravendb-exports\Northwind.ravendbdump",
      token);

await exportOperation.WaitForCompletionAsync();

Import

Syntax

Task<Operation> ImportAsync(
  DatabaseSmugglerImportOptions options,
  Stream stream,
  CancellationToken token = default(CancellationToken));

Task<Operation> ImportAsync(
  DatabaseSmugglerImportOptions options,
  string fromFile,
  CancellationToken token = default(CancellationToken));

Parameters
options	DatabaseSmugglerImportOptions	Options that will be used during the import. Read more here.
stream	Stream	Stream with data to import
fromFile	string	Path to a file from which data will be imported
token	CancellationToken	Token used to cancel the operation

Return Value
Operation	Instance of Operation-class which gives you an ability to wait for the operation to complete and subscribe to operation progress events

DatabaseSmugglerImportOptions

Parameters
Collections	List<string>	List specific of collections to import. If empty then all collections will be imported. Default: empty
OperateOnTypes	DatabaseItemType	Indicates what should be imported. Default: Indexes, Documents, RevisionDocuments, Conflicts, DatabaseRecord, Identities, CompareExchange
IncludeExpired	bool	Should expired documents be imported. Default: true
RemoveAnalyzers	bool	Should analyzers be removed from Indexes. Default: false
TransformScript	string	JavaScript-based script applied to every imported document. Read more here.
MaxStepsForTransformScript	int	Maximum number of steps that transform script can process before failing. Default: 10000

Example

// import only Documents from a given file
var importOperation = await store
  .Smuggler
  .ImportAsync(
      new DatabaseSmugglerImportOptions
      {
          OperateOnTypes = DatabaseItemType.Documents
      },
      // import the .ravendbdump file that you exported (i.e. in the export example above)
      @"C:\ravendb-exports\Northwind.ravendbdump",
      token);

await importOperation.WaitForCompletionAsync();

TransformScript

TransformScript exposes the ability to modify or even filter-out the document during the import and export process using the provided JavaScript.

Underneath the JavaScript engine is exactly the same as used for patching operations giving you identical syntax and capabilities with additional ability to filter out documents by throwing a 'skip' exception.

var id = this['@metadata']['@id'];
if (id === 'orders/999-A')
  throw 'skip'; // filter-out

this.Freight = 15.3;