MarkLogic 10 Product Documentationxdmp.externalBinaryPath
xdmp.externalBinaryPath( source as binary() ) as String?
Summary
Return the path to the external file associated with an external binary document.
| Parameters | |
|---|---|
| source | The external binary node for which to retrieve the external file path. |
Usage Notes
If the source binary node does not represent an external binary
binary document, XDMP-ARG is thrown. That is, the
source binary node must have been created by
xdmp:external-binary. Use
xdmp:binary-is-external
to test whether or not a node represents an external binary.
The external binary format is best suited for read-only content managed external to MarkLogic Server. If the content is changed externally, the Compressed Tree Cache (CTC) should be cleared across the entire cluster, since the MarkLogic Server will not automatically reload the binary into the CTC.
Example
xdmp.externalBinaryPath(
cts.doc("/movies/external-movie-1.mp4").xpath("/binary()"));
=> /space/binaries/movies/movie-1.mp4