MySQL documentation major improvements (#107690)

* added keywords and fixed description * Update (dateColumn) description Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * Mount docs from the current repository Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Clean up variables Signed-off-by: Jack Baldry <jack.baldry@grafana.com> * Improve timeFilter and timeGroup macro description Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * Fix timefilter macro example formatting Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * Fix time macro example formatting Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * Remove extra spaces from timefilter macro example Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * Introduce new table and Add examples for time, timeFilter and timeGroup Macros Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * Improve existing examples of timeGroupAlias Macro Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * Remove data frame description Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * fixed the homepage with valid links Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> * Add Table Panel results for Macros Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * fixed and define the configuration part for grafana mysql user Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> * fixed port typo Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> * remove the sqlDatasourceDatabaseSelection based https://github.com/grafana/grafana/issues/105232 Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> * added annotation single tag example Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> * Change format type Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * fix minor typos and run prettier Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> * Address Macros specific changes Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * Revert column name and replace URL with version substitution Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> * re-added the text for the feature flag Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> * revert back the changes for the grafana mysql usage Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> * fixed links as per writers toolkit guide * run prettier Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> * Update docs/sources/datasources/mysql/query-editor/_index.md thanks Co-authored-by: Zoltán Bedi <zoltan.bedi@gmail.com> --------- Signed-off-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> Signed-off-by: Jack Baldry <jack.baldry@grafana.com> Signed-off-by: Usman Ahmad <usman.ahmad@grafana.com> Co-authored-by: Sheikh-Abubaker <sheikhabubaker761@gmail.com> Co-authored-by: Jack Baldry <jack.baldry@grafana.com> Co-authored-by: Zoltán Bedi <zoltan.bedi@gmail.com>
2025-07-30 09:03:44 -05:00
parent 04c53678fa
commit f7f8a52bda
4 changed files with 128 additions and 88 deletions
@@ -45,10 +45,14 @@ This document provides instructions for configuring the MySQL data source and ex
 You must have the `Organization administrator` role in order to configure the MySQL data source.
 Administrators can also [configure the data source via YAML](#provision-the-data-source) with Grafana's provisioning system.

-Grafana ships with the MySQL plugin, so no additional installation is required.
-
 {{< admonition type="note" >}}
-When adding a data source, ensure the database user you specify has only `SELECT` permissions on the relevant database and tables. Grafana does not validate the safety of queries, which means they can include potentially harmful SQL statements, such as `USE otherdb;` or `DROP TABLE user;`, which could get executed. To minimize this risk, Grafana strongly recommends creating a dedicated MySQL user with restricted permissions.
+Grafana ships with the MySQL data source by default, so no additional installation is required.
+{{< /admonition >}}
+
+{{< admonition type="caution" >}}
+When adding a data source, ensure the database user you specify has only `SELECT` permissions on the relevant database and tables. Grafana does not validate the safety of queries, which means they can include potentially harmful SQL statements, such as `USE otherdb;` or `DROP TABLE user;`, which could get executed.
+
+To minimize this risk, Grafana strongly recommends creating a dedicated MySQL user with restricted permissions.
 {{< /admonition >}}

 Example:
@@ -81,7 +85,7 @@ Following is a list of MySQL configuration options:

 **Connection:**

- **Host URL** - Enter the IP address/hostname and optional port of your MySQL instance. If the port is omitted the default 3306 port will be used.
+- **Host URL** - Enter the IP address/hostname and optional port of your MySQL instance. If the port is omitted the default `3306` port will be used.
 - **Database** - Enter the name of your MySQL database.

 **Authentication:**