Transforming the Default URI
- Last Updated: April 14, 2026
- 1 minute read
- MarkLogic Server
- Version 11.0
- Documentation
Use the following options to tailor the database URI of inserted documents:
-
-output_uri_replaceperforms one or more string substitutions on the default URI. -
-output_uri_prefixprepends a string to the URI after substitution. -
-output_uri_suffixappends a string to the URI after substitution.
The -output_uri_replace option accepts a comma delimited list of regular expression and replacement string pairs. The string portion must be enclosed in single quotes:
-output_uri_replace pattern,’string’,pattern,’string'
For details on the regular expression language supported by -output_uri_replace, see Regular Expression Syntax.
Note:
These options are applied after the default URI is constructed and encoded, so if the option values contain characters not allowed in a URI, you must encode them yourself. See Character Encoding URIs.
The following example loads documents from the filesystem directory /space/bill/data. The default output URIs would be of the form /space/bill/data/filename. The example uses -output_uri_replace to replace “bill/data” with “will” and strip off “/space/”, and then adds a “/plays” prefix using -output_uri_prefix. The end result is output URIs of the form /plays/will/filename.
# Windows users, see Modifying the Example Commands for Windows
$ mlcp.sh import -host localhost -port 8000 -username user \
-password passwd -input_file_path /space/bill/data -mode local \
-output_uri_replace "/space,'',/bill/data/,'/will/'" \ -output_uri_prefix /plays