Transact-SQL 參考

sp_addlinkedserver

創建一個鏈接的服務器，使其允許對分佈式的、針對 OLE DB 數據源的異類查詢進行訪問。在使用 sp_addlinkedserver 創建鏈接的服務器之後，此服務器就可以執行分佈式查詢。如果鏈接服務器定義爲 Microsoft® SQL Server™，則可執行遠程存儲過程。

語法

sp_addlinkedserver [ @server = ] ' server '
     [ , [ @srvproduct = ] ' product_name ' ]
    [ , [ @provider = ] ' provider_name ' ]
    [ , [ @datasrc = ] ' data_source ' ]
    [ , [ @location = ] ' location ' ]
    [ , [ @provstr = ] ' provider_string ' ]
    [ , [ @catalog = ] ' catalog ' ]

參數

[ @server = ] ' server '

要創建的鏈接服務器的本地名稱，server 的數據類型爲 sysname ，沒有默認設置。

如果有多個 SQL Server 實例，server 可以爲 servername/instancename 。此鏈接的服務器可能會被引用爲下面示例的數據源：

SELECT *FROM    [servername/instancename.]pubs.dbo.authors. 
--查看已有實例
select * from master.dbo.sysservers

如果未指定 data_source ，則服務器爲該實例的實際名稱。

[ @srvproduct = ] ' product_name '

要添加爲鏈接服務器的 OLE DB 數據源的產品名稱。product_name 的數據類型爲 nvarchar(128) ，默認設置爲 NULL。如果是 SQL Server ，則不需要指定 provider_name 、data_source 、location 、provider_string 以及目錄。

[ @provider = ] ' provider_name '

與此數據源相對應的 OLE DB 提供程序的唯一程序標識符 (PROGID)。provider_name 對於安裝在當前計算機上指定的 OLE DB 提供程序必須是唯一的。provider_name 的數據類型爲nvarchar(128) ，默認設置爲 NULL。OLE DB 提供程序應該用給定的 PROGID 在註冊表中註冊。

[ @datasrc = ] ' data_source '

由 OLE DB 提供程序解釋的數據源名稱。data_source 的數據類型爲 nvarchar(4000) ，默認設置爲 NULL。data_source 被當作 DBPROP_INIT_DATASOURCE 屬性傳遞以便初始化 OLE DB 提供程序。

當鏈接的服務器針對於 SQL Server OLE DB 提供程序創建時，可以按照 servername /instancename 的形式指定 data_source， 它可以用來連接到運行於特定計算機上的 SQL Server 的特定實例上。servername 是運行 SQL Server 的計算機名稱，instancename 是用戶將被連接到的特定 SQL Server 實例的名稱。

[ @location = ] ' location '

OLE DB 提供程序所解釋的數據庫的位置。location 的數據類型爲 nvarchar(4000) ，默認設置爲 NULL。location 作爲 DBPROP_INIT_LOCATION 屬性傳遞以便初始化 OLE DB 提供程序。

[ @provstr = ] ' provider_string '

OLE DB 提供程序特定的連接字符串，它可標識唯一的數據源。provider_string 的數據類型爲 nvarchar(4000) ，默認設置爲 NULL。Provstr 作爲 DBPROP_INIT_PROVIDERSTRING 屬性傳遞以便初始化 OLE DB 提供程序。

當針對 Server OLE DB 提供程序提供了鏈接服務器後，可將 SERVER 關鍵字用作 SERVER=servername /instancename 來指定實例，以指定特定的 SQL Server 實例。servername 是 SQL Server 在其上運行的計算機名稱，instancename 是用戶連接到的特定的 SQL Server 實例名稱。

[ @catalog = ] ' catalog '

建立 OLE DB 提供程序的連接時所使用的目錄。catalog 的數據類型爲sysname ，默認設置爲 NULL。catalog 作爲 DBPROP_INIT_CATALOG 屬性傳遞以便初始化 OLE DB 提供程序。

返回代碼值

0（成功）或 1（失敗）

結果集

如果沒有指定參數，則 sp_addlinkedserver 返回此消息：

Procedure 'sp_addlinkedserver' expects parameter '@server', which was not supplied.使用適當 OLE DB 提供程序和參數的 sp_addlinkedserver 返回此消息：

Server added.

註釋

下表顯示爲可通過 OLE DB 訪問的數據源設置鏈接服務器的方法。對於給定的數據源，可以使用多種方法爲其設置鏈接服務器，下表中可能有不止一行適用於一種數據源類型。下表也顯示了用於設置鏈接服務器的 sp_addlinkedserver 參數值。

