{"id": "plugin_hooks:plugin-hook-query-actions", "page": "plugin_hooks", "ref": "plugin-hook-query-actions", "title": "query_actions(datasette, actor, database, query_name, request, sql, params)", "content": "datasette  -  Datasette class \n                         \n                             You can use this to access plugin configuration options via  datasette.plugin_config(your_plugin_name) , or to execute SQL queries. \n                         \n                     \n                     \n                         actor  - dictionary or None \n                         \n                             The currently authenticated  actor . \n                         \n                     \n                     \n                         database  - string \n                         \n                             The name of the database. \n                         \n                     \n                     \n                         query_name  - string or None \n                         \n                             The name of the canned query, or  None  if this is an arbitrary SQL query. \n                         \n                     \n                     \n                         request  -  Request object \n                         \n                             The current HTTP request. \n                         \n                     \n                     \n                         sql  - string \n                         \n                             The SQL query being executed \n                         \n                     \n                     \n                         params  - dictionary \n                         \n                             The parameters passed to the SQL query, if any. \n                         \n                     \n                 \n                 Populates a \"Query actions\" menu on the canned query and arbitrary SQL query pages. \n                 This example adds a new query action linking to a page for explaining a query: \n                 from datasette import hookimpl\nimport urllib\n\n\n@hookimpl\ndef query_actions(datasette, database, query_name, sql):\n    # Don't explain an explain\n    if sql.lower().startswith(\"explain\"):\n        return\n    return [\n        {\n            \"href\": datasette.urls.database(database)\n            + \"?\"\n            + urllib.parse.urlencode(\n                {\n                    \"sql\": \"explain \" + sql,\n                }\n            ),\n            \"label\": \"Explain this query\",\n            \"description\": \"Get a summary of how SQLite executes the query\",\n        },\n    ] \n                 Example:  datasette-create-view", "breadcrumbs": "[\"Plugin hooks\", \"Action hooks\"]", "references": "[{\"href\": \"https://datasette.io/plugins/datasette-create-view\", \"label\": \"datasette-create-view\"}]"}