sp_addlinkedserver (Transact-SQL)

Syntax

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

Argumente

• [ @server= ] 'server'
  Der Name des zu erstellenden Verbindungsservers. server ist vom Datentyp sysname und hat keinen Standardwert.

• [ @srvproduct= ] 'product_name'
  Der Produktname der OLE DB-Datenquelle, die als Verbindungsserver hinzugefügt werden soll. product_name ist vom Datentyp nvarchar(128), der Standardwert ist NULL. Bei SQL Server müssen provider_name, data_source, location, provider_string und catalog nicht angegeben werden.

• [ @provider= ] 'provider_name'
  Der eindeutige programmatische Bezeichner (PROGID, Programmatic Identifier) des OLE DB-Anbieters, der dieser Datenquelle entspricht. provider_name muss eindeutig für den angegebenen OLE DB-Anbieter sein, der auf dem aktuellen Computer installiert ist. provider_name ist vom Datentyp nvarchar(128), der Standardwert ist NULL. Wenn jedoch provider_name nicht angegeben wird, wird SQLNCLI verwendet. (Wenn Sie SQLNCLI verwenden, leitet SQL Server zur neuesten Version des OLE DB-Anbieters von SQL Server Native Client um.) Es wird vorausgesetzt, dass der OLE DB-Anbieter mit der angegebenen PROGID in der Registrierung registriert ist.

• [ @datasrc= ] 'data_source'
  Der Name der Datenquelle, so wie er vom OLE DB-Anbieter interpretiert wird. data_source ist vom Datentyp nvarchar(4000). data_source wird als DBPROP_INIT_DATASOURCE-Eigenschaft übergeben, um den OLE DB-Anbieter zu initialisieren.

• [ @location= ] 'location'
  Der Speicherort der Datenbank, so wie er vom OLE DB-Anbieter interpretiert wird. location ist vom Datentyp nvarchar(4000), der Standardwert ist NULL. location wird als DBPROP_INIT_LOCATION-Eigenschaft übergeben, um den OLE DB-Anbieter zu initialisieren.

• [ @provstr= ] 'provider_string'
  Die für den OLE DB-Anbieter zu verwendende Verbindungszeichenfolge, die eine eindeutige Datenquelle kennzeichnet. provider_string ist vom Datentyp nvarchar(4000), der Standardwert ist NULL. provstr wird entweder als IDataInitialize übergeben oder als DBPROP_INIT_PROVIDERSTRING-Eigenschaft festgelegt, um den OLE DB-Anbieter zu initialisieren.

  Wenn der Verbindungsserver für den OLE DB-Anbieter von SQL Server Native Client erstellt wird, kann die Instanz mit dem SERVER-Schlüsselwort in der Form SERVER=servername\instancename angegeben werden, um eine bestimmte Instanz von SQL Server anzugeben. servername ist der Name des Computers, auf dem SQL Server ausgeführt wird, und instancename ist der Name der Instanz von SQL Server, zu der der Benutzer eine Verbindung herstellt.

  Hinweis

  Der Zugriff auf eine gespiegelte Datenbank ist nur dann möglich, wenn eine Verbindungszeichenfolge den Datenbanknamen enthält. Dieser Name ist notwendig, um Failoverversuche des Datenzugriffsanbieters zu ermöglichen. Die Datenbank kann im Parameter @provstr oder @catalog angegeben werden. Optional kann in der Verbindungszeichenfolge auch ein Failoverpartnername angegeben werden. Weitere Informationen finden Sie unter Herstellen der Anfangsverbindung mit einer Datenbank-Spiegelungssitzung.

• [ @catalog= ] 'catalog'
  Der Katalog, der beim Herstellen einer Verbindung mit dem OLE DB-Anbieter verwendet werden soll. catalog ist vom Datentyp sysname, der Standardwert ist NULL. catalog wird als DBPROP_INIT_CATALOG-Eigenschaft übergeben, um den OLE DB-Anbieter zu initialisieren. Wenn der Verbindungsserver für eine Instanz von SQL Server definiert wird, verweist catalog auf die Standarddatenbank, der der Verbindungsserver zugeordnet ist.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine.

Hinweise

Die folgende Tabelle zeigt die Einrichtungsmöglichkeiten eines Verbindungsservers für Datenquellen, auf die über OLE DB zugegriffen werden kann. Für die Einrichtung eines Verbindungsservers für eine bestimmte Datenquelle gibt es mehrere Möglichkeiten; für die einzelnen Datenquellentypen sind möglicherweise mehrere Zeilen vorhanden. In der folgenden Tabelle werden außerdem die Parameterwerte für sp_addlinkedserver aufgeführt, die zum Einrichten des Verbindungsservers verwendet werden sollten.

1 Diese Möglichkeit der Einrichtung eines Verbindungsservers erzwingt, dass der Name des Verbindungsservers mit dem Netzwerknamen der Remoteinstanz von SQL Server identisch ist. Verwenden Sie data_source, um den Server anzugeben.

2 Zeigt an, dass der Produktname beliebig ist.

Der OLE DB-Anbieter von MicrosoftSQL Server wird für SQL Server verwendet, wenn kein Anbietername angegeben ist oder wenn SQL Server als Produktname angegeben ist. Selbst wenn Sie den älteren Anbieternamen, SQLOLEDB, angeben, wird er beim Speichern im Katalog in SQLNCLI geändert.

