%META:TOPICPARENT{name="VirtMySQLEntityFrameworkUsage"}%

===Linking Tables from <nop>MySQL into Virtuoso===

1. Start the Virtuoso Web User Interface.
%BR%%BR%<img src="%ATTACHURLPATH%/VirtWebHome.png" style="wikiautogen"/>%BR%%BR%

2. Select the **Conductor** link in the left frame and login as the **dba** user.
%BR%%BR%<img src="%ATTACHURLPATH%/VirtConductor.png" style="wikiautogen"/>%BR%%BR%

3. Select the **Databases** -> **External Data Source** -> **Data Sources** tab menu items.
%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS0.png" style="wikiautogen"/>%BR%%BR%

4. Select the **Connect** button for the **mysqlma** <nop>MySQL DSN.
%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS1.png" style="wikiautogen"/>%BR%%BR%

5. On succesful connection, select the **Link Objects** button to obtain a list of available tables.
%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS2.png" style="wikiautogen"/>%BR%%BR%

6. Select all the tables that are part of the **mysql** catalog.
%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS3.png" style="wikiautogen"/>%BR%%BR%

7. Ensure a primary key is assigned to all tables that are to be used in the EDM generation phase.
%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS4.png" style="wikiautogen"/>%BR%%BR%

8. Change the Catalog for each table to be **mysql** using the **Set All** button.%BR%%BR%
9. Select the **Link** button to link the selected tables into Virtuoso.
%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS5.png" style="wikiautogen"/>%BR%%BR%

10. On completion of the Link process, the tables will be displayed in the **External Linked Objects** tab.

%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS6.png" style="wikiautogen"/>%BR%

11. The linked tables can be queried by clicking on the hyperlink in the **Local Name** column of the **External Linked Objects** tab above. This loads the Virtuoso **Interactive SQL** interface with the required SQL **Select** for retrieving the remote table data. We shall use the **mysql.mysqlma.artist** table to demonstrate this.

%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS9.png" style="wikiautogen"/>%BR%%BR%

12. Click the **Execute** button to run the query and retrieve the results from the remote table.

%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS10.png" style="wikiautogen"/>%BR%%BR%

13. The tables can also be viewed as part of the Virtuoso **SQL Schema Objects** under the **mysql** catalog name.
%BR%%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS7.png" style="wikiautogen"/>%BR%
.%BR%
.%BR%
.
%BR%<img src="%ATTACHURLPATH%/VirtLinkMYS8.png" style="wikiautogen"/>%BR%%BR%

The link process is now complete enabling the tables to be queried as if part of the Virtuoso Schema.