sp_addlinkedserver (Transact-SQL)

Actualizado: 12 de diciembre de 2006

Crea un servidor vinculado. Un servidor vinculado permite obtener acceso a consultas heterogéneas distribuidas en orígenes de datos OLE DB. Después de crear un servidor vinculado mediante sp_addlinkedserver, se pueden ejecutar consultas distribuidas en este servidor. Si el servidor vinculado se define como una instancia de SQL Server, se pueden ejecutar procedimientos almacenados remotos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

• [ @server= ] 'server'
  Es el nombre del servidor vinculado que se va a crear. server es de tipo sysname y no tiene un valor predeterminado.

• [ @srvproduct= ] 'product_name'
  Es el nombre de producto del origen de datos OLE DB que se va a agregar como servidor vinculado. product_name es de tipo nvarchar(128) y tiene un valor predeterminado NULL. En SQL Server no necesita especificar provider_name, data_source, location, provider_string ni catalog.

• [ @provider= ] 'provider_name'
  Es el identificador de programación único (PROGID) del proveedor OLE DB correspondiente a este origen de datos. provider_name debe ser único para el proveedor OLE DB especificado que se ha instalado en el equipo actual. provider_name es de tipo nvarchar(128) y su valor predeterminado es NULL. No obstante, si se omite provider_name, se utilizará SQLNCLI. SQLNCLI es el proveedor OLE DB de SQL Native Client. Se espera que el proveedor OLE DB se registre con el PROGID especificado en el registro.

• [ @datasrc= ] 'data_source'
  Es el nombre del origen de datos según lo interpreta el proveedor OLE DB. data_source es de tipo nvarchar(4000). data_source se pasa como la propiedad DBPROP_INIT_DATASOURCE para inicializar el proveedor OLE DB.

• [ @location= ] 'location'
  Es la ubicación de la base de datos según la interpreta el proveedor OLE DB. location es de tipo nvarchar(4000) y su valor predeterminado es NULL. location se pasa como la propiedad DBPROP_INIT_LOCATION para inicializar el proveedor OLE DB.

• [ @provstr= ] 'provider_string'
  Es la cadena de conexión específica del proveedor OLE DB que identifica un origen de datos único. provider_string es de tipo nvarchar(4000) y su valor predeterminado es NULL. provstr se pasa a IDataInitialize o se establece como la propiedad DBPROP_INIT_PROVIDERSTRING para inicializar el proveedor OLE DB.

  Cuando se crea el servidor vinculado para el proveedor OLE DB de SQL Native Client, la instancia puede especificarse mediante la palabra clave SERVER, como SERVER=servername\instancename, para especificar una instancia específica de SQL Server. servername es el nombre del equipo en el que se ejecuta SQL Server e instancename es el nombre de la instancia de SQL Server específica a la que se conectará el usuario.

  [!NOTA] Para tener acceso a una base de datos reflejada, una cadena de conexión debe contener el nombre de la base de datos. Este nombre es necesario para que el proveedor de acceso a datos pueda intentar la conmutación por error. La base de datos se puede especificar en el parámetro @provstr o @catalog. Opcionalmente, la cadena de conexión también puede proporcionar un nombre de asociado de conmutación por error. Para obtener más información, vea Establecer la conexión inicial en una sesión de creación de reflejo de la base de datos.

• [ @catalog= ] 'catalog'
  Es el catálogo que va a utilizarse cuando se establezca una conexión con el proveedor OLE DB. catalog es de tipo sysname y su valor predeterminado es NULL. catalog se pasa como la propiedad DBPROP_INIT_CATALOG para inicializar el proveedor OLE DB. Cuando se define el servidor vinculado en una instancia de SQL Server, catalog se refiere a la base de datos predeterminada a la que se asigna el servidor vinculado.

Conjuntos de resultados

Ninguno.

Notas

En la tabla siguiente se muestran las distintas maneras de configurar un servidor vinculado para los orígenes de datos a los que se puede tener acceso a través de OLE DB. Existen varias formas de configurar un servidor vinculado para un origen de datos determinado; puede haber más de una fila por tipo de origen de datos. En la tabla siguiente también se muestran los valores de parámetro de sp_addlinkedserver que se deben utilizar para configurar el servidor vinculado.

