Ad-hoc database queries

Reports ::: report_customsql
Maintained by Tim at Lone Pine Koala SanctuaryTim Hunt, at the OU (Perry building)Mahmoud Kassaei
This report plugin allows Administrators to set up arbitrary database queries to act as ad-hoc reports. Reports can be of two types, either run on demand, or scheduled to run automatically. Other users with the right capability can go in and see a list of queries that they have access to. Results can be viewed on-screen or downloaded as CSV.
Latest release:
3793 sites
146 fans
Current versions available: 10

This report, created by The Open University, lets Administrators set up arbitrary SQL select queries that anyone with the appropriate permissions can then run. Reports can be set to be runnable on-demand, or automatically run weekly or monthly.

The results are displayed as a fairly plain HTML table, and can also be downloaded as CSV.

The idea is that this lets you quicly set up ad-hoc reports, without having to create a whole new admin report plugin.


Screenshot #0


Tim at Lone Pine Koala Sanctuary
Tim Hunt (Lead maintainer)
at the OU (Perry building)
Mahmoud Kassaei: Developer
Please login to view contributors details and/or to contact them

Comments RSS


  • Tim at Lone Pine Koala Sanctuary
    Wed, Oct 28, 2020, 6:03 PM
    Can other parts of Moodle send email? (E.g. forum subscription emails.) That is nother thing to text.
  • Thu, Oct 29, 2020, 9:28 AM
    @Sarah Ashley - I checked the DB and that value was indeed in the message_providers table. But just to be sure all was good, I uninstalled the plugin and reinstalled it, restored my sql and set it to run automatically, daily at 20:00. At 20:02, still nothing. @Tim Hunt yes. I tested this out and I received an email. I checked the task log and it is indeed running according to the log, but nothing is being sent. Anyone have any ideas or where I can go to troubleshoot?
  • Tim at Lone Pine Koala Sanctuary
    Thu, Oct 29, 2020, 5:51 PM
    This is getting very puzzling. You could check under Site administration > Messaging > Notification settings, and Your profile -> Preferences -> Notification preferences. However, it would be surprising if that was wrong, particularly if you have just reinstalled.

    And, might be worth setting Debugging to Developer level, to see if that makes a difference.

    But, this is just standard Moodle messaging API. It should work. It does normally.
  • Wed, Jan 20, 2021, 12:47 AM
    Hello Is there anyway to increase the Limit of rows returned? We've reached the max and it's truncating the report.
  • Tim at Lone Pine Koala Sanctuary
    Wed, Jan 20, 2021, 12:57 AM
    The limit is an admin setting that you can change under Plugins -> Reports -> Ad-hoc DB queries.
  • Mon, Feb 22, 2021, 10:10 PM
    Hello. What sql query can i use to select teachers with their corresponding courses and number of enrolled users in that course
  • Sat, Mar 6, 2021, 2:43 AM
    Do you have a list of the queries available with this plugin? (If it's available on here somewhere and I've missed it, my apologies.) I am looking for a plugin that will allow me to see all grades for a particular student for all courses that student is enrolled in. Is this plugin able to do that?
  • Sat, Mar 6, 2021, 4:01 AM
    @Stephanie - you’ll find a list if you click on the link in the Useful Links section above that says “More documentation on this plugin“.
  • Thu, Mar 11, 2021, 4:31 PM
    Hello @Tim Hunt, can you please tell me, is that possible to grant view/edit permissions of the ad-hoc reports to other admins because all I am seeing that the root user can use and view reports generated by this plugin. So if there is any possible way then please let me know. Thanks in advance
  • Tim at Lone Pine Koala Sanctuary
    Thu, Mar 11, 2021, 10:39 PM
    Access to reports is controlled by the capabilies that this plugin defines. (By default, only admins get permission to access thing, but you can change that by editing the roles. Filter the list using "report/customsql:"
  • Tue, Mar 16, 2021, 9:08 PM
    @Tim Hunt thank you for your reply you have been a great help to me. one more thing that I want to add a header image to pdf downloaded the report and I can't find the pdf library in the plugin files, so please guide me through how should I add it. thanks in advance
  • Peter
    Thu, Apr 22, 2021, 8:33 PM
    @Patrick Gay, @Tim Hunt,

    How was this problem resolved in the end? I am using Moodle 3.10.3+ with report_customsql 4.0 for Moodle 3.9+. Here the situation is the same as the one Patrick describes. I can make reports on demand, the plugin has an entry in the table mdl_message_providers and the notification settings and preferences are fine.
    Still, the reports are not created according to the loggings.
  • Tim at Lone Pine Koala Sanctuary
    Thu, Apr 22, 2021, 11:23 PM
    Can you check in the mdl_report_customsql_queries table. Look at what is stored in the emailto column.

    Also, look under Admin -> Server -> Tasks -> Scheduled tasks, and look at the logs for this report's task. Are there any errors being reported there.
  • Peter
    Fri, Apr 23, 2021, 1:24 AM
    Hi Tim,

    Thanks for your reply.

    email to column: ',2'. 2 is the userid of this user

    in the logs there is 1 error:

    Execute scheduled task: Ad-hoc database queries: run scheduled reports task (report_customsql\task\run_reports)
    ... started 11:10:01. Current memory use 4.5MB.
    ... Looking for old temp CSV files to delete.
    ... Running report tessie
    ... REPORT FAILED Invalid user
    ... used 8 dbqueries
    ... used 0.063519954681396 seconds
    Scheduled task complete: Ad-hoc database queries: run scheduled reports task (report_customsql\task\run_reports)

    Kind regards,
  • Tim at Lone Pine Koala Sanctuary
    Fri, Apr 23, 2021, 1:27 AM
    Right, so there is a bug. There should not be a , before the 2. If you can fix that directly in the DB, then it will start working.

    Ultimately, I need to push a bug fix for this to the plugins DB.
Please login to post comments