sql 分佈式查詢 （sp_addlinkedserver使用方法）

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 提供程序

1. 使用用於 SQL Server 的 OLE DB 創建鏈接服務器

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

   USE master
   GO
   EXEC sp_addlinkedserver
   
       'SEATTLESales',
   
       N'SQL Server'
   GO

2. 在 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;'

請參見

配置鏈接服務器

用 SQL Server 測試過的 OLE DB 提供程序

sp_addlinkedsrvlogin

sp_addserver

sp_dropserver

sp_serveroption

sp_setnetname

系統存儲過程

系統表

.mboxDefault { visibility: hidden; }