Origen de datos remotos de OLE DB	Proveedor OLE DB	product_name	provider_name	data_source	location	provider_string	catalog
SQL Server	Proveedor OLE DB de Microsoft SQL Native Client	SQL Server 1 (predeterminado)
SQL Server	Proveedor OLE DB de Microsoft SQL Native Client		SQLNCLI	Nombre de red de SQL Server (para la instancia predeterminada)			Nombre de la base de datos (opcional)
SQL Server	Proveedor OLE DB de Microsoft SQL Native Client		SQLNCLI	nombreDeServidor\nombreDeInstancia (para una instancia específica)			Nombre de la base de datos (opcional)
Oracle	Proveedor Microsoft OLE DB para Oracle	Cualquiera2	MSDAORA	Alias de SQL*Net para base de datos Oracle
Oracle, versión 8 y posterior	Proveedor Oracle para OLE DB	Cualquiera	OraOLEDB.Oracle	Alias para base de datos Oracle
Access/Jet	Proveedor Microsoft OLE DB para Jet	Cualquiera	Microsoft.Jet.OLEDB.4.0	Ruta de acceso completa del archivo de base de datos Jet
Origen de datos ODBC	Proveedor Microsoft OLE DB para ODBC	Cualquiera	MSDASQL	DSN del sistema del origen de datos ODBC
Origen de datos ODBC	Proveedor Microsoft OLE DB para ODBC	Cualquiera	MSDASQL			Cadena de conexión ODBC
Sistema de archivos	Proveedor Microsoft OLE DB para Servicios de Index Server	Cualquiera	MSIDXS	Nombre de catálogo de Servicios de Index Server
Hoja de cálculo de Microsoft Excel	Proveedor Microsoft OLE DB para Jet	Cualquiera	Microsoft.Jet.OLEDB.4.0	Ruta de acceso completa del archivo Excel		Excel 5.0
Bases de datos IBM DB2	Proveedor Microsoft OLE DB para DB2	Cualquiera	DB2OLEDB			Vea la documentación del proveedor Microsoft OLE DB para DB2.	Nombre del catálogo de la base de datos DB2

1 Esta forma de configurar un servidor vinculado obliga a que el nombre del servidor vinculado sea igual al nombre de red de la instancia remota de SQL Server. Utilice data_source para especificar el servidor.

2 "Cualquiera" indica que el nombre de producto puede ser cualquier nombre.

El proveedor OLE DB de Microsoft SQL Native Client (SQLNCLI) es el proveedor utilizado con SQL Server 2005 si no se especifica un nombre de proveedor o si se especifica SQL Server como el nombre de producto. Incluso si especifica el nombre de proveedor antiguo, SQLOLEDB, éste se cambiará a SQLNCLI cuando se mantenga en el catálogo.

Los parámetros data_source, location, provider_string y catalog identifican la base o bases de datos a las que apunta en servidor vinculado. Si alguno de estos parámetros es NULL, no se establecerá la propiedad de inicialización de OLE DB correspondiente.

En un entorno agrupado, al especificar nombres de archivo para apuntar a orígenes de datos OLE DB, utilice el nombre UNC (convención de nomenclatura universal) o una unidad compartida para especificar la ubicación.

sp_addlinkedserver no se puede ejecutar dentro de una transacción definida por el usuario.

Nota de seguridad:

Cuando se agrega un servidor vinculado utilizando sp_addlinkedserver, se agrega una autoasignación predeterminada para todos los inicios de sesión locales. En el caso de proveedores que no son SQL Server, los inicios de sesión autenticados de SQL Server pueden obtener acceso al proveedor con la cuenta de servicio SQL Server. Los administradores deben tener en cuenta el uso de sp_droplinkedsrvlogin <linkedserver_name>, NULL para quitar la asignación global.

Permisos

Requiere el permiso ALTER ANY LINKED SERVER.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

A. Usar el proveedor OLE DB de Microsoft SQL Native Client