遠程 OLE DB 數據源	OLE DB 提供程序	product_name	provider_name	data_source	location	provider_string	catalog
SQL Server	用於 SQL Server 的 Microsoft OLE DB 提供程序	SQL Server (1)（默認值）	-	-	-	-	-
SQL Server	用於 SQL Server 的 Microsoft OLE DB 提供程序	SQL Server	SQLOLEDB	SQL Server 的網絡名稱（用於默認實例）	-	-	數據庫名稱（可選）
SQL Server	用於 SQL Server 的 Microsoft OLE DB 提供程序	-	SQLOLEDB	服務器名/實例名（對於特定實例）	-	-	數據庫名稱（可選）
Oracle	用於 Oracle 的 Microsoft OLE DB 提供程序	任何 (2)	MSDAORA	用於 Oracle 數據庫的 SQL*Net 別名	-	-	-
Access/ Jet	用於 Jet 的 Microsoft OLE DB 提供程序	任何	Microsoft.Jet.OLEDB.4.0	Jet 數據庫文件的完整路徑名	-	-	-
ODBC 數據源	用於 ODBC 的 Microsoft OLE DB 提供程序	任何	MSDASQL	ODBC 數據源的系統 DSN	-	-	-
ODBC 數據源	用於 ODBC 的 Microsoft OLE DB 提供程序	任何	MSDASQL	-	-	ODBC 連接字符串	-
文件系統	用於索引服務的 Microsoft OLE DB 提供程序	任何	MSIDXS	索引服務目錄名稱	-	-	-
Microsoft Excel 電子表格	用於 Jet 的 Microsoft OLE DB 提供程序	任何	Microsoft.Jet.OLEDB.4.0	Excel 文件的完整路徑名	-	Excel 5.0	-
IBM DB2 數據庫	用於 DB2 的Microsoft OLE DB 提供程序	任何	DB2OLEDB	-	-	請參見用於 DB2 文檔的 Microsoft OLE DB 提供程序	DB2 數據庫的目錄名

(1 ) 這種設置鏈接服務器的方式強制鏈接服務器的名稱與遠程 SQL Server 的網絡名稱相同。使用 server 指定服務器。
(2 ) "任何"指產品名稱可以任意。

data_source 、location 、provider_string 和 catalog 參數標識鏈接服務器指向的數據庫。如果任一參數爲 NULL 值，則不設置相應的 OLE DB 初始化屬性。

說明若要在 SQL Server 6.x 版上使用 SQL Server 2000 版的 Microsoft OLE DB 提供程序，請在 6.x 版 SQL Server 上運行 /Microsoft SQL Server/Install/Instcat.sql 腳本。此腳本對於在 SQL Server 6.x 服務器上運行分佈式查詢是基本的。

在羣集環境中，當指定指向 OLE DB 數據源的文件名時，應使用通用命名規則 (UNC) 名稱或共享驅動器指定位置。

權限

執行許可權限默認授予 sysadmin 和 setupadmin 固定服務器角色的成員。

示例

A. 使用用於 SQL Server 的 Microsoft OLE DB 提供程序

使用用於 SQL Server 的 OLE DB 創建鏈接服務器
下面的示例創建一臺名爲 SEATTLESales 的鏈接服務器，該服務器使用用於 SQL Server 的 Microsoft OLE DB 提供程序。USE master GO EXEC sp_addlinkedserver 'SEATTLESales', N'SQL Server' GO
在 SQL Server 的實例上創建鏈接服務器
此示例在 SQL Server 的實例上創建一臺名爲 S1_instance1 的鏈接服務器，該服務器使用 SQL Server 的 Microsoft OLE DB 提供程序。
```
EXEC sp_addlinkedserver   
@server='S1_instance1', 
@srvproduct='',
@provider='SQLOLEDB', 
@datasrc='S1/instance1'
```

B. 使用用於 Jet 的 Microsoft OLE DB 提供程序

此示例創建一臺名爲 SEATTLE Mktg 的鏈接服務器。

說明本示例假設已經安裝 Microsoft Access 和示例 Northwind 數據庫，且 Northwind 數據庫駐留在 C:/Msoffice/Access/Samples。

USE master GO -- To use named parameters: EXEC sp_addlinkedserver @server = 'SEATTLE Mktg', @provider = 'Microsoft.Jet.OLEDB.4.0', @srvproduct = 'OLE DB Provider for Jet', @datasrc = 'C:/MSOffice/Access/Samples/Northwind.mdb' GO -- OR to use no named parameters: USE master GO EXEC sp_addlinkedserver 'SEATTLE Mktg', 'OLE DB Provider for Jet', 'Microsoft.Jet.OLEDB.4.0', 'C:/MSOffice/Access/Samples/Northwind.mdb' GO

C. 使用用於 Oracle 的 Microsoft OLE DB 提供程序

此示例創建一臺名爲 LONDON Mktg 的鏈接服務器，該服務器使用用於 Oracle 的 Microsoft OLE DB 提供程序，並且假設此 Oracle 數據庫的 SQL*Net 別名爲 MyServer 。
USE master GO -- To use named parameters: EXEC sp_addlinkedserver @server = 'LONDON Mktg', @srvproduct = 'Oracle', @provider = 'MSDAORA', @datasrc = 'MyServer' GO -- OR to use no named parameters: USE master GO EXEC sp_addlinkedserver 'LONDON Mktg', 'Oracle', 'MSDAORA', 'MyServer' GO