Die Parameter data_source, location, provider_string und catalog identifizieren die Datenbank(en), auf die der Verbindungsserver verweist. Falls einer dieser Parameter den Wert NULL hat, wird die entsprechende OLE DB-Initialisierungseigenschaft nicht festgelegt.

Verwenden Sie in einer Clusterumgebung, wenn Sie Dateinamen angeben, um auf OLE DB-Datenquellen zu verweisen, den UNC-Namen (Universal Naming Convention) oder ein freigegebenes Laufwerk, um den Speicherort anzugeben.

sp_addlinkedserver kann nicht innerhalb einer benutzerdefinierten Transaktion ausgeführt werden.

Sicherheitshinweis

Wird ein Verbindungsserver mithilfe von sp_addlinkedserver erstellt, wird für alle lokalen Anmeldenamen eine standardmäßige Selbstzuordnung hinzugefügt. Für andere als SQL Server-Anbieter können mit SQL Server authentifizierte Anmeldenamen möglicherweise unter dem SQL Server-Dienstkonto auf den Anbieter zugreifen. Administratoren sollten eventuell sp_droplinkedsrvlogin <linkedserver_name>, NULL verwenden, um die globale Zuordnung zu entfernen.

Berechtigungen

Erfordert die ALTER ANY LINKED SERVER-Berechtigung.

Beispiele

A. Verwenden des OLE DB-Anbieters von Microsoft SQL Server Native Client

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

EXEC sp_addlinkedserver   
   @server='S1_instance1', 
   @srvproduct='',
   @provider='SQLNCLI', 
   @datasrc='S1\instance1'

B. Verwenden von Microsoft OLE DB-Anbieter für Microsoft Access

Der Microsoft.Jet.OLEDB.4.0-Anbieter stellt eine Verbindung mit Microsoft Access-Datenbanken mit dem Format 2002-2003 her. Im folgenden Beispiel wird der Verbindungsserver SEATTLE Mktg erstellt.

Hinweis
In diesem Beispiel wird davon ausgegangen, dass Microsoft Access und die Northwind-Beispieldatenbank installiert sind und dass sich die Northwind-Datenbank im Verzeichnis C:\Msoffice\Access\Samples befindet.

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

Der Microsoft.ACE.OLEDB.12.0-Anbieter stellt eine Verbindung mit Microsoft Access-Datenbanken mit dem Format 2007 her. Im folgenden Beispiel wird der Verbindungsserver SEATTLE Mktg erstellt.

Hinweis
In diesem Beispiel wird davon ausgegangen, dass Microsoft Access und die Northwind-Beispieldatenbank installiert sind und dass sich die Northwind-Datenbank im Verzeichnis C:\Msoffice\Access\Samples befindet.

EXEC sp_addlinkedserver 
   @server = 'SEATTLE Mktg', 
   @provider = 'Microsoft.ACE.OLEDB.12.0', 
   @srvproduct = 'OLE DB Provider for ACE',
   @datasrc = 'C:\MSOffice\Access\Samples\Northwind.accdb'
GO

Verwenden von Microsoft OLE DB-Anbieter für Oracle

EXEC sp_addlinkedserver
   @server = 'LONDON Mktg',
   @srvproduct = 'Oracle',
   @provider = 'MSDAORA',
   @datasrc = 'MyServer'
GO

D. Verwenden von Microsoft OLE DB-Anbieter für ODBC mit dem data_source-Parameter

Im folgenden Beispiel wird der Verbindungsserver SEATTLE Payroll erstellt, der den Microsoft OLE DB-Anbieter für ODBC (MSDASQL) und den data_source-Parameter verwendet.

Hinweis
Der angegebene ODBC-Datenquellenname muss vor der Verwendung des Verbindungsservers auf dem Server als System-DSN definiert werden.

EXEC sp_addlinkedserver 
   @server = 'SEATTLE Payroll', 
   @srvproduct = '',
   @provider = 'MSDASQL', 
   @datasrc = 'LocalServer'
GO

E. Verwenden von Microsoft OLE DB-Anbieter für eine Microsoft Excel-Kalkulationstabelle

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

SELECT *
   FROM ExcelSource...SalesData
GO

EXEC sp_addlinkedserver 'ExcelShare',
   'Jet 4.0',
   'Microsoft.Jet.OLEDB.4.0',
   '\\MyServer\MyShare\Spreadsheets\DistExcl.xls',
   NULL,
   'Excel 5.0'

EXEC sp_addlinkedserver @server = N'ExcelDataSource', 
@srvproduct=N'ExcelData', @provider=N'Microsoft.ACE.OLEDB.12.0', 
@datasrc=N'C:\DataFolder\People.xlsx',
@provstr='EXCEL 12.0' ;

F. Verwenden von Microsoft OLE DB-Anbieter für Jet für den Zugriff auf eine Textdatei

--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 four-part name. 
SELECT * 
FROM txtsrv...[file1#txt]

G. Verwenden von Microsoft OLE DB-Anbieter für DB2

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;'

Siehe auch

Verweis

Konzepte