Abstract
This document contains release notes for the changes in each release of MySQL for Visual Studio.
For additional MySQL for Visual Studio documentation, see MySQL for Visual Studio.
Updates to these notes occur as new product features are added, so that everybody can follow the development process. If a recent version is listed here that you cannot find on the download page (http://dev.mysql.com/downloads/), the version has not yet been released.
The documentation included in source and binary distributions may not be fully up to date with respect to release note entries because integration of the documentation occurs at release build time. For the most up-to-date release notes, please refer to the online documentation instead.
For legal information, see the Legal Notices.
For help with using MySQL, please visit either the MySQL Forums or MySQL Mailing Lists, where you can discuss your issues with other MySQL users.
For additional documentation on MySQL products, including translations of the documentation into other languages, and downloadable versions in variety of formats, including HTML and PDF formats, see the MySQL Documentation Library.
Document generated on: 2016-12-23 (revision: 10527)
Table of Contents
This document contains release notes for the changes in each release of MySQL for Visual Studio.
Copyright © 1997, 2016, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Access to Oracle Support
Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
This documentation is NOT distributed under a GPL license. Use of this documentation is subject to the following terms:
You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how Oracle disseminates it (that is, electronically for download on a Web site with the software) or on a CD-ROM or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of Oracle. Oracle and/or its affiliates reserve any and all rights to this documentation not expressly granted above.
Functionality Added or Changed
Enhanced the logic that migrates stored MySQL connections to the
MySQL Workbench connections.xml file. In
previous versions, the migration was offered and if not done at
that moment, the dialog to migrate was shown every time the
MySQL Connections Manager dialog was shown,
but there was no way to choose to remain storing MySQL
connections in the MySQL for Visual Studio configuration folder instead of
merging them with MySQL Workbench.
Now, the connection migration dialog offers a way to postpone the migration by either 1 hour, 1 day, 1 week, 1 month or indefinitely. If the migration is postponed, the dialog is shown again after that time elapses. If it is postponed indefinitely, then an option is added to the MySQL Connections Manager dialog that permits the connection migration to be done manually, as long as MySQL Workbench is installed.
When the MySQL Script Editor window is opened (either by selecting , , or from the menu), the Results area was visible showing a big gray area in the editor, despite having nothing to display. Now, this area is hidden until results are ready to display, which happens after clicking .
The SQL syntax parser was updated to handle the optimizer hints that were introduced in MySQL 5.7.7.
The SQL editor was updated to check the syntax of a script before sending the statements to the server. If syntax errors are present, the Visual Studio Output pane displays the errors and the script is not executed.
A drop-down list of connections was added in the MySQL editor toolbar to enable fast switching among connections while editing SQL, JavaScript, and Python scripts. The list, located next to the button, shows all Server Explorer connections for the MySQL data provider with compatible protocol support.
JavaScript and Python editors show only the connections that support the X Protocol.
MySQL Workbench was unable to open connections added from the
MySQL Connection Manager, as executing them
would emit the following error: "Cannot connect to Database
Server". This is because an invalid "socket=." value was added
to the connection definition. To solve this, MySQL for Visual Studio was updated
to use the latest MySQL.Utility version,
which fixes code in the MySQL Workbench class to only write the
socket value into the XML nodes if the connection is of type
Sockets or Pipe.
(Bug #24666952)
After connections were added to the Server Explorer through the MySQL Connections Manager, clicking on the Server Explorer toolbar caused the refresh operation to hang, and nothing else could be done within the Server Explorer pane. Clicking was required to fix this. (Bug #24666931)
SHOW statements executed from the
SQL editor failed to display the expected output.
(Bug #24622881)
Queries executed from the SQL editor against nonunique data in NoSQL tables emitted error messages and failed to return result sets. (Bug #24462707, Bug #82589)
The main XML element in %APPDATA%\Oracle\MySQL For
Visual Studio\settings.config was renamed to
MySQLforVisualStudio from
MySQLForExcel. Indentations were added to
improve the overall readability of configuration settings.
(Bug #24291264, Bug #82221)
JavaScript and Python editors permitted connections to versions of MySQL that did not support the X Protocol if those connections were unnamed or temporary, but the scripts did not work properly. This fix adds validation to ensure that all connections related to JavaScript and Python scripts are to servers with the X Plugin enabled. (Bug #24290570, Bug #82219)
Selecting the context-menu option by right-clicking a Server Explorer connection in Visual Studio emitted an error if the connection was first closed and then opened. (Bug #24064816, Bug #82205)
Visual Studio was unable to open a design window for any selected table in a MySQL database. (Bug #23642010)
Opening a new MySQL script file from the Visual Studio > menu displayed the following error: "Object reference not set to an instance of an object". (Bug #23619311)
Processing a Result object from the
X Protocol substituted an error or information message in
place of some collection output.
(Bug #22983803)
, , and buttons were missing from the Connect to MySQL dialog for connections made from the script editor window. (Bug #22114315)
Dragging and dropping a table from the Server
Explorer in Visual Studio to a project would fail
with the following error: "Some updating commands could not be
generated automatically. The database returned the following
error: You have a usable connection already". After clicking
, Visual Studio would emit the
following error "Mouse drag operation failed. Could not retrieve
schema information from table or view". To solve this issue,
MySql.Data was updated to version 6.9.9.
From the Query Designer, selecting Verify SQL Syntax would always display "Not supported by the provider" instead of verifying the SQL syntax.
The Python code editor displayed session options for JavaScript instead of options for the Python language.
In some cases, selecting for a table with a valid connection failed to populate the table with data.
Known limitation of this release: Some features such as the Entity Framework, and some Server Explorer functionality like drag and drop elements into a Dataset Designer, or Design Tables, do not function in this version.
Functionality Added or Changed
Added an error handler to manage exceptions from MySQL Shell, and to display relevant information about the exceptions in the selected output. This includes the full error message from MySQL Shell, and extra validation in case it contains terms such as "undefined" or "null".
Added SSL support for MySQL connections that use the X Protocol. SSL support works with PEM files, so SSL connections need to be created through the "MySQL Connections Manager" in MySQL for Visual Studio, or from MySQL Workbench.
Added support for the following X DevAPI functions: parseUri() and isOpen().
A new MySQL Output pane was added that contains a results grid view similar to the view found in MySQL Workbench. It contains the following data for executed statements: Success (with an icon if possible), Execution index (sequential), Execution Time, Query Text, Message (output from the server), and Duration / Fetch. This functionality is available for JavaScript and Python queries.
Added a console mode editor, where pressing Enter executes the code.
Added the ability to switch between "Batch" (execute multiple statements) and "Console" (execute each statement after pressing Enter) modes, from the Query Editor toolbar as a dropdown list.
A MySQL connection manager dialog was added to help fully manage MySQL connections. It supports connection sharing with MySQL Workbench, and supports create, edit, configure, and delete actions.
MySQL connections created with the connection manager where the password is securely stored in the system's password vault functions with the Server Explorer in Visual Studio. The password is extracted from the password vault, and persists in the Server Explorer connections.
The "mysqlx" module was not imported properly to execute JavaScript queries. (Bug #23091964, Bug #81052)
After opening a valid MySQL connection and creating a new JavaScript MySQL script, disconnecting then reconnecting to the MySQL Server while changing the port to 33060 would fail.
MySQL for Visual Studio now shows a message stating that a SSL connection is
required by the MySQL server if the
require_secure_transport
variable is set.
All script editors now display detailed information about the connection used. Before, the information was displayed in the toolbar as labels, but now all information is consolidated in a menu opened where the connection name is displayed. Additional information includes the connection method, host identifier, server version, user, and schema.
Output from executing JavaScript and Python commands were not visible unless the Output window was already opened. The Output window now automatically opens when executing commands.
MySQL for Visual Studio 2.0.2 M1 is the first development release of MySQL for Visual Studio to add support for the new X DevAPI. The X DevAPI enables application developers to write code that combines the strengths of the relational and document models using a modern, NoSQL-like syntax that does not assume previous experience writing traditional SQL.
To learn more about how to write applications using the X DevAPI, see X DevAPI User Guide. For more information about how the X DevAPI is implemented in MySQL for Visual Studio, and its usage, see Quick-Start Guide: MySQL for Visual Studio.
Please note that the X DevAPI requires at least MySQL Server version 5.7.12 or higher with the X Plugin enabled. For general documentation about how to get started using MySQL as a document database, see Using MySQL as a Document Store.
Known limitation of this release: SSL connections are not yet supported.
Functionality Added or Changed
Updated the MySQL parser's grammar to include keywords introduced in MySQL 5.7.
Because the deprecated "File", "New", "Project", "Create a New Project", "Templates", "MySQL Files" option no longer exists, the resulting error is no longer present. In other words, the deprecated "MySQL Project Templates" were removed, in favor of "MySQL Item Templates".
Support for the "IF [NOT] EXISTS" clause for CREATE, DROP, and ALTER USER statements was added.
The JavaScript and Python editors now auto-detect the port for the X Protocol, and uses it to execute JavaScript and Python scripts. Before, it was hardcoded to 33060.
The New MySQL Script - Python option would not function with MySQL Server 5.7.9 and higher. The error was similar to "An error occurred when trying to launch a MySql Script window".
Minor optimizations to the script editor window.
Added support for Visual Studio 2015 with .NET Framework 4.6.
The "New MySql Script" command bar button did not function. The error was similar to "An error occurred when trying to launch a MySql Script window".
The triple double quote """ used for multiline comments did not function correctly in the Python editor.
The JavaScript editor now only shows when working with connections using MySQL 5.7 and higher.
Opening an editor window for .mysql files that connected to MySQL Server versions lower than 5.6.6 would not function.
The Tree View in the Results tab did not display data headers.
Version 2.0.1 has no changelog entries, or they have not been published because the product version has not been released.
With MySQL for Visual Studio installed, attempting to create MSSQL connections would fail and throw an exception. (Bug #22122881, Bug #77441)
The , , , window always reported "1.0.0" as the current MySQL for Visual Studio version number. (Bug #22114385)
Executing Generate Database from Model from
an existing Entity Framework model would throw an exception
related to an error with the T4 template file, when then aborted
the creation of the database. The Connector/Net Entity Framework
assembly (MySql.Data.Entity.EF6.dll) path
was fixed in the MySQL T4 template file
(SSDLToMySQL.tt).
(Bug #20234532, Bug #74388)
With Visual Studio 2012, generating a database from a model would fail and throw an exception. However, clicking after the error would cause the action to succeed. (Bug #18181649)
Known limitation:
Item templates do not work correctly with MySQL Server 5.7.x, as it prevents the creation of an Entity Framework model.
Functionality Added or Changed
Project Templates were replaced with Item Templates.
The Project Templates option was removed from the plugin toolbar, and from the Project menu, in order to add the Item Templates feature with two options: MySQL MVC Item and MySQL Windows Forms Item, which are available as a context menu for existing projects. They add new windows forms or MVC controllers/views connected to MySQL.
Added the Entity Framework option to the
MySQL Website Configuration dialog for web
projects, so Entity Framework version 5 or 6 can be used with a
MySQL database provider. These automatically add the
configuration/references needed to the
web.config file and the project itself.
Also, all available configuration options are now listed in the
dialog.
The Installer could not uninstall MySQL for Visual Studio if Visual Studio was uninstalled first. (Bug #21953055, Bug #71226)
In v1.2.4, the and toolbar buttons were disabled. (Bug #21495692)
The "Templates" could not be uninstalled via Add/Remove Programs. Because Project Templates were replaced by Item Templates, this is no longer a concern. (Bug #21488922, Bug #77802)
The dataset designer wizard was not showing the stored procedure parameters when creating a "TableAdapter" using existing stored procedures for the "Select" command. Also, the stored procedure command had an "error" thus causing the dataset to not be created. (Bug #20233133, Bug #74195)
This is a maintenance release that fixes bugs and adds support for Microsoft Visual Studio 2015.
Known limitations:
MySQL for Visual Studio project templates are designed to work with MVC 4, but Microsoft Visual Studio 2015 is the first VS version that ships with MVC 5. As a workaround for this release, you must install MVC 4 to get the project templates working with VS 2015. If MVC 4 is not installed, then the MySQL template menus and toolbars will be disabled.
If MySQL for Visual Studio 1.2.4 is installed before MVC 4, then you must uninstall and then reinstall the 1.2.4 plugin. Executing a "Change" or "Repair" will not work.
The and toolbar buttons are disabled in this release.
Added Microsoft Visual Studio 2015 support. (Bug #21438524, Bug #77708)
Removed Microsoft Visual Studio 2008 support.
This is the first GA release in the MySQL for Visual Studio 1.2 series, and it is a version suitable for production environments.
Functionality Added or Changed
A MySQL Simple Membership provider option was added to the web configuration tool.
Several DLL files were hardcoded with the version number "1.0.0.0" instead of using the current MySQL for Visual Studio value. (Bug #19209876)
This RC release of the 1.2.x branch improves the feature set that was added in the limited 1.2.x branch. This RC release should not be used in a production environment.
The MySQL ASP.NET MVC 3 Project Wizard, MySQL Windows Forms Project, and MySQL Website Configuration wizards were improved.
The MySQL Windows Forms Wizard now generates an application with multiple forms that include different types of views based on user customization.
Entity Framework 5 / 6 support was added when generating new MySQL projects.
This beta release of the 1.2.x branch improves the feature set that was added in the limited 1.2.0 release. This beta release should not be used in a production environment.
The MySQL ASP.NET MVC 3 Project Wizard, MySQL Windows Forms Project, and MySQL Website Configuration wizards were improved.
The MySQL ASP.NET MVC 3 Project Wizard now generates browsable pages for all tables included in the Data Entity model.
A Create New MySQL Project dialog is now accessible from the MySQL Toolbar.
The name MySQL MVC 3 Template was changed to MySQL ASP.NET MVC 3 Project Wizard.
The first public release of the 1.2.x branch. This alpha release is not feature complete, has limitations, and should not be used in a production environment.
Functionality Added or Changed
The MySQL Website Configuration wizard was updated to include an ASP.NET Web Personalization provider. This allows you to store personalization state data for the content and layout of Web Parts pages that are generated by the Web Parts personalization service using MySQL as a data source.
This feature requires Connector/Net 6.9.
The MySQL Website Configuration wizard was updated to include an ASP.NET Site Map provider. This allows you to show a hierarchical list of links that describe the structure of a site.
This feature requires Connector/Net 6.9.
A MySQL Windows Forms Project wizard was added, and is available from the Visual Studio New Project dialog. This wizard automates the generation of a simple .NET Windows Forms Application with a form that is connected to a MySQL data source.
A MySQL MVC 3 Template wizard was added, and is available from the Visual Studio New Project dialog. This wizard automates the generation of an ASP.NET application that includes a MySQL Membership configuration section, and can be set up to use a new or existing MySQL database. Optionally, the application can also use the MySQL Role and MySQL Profile providers.
This is a maintenance release for the MySQL for Visual Studio 1.1 series, and it is suitable for production environments. It is compatible with Connector/Net 6.8.3 and later, and it supports MySQL Server versions 5.0 to 5.6.
Functionality Added or Changed
Introduced a new MySQL toolbar, which provides shortcuts to some of the main functionalities of MySQL for Visual Studio. See The MySQL Toolbar for details.
The MySQL parser did not recognize the full string literal
syntax of
[ as
supported by the MySQL Server. This fix makes Connector/Net and
MySQL for Visual Studio recognize the string literal syntax as
specified in Character String Literal Character Set and Collation, in the MySQL
Server manual.
(Bug #18169145)_charset_name]'string'
[COLLATE collation_name]
In Visual Studio, the stored procedure debugger did not evaluate
the last_insert_id() function in a watch
expression correctly. This fix also corrects similar issues for
two other information functions that query the debug data table:
row_count() and
found_row().
(Bug #18111085)
A new model could not be created with Entity Framework 6 in Visual Studio 2013 when using MySQL for Visual Studio 1.1.3 and Connector/Net 6.8.3. (Bug #18105394, Bug #71427)
The MySQL parser could not parse an if
statement when there were any spaces before the parenthesis for
the arguments (for example, “if (1,1, 1)”). Besides
if, the same issue occurred for a number of
other functions like row_count,
ifnull, mod,
repeat, and so on, and this fix corrects
the problem for all of them.
(Bug #17981407)
When debugging a stored routine in Visual Studio with the debugger, long identifiers caused the error "data too long for column 'pvarname'" to be thrown. That was because the SQL script of the debugger did not support the same lengths for identifier names as the MySQL server does. This fix matches the debugger with the MySQL server on the maximum lengths supported for identifier names. (Bug #17568158, Bug #70159)
This is the first GA release in the MySQL for Visual Studio 1.1 series, and it is a version suitable for production environments. It is compatible with Connector/Net 6.8.3, and it supports MySQL Server versions 5.0 to 5.6. It includes the following features:
Integration with Visual Studio 2013 (requires Professional Edition or higher)
Integration with Connector/Net 6.8.3
Support for Entity Framework 6 new designers in Visual Studio 2013 (requires Connector/Net 6.8.3)
A new data export tool
Intellisense did not treat the keywords “describe” and “desc” as synonyms of “explain”. (Bug #17956087)
Intellisense showed views from all databases, instead of just the current one. (Bug #17954412)
The debugger failed with parser errors when debugging stored
procedures with a Leave statement.
(Bug #17616344)
Could not open the ASP.NET Web Configuration tool in the Solution Explorer when using MySQL for Visual Studio 1.0.2 and Connector/Net 6.7.5. (Bug #17898244, Bug #69808)
When opening or creating a .mysql file,
trying to invoke Intellisense caused an error in some cases.
(Bug #17890216)
Debugger failed to debug a routine correctly when it had two functions in a single expression. That was due to an error in handling the scope of the second function, which has been fixed. (Bug #17865915)
Installation on Windows Server 2008 failed. (Bug #17698406, Bug #70590)
Functionality Added or Changed
With MySQL for Visual Studio 1.0.2, the registration of the Data
provider in the machine.config file was
done by the installation of MySQL for Visual Studio. From MySQL
for Visual Studio 1.1.1 onwards, the registration is no longer
performed by MySQL for Visual Studio, but is performed during
the installation of Connector/Net (from 6.8.1 and on). Also, the
registration is no longer needed when using MySQL for Visual
Studio only.
Added support for Entity Framework 6 for creating a model using Database First and Model First. This feature requires Connector/Net 6.8.1.
When trying to edit or alter a stored procedure or trigger that
included references to session variables, an error occurred and
the changes were not saved, unless Allow User
Variables=true was in the connection settings. Besides
stopping the error, this fix also stops similar issues with
renaming stored procedure or trigger using .
(Bug #17830161)
Generation of database from a simple model failed in Visual Studio 2012.
For this fix to work, you have to select the correct DDL Generation Template as an entity property. Also, there is a known issue found with Visual Studio 2010, which forces the user to go back and forth between steps in order to create the SQL script.
(Bug #17800707, Bug #67964)
This section contains separate Visual Studio Plugin release notes for versions of Connector/Net older than 5.1.2. From Connector/Net 5.1.2 to 6.6.x, the Visual Studio Plugin is part of the main Connector/Net package, and changes to the Visual Studio Plugin are described in the Connector/Net release notes.
Since Connector/Net 6.7.x., the Visual Studio Plugin has been replaced by the product MySQL for Visual Studio, and these two products have conflicting version numbers.
This is a bug fix release to resolve an incompatibility issue with Connector/Net 5.0.1.
It is critical that this release only be used with Connector/Net
5.0.1. After installing Connector/Net 5.0.1, you will need to
make a small change in your machine.config file. This file
should be located at
%win%\Microsoft.Net\Framework\v2.0.50727\CONFIG\machine.config
(%win% should be the location of your Windows
folder). Near the bottom of the file you will see a line like
this:
<add name="MySQL Data Provider" invariant="MySql.Data.MySqlClient" description=".Net Framework Data Provider for MySQL" type="MySql.Data.MySqlClient.MySqlClientFactory, MySql.Data"/>
It needs to be changed to be like this:
<add name="MySQL Data Provider" invariant="MySql.Data.MySqlClient" description=".Net Framework Data Provider for MySQL" type="MySql.Data.MySqlClient.MySqlClientFactory, MySql.Data, Version=5.0.1.0, Culture=neutral, PublicKeyToken=c5687fc88969c44d"/>
Version 1.0.1 has no changelog entries, or they have not been published because the product version has not been released.