En el siguiente ejemplo se crea un servidor vinculado llamado SEATTLESales. El nombre del producto es SQL Server y no se utiliza ningún nombre de proveedor.

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

En el siguiente ejemplo se crea un servidor vinculado S1_instance1 en una instancia de SQL Server mediante el uso del proveedor OLE DB de SQL Native Client (SQLNCLI).

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

B. Usar el proveedor Microsoft OLE DB para Jet

En el siguiente ejemplo se crea un servidor vinculado llamado SEATTLE Mktg.

[!NOTA] En este ejemplo se da por supuesto que se han instalado Microsoft Access y la base de datos de ejemplo Northwind, y que la base de datos Northwind reside en C:\Msoffice\Access\Samples.

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

C. Usar el proveedor Microsoft OLE DB para Oracle

En el siguiente ejemplo se crea un servidor vinculado llamado LONDON Mktg que utiliza el proveedor Microsoft OLE DB para Oracle y se da por supuesto que el alias SQL*Net para la base de datos Oracle es MyServer.

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

D. Usar el proveedor Microsoft OLE DB para ODBC con el parámetro data_source

En el siguiente ejemplo se crea un servidor vinculado llamado SEATTLE Payroll que utiliza el proveedor Microsoft OLE DB para ODBC (MSDASQL) y el parámetro data_source.

[!NOTA] El nombre del origen de datos ODBC especificado debe definirse como DSN del sistema en el servidor antes de utilizar el servidor vinculado.

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

E. Usar el proveedor Microsoft OLE DB para Jet en una hoja de cálculo Excel

Para crear una definición de servidor vinculado mediante el proveedor Microsoft OLE DB para Jet para obtener acceso a una hoja de cálculo Excel, primero debe crearse un intervalo con nombre en Excel que especifique las columnas y filas de la hoja de cálculo Excel que han de seleccionarse. Entonces, podrá hacerse referencia al nombre del intervalo como un nombre de tabla en una consulta distribuida.

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

Para obtener acceso a los datos de una hoja de cálculo Excel, asocie un nombre a un intervalo de celdas. La consulta siguiente se puede utilizar para obtener acceso al intervalo denominado SalesData especificado como una tabla utilizando el servidor vinculado que se creó anteriormente.

SELECT *
   FROM ExcelSource...SalesData
GO

Si SQL Server se ejecuta en una cuenta de dominio que tiene acceso a un recurso compartido remoto, se puede utilizar una ruta de acceso UNC en lugar de una unidad asignada.

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

F. Usar el proveedor Microsoft OLE DB para Jet para tener acceso a un archivo de texto

En este ejemplo se crea un servidor vinculado para obtener acceso directamente a archivos de texto, sin necesidad de vincular los archivos como tablas en un archivo .mdb de Access. El proveedor es Microsoft.Jet.OLEDB.4.0 y la cadena de proveedor es Text.

El origen de datos es la ruta de acceso completa del directorio que contiene los archivos de texto. En el mismo directorio que los archivos de texto, debe existir un archivo schema.ini, que describe la estructura de dichos archivos. Para obtener más información sobre cómo crear un archivo schema.ini, vea la documentación relativa al motor de bases de datos 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 four-part name. 
SELECT * 
FROM txtsrv...[file1#txt]

G. Usar el proveedor Microsoft OLE DB para DB2

En el siguiente ejemplo se crea un servidor vinculado llamado DB2 que utiliza el Microsoft OLE DB Provider for 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;'

Vea también

Referencia

Procedimientos almacenados de consultas distribuidas (Transact-SQL)
sp_addlinkedsrvlogin (Transact-SQL)
sp_addserver (Transact-SQL)
sp_dropserver (Transact-SQL)
sp_serveroption (Transact-SQL)
sp_setnetname (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)
Tablas del sistema (Transact-SQL)

Otros recursos

Configurar servidores vinculados para la delegación
Proveedores OLE DB probados con SQL Server

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión	Historial
12 de diciembre de 2006	Contenido nuevo: Se ha agregado una nota a la descripción de @provstr.