How Do I Connect to a MySQL Data Source?
In this article we demonstrate how to connect a Report Template to a MySQL server. For more details about the Connection Editor, see the Connection Editor Reference.
What is Needed to Establish the Connection
- MySQL 5.0 or later
- Download and install this ADO.NET connector (be sure to download the Connector installer, not the full product installer)
Connect Your Report Template to MySQL
From Microsoft Word, Excel, or PowerPoint, navigate to the AutoTag Manager tab. Once on the AutoTag Manager tab, click on the upper half of the Data Sources button. This will bring up the Connection Editor.
- In the Connection Editor window click on the New tab.
- Click on MySQL Database in the SQL section. The Details pane will change to prompt you for your data source details.
- Enter a Name for your data source connection.
- Type or paste the name of the desired MySQL server, or browse to the location of the MySQL server. This list will auto-populate with the names of MySQL servers on your network configured to respond to a network query asking for their names. You can type in the name or select from the list.
- Enter the name of the desired database. This list will auto-populate from the MySQL server once it is set. In most cases you will also need to enter your username and password (if you are not using Windows Identity - see below) in order for Report Designer to auto-populate the list of databases. You can type in the name or select from the list.
- Enter your credentials or use your Windows Identity. (The Windward public MySQL server mysql.windward.net username and password are "demo" and "demo" without the quotes).
- User and User Owned are the same thing for MySQL. User will pull the metadata of just the tables created for a database. System will also pull the system tables MySQL adds to the database used to administer and configure each database.
- Click on Add, then Test, to test your connection. If all parameters and credentials are correct and a connection is made, you will receive a successful notification.
- Click on Close to save your information.
Other (Optional) Connection Editor Fields
User and User Owned are the same thing for MySQL. User will pull the metadata of just the tables created for a database. System will also pull the system tables MySQL adds to the database used to administer and configure each database.
|Read in metadata
||Check this to read in additional information from the database, primarily the descriptions of tables, views, and columns, and the primary key - foreign key relationships. You should always keep this checked.
|Use Connection String
||You can enter the connection string directly instead of entering the Server, Database and Credentials. When unchecked it will display the connection string Report Designer generated from your settings.
|Root Directory||This is the optional default directory for any Import Tag requests where the requested file does not have an absolute path. If left blank, Report Designer will use the directory where the data source file is located. If the data source is not a file it will use the directory where the template is located.