You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Quickstart: Use Azure Data Studio to connect and query MySQL (Preview)
14
14
15
-
This quickstart shows how to use Azure Data Studio to connect to a MySQL server (hosted on-premises, on VMs, on managed MySQL in other clouds or on Azure Database for MySQL - FLexible Server), create a database, and use SQL statements to insert and query data in the database.
15
+
This quickstart shows how to use Azure Data Studio to connect to a MySQL server (hosted on-premises, on VMs, on managed MySQL in other clouds or on Azure Database for MySQL - Flexible Server), create a database, and use SQL statements to insert and query data in the database.
16
16
17
17
## Prerequisites
18
18
@@ -29,7 +29,7 @@ To complete this quickstart, you need Azure Data Studio, the MySQL extension for
29
29
30
30
1. Start **Azure Data Studio**.
31
31
32
-
2. The first time you start Azure Data Studio the **Connection** dialog opens. If the **Connection** dialog doesn't open, click the **New Connection** icon on the **SERVERS** view in the **Connections** tab:
32
+
2. The first time you start Azure Data Studio the **Connection** dialog opens. If the **Connection** dialog doesn't open, select the **New Connection** icon on the **SERVERS** view in the **Connections** tab:
33
33
34
34
:::image type="content" source="media/quickstart-mysql/new-connection-icon.png" alt-text="Screenshot of new connection icon in the Servers sidebar.":::
35
35
@@ -42,14 +42,14 @@ To complete this quickstart, you need Azure Data Studio, the MySQL extension for
|**Server name**| localhost / exampleserver.mysql.database.azure.con | The fully qualified server name. |
45
-
|**User name**| mysqluser | The user name you want to log in with. |
46
-
|**Password (SQL Login)**|*password*| The password for the user account you are logging in with. |
45
+
|**User name**| mysqluser | The user name you want to sign in with. |
46
+
|**Password (SQL Login)**|*password*| The password for the user account you're logging in with. |
47
47
|**Remember Password**|*Check*| Check this box if you don't want to enter the password each time you connect. |
48
48
|**Database name**|\<Default\>| Enter a database name if you want the connection to specify a database. |
49
49
|**Server group**|\<Default\>| This option lets you assign this connection to a specific server group you create. |
50
50
|**Name (optional)**|*leave blank*| This option lets you specify a friendly name for your server. |
51
51
52
-
5. If your MySQL server requires SSL encryptions, navigate to **Advanced Properties** window by selecting **Advanced...** button, enter the SSL configuration details and select **OK**. By default, SSL mode is configured as *Require*. For more details on SSL encryption and modes, see [Configuring MySQL to Use Encrypted Connections](https://dev.mysql.com/doc/refman/8.0/en/using-encrypted-connections.html).
52
+
5. If your MySQL server requires SSL encryptions, navigate to **Advanced Properties** window by selecting **Advanced...** button, enter the SSL configuration details and select **OK**. By default, SSL mode is configured as *Require*. For more information on SSL encryption and modes, see [Configuring MySQL to Use Encrypted Connections](https://dev.mysql.com/doc/refman/8.0/en/using-encrypted-connections.html).
53
53
54
54
6. Review the connection details and select **Connect**.
55
55
@@ -67,7 +67,7 @@ The following steps will create a database named **tutorialdb**:
67
67
CREATEDATABASEtutorialdb;
68
68
```
69
69
70
-
3. From the toolbar select **Run** to execute the query. Notifications appear in the **MESSAGES** pane to show query progress.
70
+
3. From the toolbar, select **Run** to execute the query. Notifications appear in the **MESSAGES** pane to show query progress.
71
71
72
72
>[!TIP]
73
73
> You can use **F5** on your keyboard to execute the statement instead of using **Run**.
@@ -101,7 +101,7 @@ After the query completes, right-click **Databases** under your MySQL server in
101
101
102
102
## Insert data
103
103
104
-
Paste the following snippet into the query window and click**Run**:
104
+
Paste the following snippet into the query window and select**Run**:
Microsoft connector for Teradata enables exporting data from and load data into Teradata databases in an SSIS package.
17
+
Microsoft Connector for Teradata enables exporting and loading data into Teradata databases in an SSIS package.
18
18
19
19
This new connector supports databases with 1MB-enabled tables.
20
20
21
21
## Version support
22
22
23
-
The following Microsoft SQL Server products are supported by Microsoft Connector for Teradata:
23
+
Microsoft Connector supports the following Microsoft SQL Server products for Teradata:
24
24
25
25
- Microsoft SQL Server 2019
26
26
- Microsoft SQL Server Data Tools (SSDT) 15.8.1 or later for Visual Studio 2017
27
27
- Microsoft SQL Server Data Tools (SSDT) for Visual Studio 2019
28
28
29
-
Microsoft connector for Teradata uses ODBC Driver for Teradata and Teradata Parallel Transporter shipped with Teradata Tools and Utilities (TTU). Supported TTU versions are 16.20 and 17.10.
29
+
Microsoft Connector for Teradata uses ODBC Driver for Teradata, and Teradata Parallel Transporter shipped with Teradata Tools and Utilities (TTU). Supported TTU versions are 16.20 and 17.10.
30
30
31
31
## Installation
32
32
33
33
Install TTU from [Teradata site](https://downloads.teradata.com/download/database/teradata-tools-and-utilities-13-10). Make sure that ODBC Driver for Teradata and Teradata Parallel Transporter features is selected during the installation.
34
34
35
-
To install the connector for Teradata database, download and run the installer from [the latest version of Microsoft connector for Teradata](https://www.microsoft.com/download/details.aspx?id=100599). Then follow the directions in the installation wizard.
35
+
To install the connector for the Teradata database, download and run the installer from [the latest version of Microsoft connector for Teradata](https://www.microsoft.com/download/details.aspx?id=100599). Then follow the directions in the installation wizard.
36
36
37
-
After you install the connector, you must restart the SQL Server Integration Service to be sure that the Teradata source and destination works correctly.
37
+
After you install the connector, you must restart the SQL Server Integration Service to be sure that the Teradata source and destination work correctly.
38
38
39
39
## Design and execute SSIS packages
40
40
41
-
Microsoft Connector for Teradata provides similar user experience with Attunity Teradata Connector. User can design new packages based on previous experience, using SSDT for VS 2017 or VS 2019, with *targeting SQL server 2019*.
41
+
Microsoft Connector for Teradata provides a similar user experience to Attunity Teradata Connector. Users can design new packages based on previous experience, using SSDT for VS 2017 or VS 2019, with *targeting SQL server 2019*.
42
42
43
43
Teradata source and destination are under Common category.
44
44
45
45
:::image type="content" source="media/teradata-connector/teradata-component.png" alt-text="Screenshot the Teradata Component.":::
46
46
47
-
Teradata connection manager is displayed as "TERADATA".
47
+
Teradata connection manager is displayed as "TERADATA."
48
48
49
49
:::image type="content" source="media/teradata-connector/teradata-connection-manager-type.png" alt-text="Screenshot of the Teradata connection manager type":::
50
50
51
-
Existing SSIS packages that have been designed with Attunity Teradata Connector will be automatically upgraded to use Microsoft Connector for Teradata. The icons will be changed as well.
51
+
Existing SSIS packages designed with Attunity Teradata Connector will be automatically upgraded to use Microsoft Connector for Teradata. The icons will be changed as well.
52
52
53
-
To execute SSIS package *targeting SQL Server 2017 and below*, you'll need to install **Microsoft Connector for Teradata by Attunity** with corresponding version from below link:
53
+
To execute the SSIS package *targeting SQL Server 2017 and below*, you'll need to install **Microsoft Connector for Teradata by Attunity** with corresponding version from the below link:
54
54
55
55
-[SQL Server 2017: Microsoft Connector Version 5.0 for Teradata by Attunity](https://www.microsoft.com/download/details.aspx?id=55179)
56
56
-[SQL Server 2016: Microsoft Connector Version 4.0 for Teradata by Attunity](https://www.microsoft.com/download/details.aspx?id=52950)
57
57
-[SQL Server 2014: Microsoft Connector Version 3.0 for Teradata by Attunity](https://www.microsoft.com/download/details.aspx?id=44582)
58
58
-[SQL Server 2012: Microsoft Connector Version 2.0 for Teradata by Attunity](https://www.microsoft.com/download/details.aspx?id=29283)
59
59
60
-
To design SSIS package in SSDT *targeting SQL Server 2017 and below*, you'll need to have **Microsoft Connector for Teradata** and install **Microsoft Connector for Teradata by Attunity** with corresponding version.
60
+
To design the SSIS package in SSDT *targeting SQL Server 2017 and below*, you'll need to have **Microsoft Connector for Teradata** and install **Microsoft Connector for Teradata by Attunity** with the corresponding version.
61
61
62
-
## Limitationsandknownissues
62
+
## Limitationsandknownissues
63
63
64
-
- TeradataSource/DestinationEditor,**Defaultdatabase**propertydoesn'ttake effective. As work-around, typedatabasename in dropdownbox to filtertable or view.
64
+
- TeradataSource/DestinationEditor,**Defaultdatabase**propertydoesn'ttake effect. As a workaround, type the databasename in dropdownbox to filtertable or view.
65
65
66
-
- TeradataSource/DestinationEditor,Mappingstepdoesn'tworkwhentype`\<database>.<table/view>`. As work-around,type`\<database>.<table/view>`,thenselectthedrop-downbutton.
66
+
- TeradataSource/DestinationEditor,Mappingstepdoesn'tworkwhentype`\<database>.<table/view>`. As work-around,type`\<database>.<table/view>`,thenselectthedrop-downbutton.
67
67
68
-
- TeradataSourceEditor, viewcan't be displayedwhenDataaccessmode is "TableName – TPTExport". Aswork-around,useAdvancedEditor of TeradataSource.
68
+
- TeradataSourceEditor, viewcan't be displayedwhenDataaccessmode is "TableName – TPTExport." Aswork-around,useAdvancedEditor of TeradataSource.
69
69
70
-
- TeradataDestination,attribute"PackMaximum"can't be set to "True". Otherwise,errorwilloccur.
70
+
- TeradataDestination,attribute"PackMaximum"can't be set to "True." Otherwise,errorwilloccur.
71
71
72
72
- Teradata Source always reads columns in the order as they're defined in the table. ODBC, on the other hand, requires columns be read in a specific order in certain circumstances [Getting Long Data](../../odbc/reference/develop-app/getting-long-data.md) and [SQLGetData](../../relational-databases/native-client-odbc-api/sqlgetdata.md). When the two orders don't match, read fails with error message "Invalid descriptor index, descriptor record doesn't exist, or descriptor record wasn't properly initialized."
73
73
74
-
- Installing a new version over an old installation won't remove the old version entry from the installed program list. While this doesn't impact functioning of the new version, user can manually uninstall the old version in control panel "Programs, and Features" to get rid of the old version entry.
74
+
- Installing a new version over an old installation won't remove the old version entry from the installed program list. While this doesn't impact functioning of the new version, user can manually uninstall the old version in the control panel "Programs, and Features" to get rid of the old version entry.
75
75
76
76
## Uninstallation
77
77
78
-
You can run uninstall wizard to remove **Microsoft connector for Teradata**.
78
+
You can uninstall wizard to remove **Microsoft connector for Teradata**.
79
79
80
80
## Release Notes
81
81
82
82
### Rev. 233
83
83
84
-
**Bugfixes**
84
+
**Bug fixes**
85
+
85
86
- In a newly created Teradata Connection Manager, some required connection string properties like `DRIVER` aren't populated by default.
86
87
87
88
### Rev. 225
88
89
89
90
**New Features**
91
+
90
92
- Add support for TTU 17.10.
91
93
92
-
**Bugfixes**
93
-
- Incorrect data may be loaded by Teradata Source under certain circumstances.
94
-
- Default error table in Teradata Destination is incorrectly named and may not be created in the database of destination table.
94
+
**Bug fixes**
95
+
96
+
- Teradata Source may load incorrect data under certain circumstances.
97
+
- Default error table in Teradata Destination is incorrectly named and may not be created in the database of the destination table.
95
98
- Options specified in the connection string property of Teradata Connection Manager may not be picked up and therefore don't take effect.
96
99
97
100
### Rev. 197
98
101
99
-
**Bugfixes**
100
-
- When reading empty string data, Teradata Source would fail with error message "An error occurred when converting string to target codepage."
102
+
**Bug fixes**
103
+
104
+
- When reading empty string data, Teradata Source would fail with the error message "An error occurred when converting string to target codepage."
0 commit comments