D. 將 data_source 參數與用於 ODBC 的 Microsoft OLE DB 提供程序一起使用

此示例創建一臺名爲 SEATTLE Payroll 的鏈接服務器，該服務器使用用於 ODBC 的 Microsoft OLE DB 提供程序和 data_source 參數。

說明在執行 sp_addlinkedserver 之前，必須在服務器上將指定的 ODBC 數據源名稱定義爲系統 DSN。
USE master GO -- To use named parameters: EXEC sp_addlinkedserver @server = 'SEATTLE Payroll', @provider = 'MSDASQL', @datasrc = 'LocalServer' GO -- OR to use no named parameters: USE master GO EXEC sp_addlinkedserver 'SEATTLE Payroll', '', 'MSDASQL', 'LocalServer' GO

E. 將 provider_string 參數與用於 ODBC 的 Microsoft OLE DB 提供程序一起使用

此示例創建一臺名爲 LONDON Payroll 的鏈接服務器，該服務器使用用於 ODBC 的 Microsoft OLE DB 提供程序和 provider_string 參數。

說明有關 ODBC 連接字符串的更多信息，請參見 SQLDriverConnect 和如何分配句柄並與 SQL Server (ODBC) 連接。

USE master GO -- To use named parameters: EXEC sp_addlinkedserver @server = 'LONDON Payroll', @provider = 'MSDASQL', @provstr = 'DRIVER={SQL Server};SERVER=MyServer;UID=sa;PWD=;' GO -- OR to use no named parameters: USE master GO EXEC sp_addlinkedserver 'LONDON Payroll', '', 'MSDASQL', NULL, NULL, 'DRIVER={SQL Server};SERVER=MyServer;UID=sa;PWD=;' GO

F. 在 Excel 電子表格上使用用於 Jet 的 Microsoft OLE DB 提供程序

若要創建使用用於 Jet 的 Microsoft OLE DB 提供程序以訪問 Excel 電子表格的鏈接服務器定義，請首先在 Excel 中創建一個命名的範圍以指定要在 Excel 工作表中選擇的行和列。然後，可將此範圍的名稱引用爲分佈式查詢中的表名稱。

EXEC sp_addlinkedserver 'ExcelSource', 'Jet 4.0', 'Microsoft.Jet.OLEDB.4.0', 'c:/MyData/DistExcl.xls', NULL, 'Excel 5.0' GO

爲了訪問 Excel 電子表格中的數據，請將某個範圍內的單元與某個名稱相關聯。通過將範圍的名稱用作表名稱，可以訪問指定的已命名範圍。下列查詢利用前面設置的鏈接服務器，可訪問稱爲 SalesData 的命名範圍。
SELECT * FROM EXCEL...SalesData GO

G. 使用用於檢索服務的 Microsoft OLE DB 提供程序

此示例創建一臺鏈接服務器，並且使用 OPENQUERY 從爲檢索服務啓用的鏈接服務器和文件系統中檢索信息。

H. 使用用於 Jet 的 Microsoft OLE DB 提供程序訪問文本文件

此示例創建一臺直接訪問文本文件的鏈接服務器，而沒有將這些文件鏈接爲 Access .mdb 文件中的表。提供程序是 Microsoft.Jet.OLEDB.4.0，提供程序字符串爲"Text"。

數據源是包含文本文件的目錄的完整路徑名。schema.ini 文件（描述文本文件的結構）必須與此文本文件存在於相同的目錄中。有關創建 schema.ini 文件的更多信息，請參見 Jet 數據庫引擎文檔。
--Create a linked server EXEC sp_addlinkedserver txtsrv, 'Jet 4.0', 'Microsoft.Jet.OLEDB.4.0', 'c:/data/distqry', NULL, 'Text' GO --Set up login mappings EXEC sp_addlinkedsrvlogin txtsrv, FALSE, Admin, NULL GO --List the tables in the linked server EXEC sp_tables_ex txtsrv GO --Query one of the tables: file1#txt --using a 4-part name SELECT * FROM txtsrv...[file1#txt]

I. 使用用於 DB2 的 Microsoft OLE DB 提供程序

下面的示例創建一臺名爲 DB2 的鏈接服務器，該服務器使用用於 DB2 的 Microsoft OLE DB 提供程序。

EXEC sp_addlinkedserver @server='DB2', @srvproduct='Microsoft OLE DB Provider for DB2', @catalog='DB2', @provider='DB2OLEDB', @provstr='Initial Catalog=PUBS;Data Source=DB2;HostCCSID=1252;Network Address=XYZ;Network Port=50000;Package Collection=admin;Default Schema=admin;'