| content
| - %VOSWARNING%
%META:TOPICPARENT{name="VirtLinkRemoteTables"}%
---+ Linking Microsoft SQL Server Database Objects (Tables, Views, and Stored Procedures) into Virtuoso
---++ Prerequisites
* Virtuoso Universal Server, Commercial Edition%BR%
Virtuoso Universal Server Release 6.x or later is recommended, optimally the latest version available.%BR%%BR%
* ODBC Driver for Microsoft SQL Server%BR%
The Virtuoso Server uses an ODBC Driver for Microsoft SQL Server to link in the Microsoft SQL Server Schema Objects (Tables, Views, and Stored Procedures). The OpenLink Multi-Tier ODBC Driver for Microsoft SQL Server will be used in this document, and a functional ODBC Data Source Name (DSN) of
sql25ma will be assumed to exist on the machine hosting the Virtuoso Server. Any ODBC compliant driver for Microsoft SQL Server should work.%BR%%BR%
* Microsoft SQL Server DBMS%BR%
A Microsoft SQL Server DBMS hosting the required Schema Objects (Tables, Views, and Stored Procedures) needs to be available. This may be on any host which is TCP/IP accessible from the Virtuoso Server host. In this document, the Microsoft SQL Server Northwind sample database will be used to demonstrate the process.%BR%%BR%
---++ Steps
1 Load the HTTP-based Virtuoso User Interface in your browser.
%BR%%BR% %BR%%BR%
1 Click the Conductor link in the left-side navbar, and log in as a user with DBA privileges, such as the default dba user.
%BR%%BR% %BR%%BR%
1 Drill down to the Databases -> External Data Source -> Data Sources tab.
%BR%%BR% %BR%%BR%
1 Locate the DSN for the desired remote data source (we're using sql25ma for this example). If not yet connected to the
DSN, click Connect, and input your user credentials for the remote data source.
%BR%%BR% %BR%%BR%
1 Once connected to the DSN, click the associated Link objects to get a list of available objects (tables, views, stored procedures).
%BR%%BR% %BR%%BR%
1 Locate and select the desired objects.
%BR%%BR% %BR%%BR%
* You can use the Catalog and Schema drop-down selectors and the table name test-entry box to construct a filter to shorten the visible list.
* For this example, we'll choose the main tables from Microsoft's sample Northwind.dbo schema -- Categories, CustomerCustomerDemo, CustomerDemographics, Customers, Employees, EmployeeTerritories, Order Details, Orders, Products, Region, Shippers, Suppliers, Territories.
* When all desired objects are selected, click the Link... button.
1 Virtuoso will interrogate the remote data source to learn about primary keys, and present you with a default linkage setup.
%BR%%BR% %BR%%BR%
1 You can adjust the Virtuoso catalog, schema/owner, and object identifiers to suit your goals. The Set To All button can be used to speed the process. In this example, we'll put all linked objects into the sqlserver catalog, and the northwind schema. We'll leave the object identifiers unchanged.
%BR%%BR% %BR%%BR%
* Sometimes a primary key is not reported properly, or you want to use a different key, either simple or compound. Click Edit next to the primary key you want to change, and select the columns that Virtuoso should use for the purpose --
%BR%%BR% %BR%%BR%
1 When all are set as desired, click the Link button to link the objects into Virtuoso. Virtuoso may take some time to complete this step, depending on network infrastructure, DBMS load, etc.
1 The Link process will complete by listing the linked objects in the Databases -> External Data Source -> External Linked Objects tab.
%BR%%BR% %BR%%BR%
---++ Confirmation and Testing
---+++ Working with External Linked Objects (Tables, Views, and Stored Procedures)
1 Linked object are shown in the Databases -> External Data Source -> External Linked Objects tab.
%BR%%BR%%BR%%BR%
1 Clicking the hyperlinked Local Name of the External Linked Objects will load the Virtuoso Interactive SQL (iSQL) HTTP interface (in a new browser tab or window) with a default SELECT * SQL query.
For instance, clicking on sqlserver.northwind.Employees brings --
%BR%%BR% %BR%%BR%
1 Click the Execute button to run the query. Virtuoso will retrieve the results from the remote table. Note: By default, iSQL will "Show no more than 100 rows ." You can change this value as desired.
%BR%%BR% %BR%%BR%
---+++ Working with SQL Database Objects (Tables, Views, and Stored Procedures)
1 Linked objects are also visible through the Database -> SQL Database Object tab, just as if they were local Virtuoso data.
%BR%%BR% %BR%%BR%
1 Simply drill down to the Catalog you set while linking --
%BR%%BR% %BR%%BR%
1 As you might expect, clicking on any of the Action links will reveal the table definition, indexes, triggers, constraints, or privileges. For example, clicking Definition for sqlserver.northwind.Employees --
%BR%%BR% %BR%%BR%
---++ Related
* [[VOSSQL2RDF][Mapping SQL Data to Linked Data Views]]
* [[VirtMSSQLServerEntityFrameworkUsage][Using Microsoft Entity Frameworks to Access Microsoft SQL Server Schema Objects (Tables, Views, and Stored Procedures) with Virtuoso]]
CategoryDocumentation CategoryVirtuoso CategoryDotNET CategoryEntityFrameworks CategoryWebSite |
![[RDF Data]](/fct/images/sw-rdf-blue.png)
![[cxml]](/fct/images/cxml_doc.png)
![[csv]](/fct/images/csv_doc.png)
![[text]](/fct/images/ntriples_doc.png)
![[turtle]](/fct/images/n3turtle_doc.png)
![[ld+json]](/fct/images/jsonld_doc.png)
![[rdf+json]](/fct/images/json_doc.png)
![[rdf+xml]](/fct/images/xml_doc.png)
![[atom+xml]](/fct/images/atom_doc.png)
![[html]](/fct/images/html_doc.png)