XQuery debugging is currently supported only for the MarkLogic database engine.
To start a debug session against the MarkLogic engine you will first need to configure a MarkLogic datasource and a MarkLogic connection. Also you have to make sure that the debugging support is enabled in the MarkLogic server that will be accessed from <oXygen/>.
The MarkLogic XQuery debugger integrates seamlessly into the XQuery Debugger perspective. If you already have a MarkLogic scenario configured for the XQuery file you can choose directly to debug the scenario. If not, you just have to switch to the XQuery Debugger perspective, open the XQuery file in the editor and select the MarkLogic connection in the XQuery engine selector from the debug control toolbar. For general information about how a debugging session is started and controlled see the working with the debugger section.
When debugging queries which import modules the recommended steps are as follows:
After starting the debugging session 'Step in' repeatedly until reaching the desired modules
Add each of the modules to the project for easy access
Set breakpoints in the modules as needed
Debug the query as you see fit
When starting a new debugging session make sure that the modules which you will debug are already opened in the editor. This is necessary so that the breakpoints in modules will be considered. Also make sure there are no other opened modules which are not involved in the current debugging session
![]() | Peculiarities and limitations of the MarkLogic debugger integration: |
---|---|
|