sp_addlinkedserver (Transact-SQL)

Sintaxe

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

Argumentos

• [ @server= ] 'server'
  É o nome do servidor vinculado a ser criado. O server é sysname, sem padrão.

• [ @srvproduct= ] 'product_name'
  É o nome do produto da fonte de dados OLE DB para adicionar como um servidor vinculado. O product_name é nvarchar(128), com padrão de NULL. Se o SQL Server, provider_name, data_source, location, provider_string e catalog não tiverem que ser especificados.

• [ @provider= ] 'provider_name'
  É o identificador programático exclusivo (PROGID) do provedor OLE DB que corresponde a essa fonte de dados. O provider_name deve ser exclusive para o provedor OLE DB específico instalado no computador atual. O provider_name é nvarchar(128), com um padrão de NULL; entretanto, se o provider_name for omitido, o SQLNCLI será usado. (Usar SQLNCLI e SQL Server redirecionará para a versão mais recente do Provedor OLE DB do SQL Server Native Client.) Espera-se que o provedor OLE DB esteja registrado com o PROGID especificado no Registro.

• [ @datasrc= ] 'data_source'
  É o nome da fonte de dados como interpretado pelo provedor OLE DB. data_source é nvarchar(4000). O data_source é passado como a propriedade DBPROP_INIT_DATASOURCE para iniciar o provedor OLE DB.

• [ @location= ] 'location'
  É o local do banco de dados como interpretado pelo provedor OLE DB. location é nvarchar(4000), com um padrão NULL. O location é passado como a propriedade DBPROP_INIT_LOCATION para iniciar o provedor OLE DB.

• [ @provstr= ] 'provider_string'
  É a cadeia de conexão específica do provedor OLE DB que identifica uma fonte de dados exclusiva. provider_string é nvarchar(4000), com um valor padrão NULL. O provstr é passado para IDataInitialize ou definido como a propriedade DBPROP_INIT_PROVIDERSTRING para inicializar o provedor OLE DB.

  Quando o servidor vinculado for criado em relação ao provedor OLE DB do SQL Server Native Client, a instância pode ser especificada usando a palavra-chave SERVER como SERVER=servername\instancename para especificar uma instância específica do SQL Server. O servername é o nome do computador no qual o SQL Server está sendo executado, e o instancename é o nome da instância específica do SQL Server a qual o usuário será conectado.

  Observação

  Para acessar um banco de dados espelho, uma cadeia de conexão deve conter o nome do banco de dados. Esse nome é necessário para habilitar tentativas de failover pelo provedor de acesso de dados. O banco de dados pode ser especificado no @provstr ou parâmetro de @catalog. Opcionalmente, a cadeia de conexão também pode fornecer um nome de parceiro de failover. Para obter mais informações, consulte Fazendo a conexão inicial com uma sessão de espelhamento de banco de dados.

• [ @catalog= ] 'catalog'
  É o catálogo a ser usado quando uma conexão é feita com o provedor OLE DB. catalog é sysname, com um valor padrão NULL. O catalog é passado como a propriedade DBPROP_INIT_CATALOG para inicializar o provedor OLE DB. Quando o servidor vinculado for definido em relação a uma instância do SQL Server, o catálogo se referirá ao banco de dados padrão ao qual o servidor vinculado estará mapeado.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum.

Comentários

A tabela a seguir mostra as formas que um servidor vinculado pode ser definido para que as fontes de dados possam ser acessadas através do OLE DB. Um servidor vinculado pode ser definido em mais de uma forma para uma fonte de dados em particular; pode haver mais de uma linha para um tipo de fonte de dados. Essa tabela também mostra os valores de parâmetro de sp_addlinkedserver a serem usados para configurar o servidor vinculado.

1 Esta forma de definir um servidor vinculado impõe o nome do servidor vinculado para que seja o mesmo nome da rede na instância remota do SQL Server. Use data_source para especificar o servidor.

2 "Qualquer" indica que o nome de produto pode ser qualquer coisa.

O provedor OLE DB do Microsoft SQL Server Native Client será o provedor usado com o SQL Server se nenhum nome de provedor for especificado ou se o SQL Server for especificado como o nome de produto. Mesmo se você especificar o nome do provedor anterior, SQLOLEDB, será alterado para SQLNCLI quando for persistente para o catálogo.

Os parâmetros data_source, location, provider_string e catalog identificam o banco de dados ou bancos de dados para os quais o servidor vinculado aponta. Se qualquer um destes parâmetros for NULL, a propriedade de inicialização OLE DB correspondente não será definida.

Em um ambiente clusterizado, quando você especificar os nomes de arquivo para apontarem para fontes de dados OLE DB, use o nome UNC (Convenção Universal de nomenclatura) ou um drive compartilhado para especificar o local.

O sp_addlinkedserver não pode ser executado dentro de uma transação definida pelo usuário.

Observação sobre segurança
Quando um servidor vinculado é criado usando sp_addlinkedserver, um automapeamento padrão é adicionado para todos os logons locais. Para provedores não SQL Server, os logos autenticados SQL Server podem conseguir acesso ao provedor sob a conta de serviço SQL Server. Os administradores deveriam considerar o uso de sp_droplinkedsrvlogin <linkedserver_name>, NULL para remover o mapeamento global.

Permissões

Requer permissão ALTER ANY LINKED SERVER.

Exemplos

A. Usando o provedor Microsoft SQL Server Native Client OLE DB

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

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

B. Usando o Microsoft OLE DB Provider para Microsoft Access

O provedor Microsoft.Jet.OLEDB.4.0 se conecta a bancos de dados Microsoft Access que usam o formato 2002-2003. O exemplo abaixo cria um servidor vinculado chamado SEATTLE Mktg.

Observação
Esse exemplo presume que o Microsoft Access e o banco de dados de exemplo Northwind estão instalados e que o banco de dados Northwind reside em C:\Msoffice\Access\Samples.

EXEC sp_addlinkedserver 
   @server = N'SEATTLE Mktg', 
   @provider = N'Microsoft.Jet.OLEDB.4.0', 
   @srvproduct = N'OLE DB Provider for Jet',
   @datasrc = N'C:\MSOffice\Access\Samples\Northwind.mdb';
GO

O provedor Microsoft.ACE.OLEDB.12.0 se conecta a bancos de dados Microsoft Access que usam o formato 2007. O exemplo abaixo cria um servidor vinculado chamado SEATTLE Mktg.

Observação
Esse exemplo presume que o Microsoft Access e o banco de dados de exemplo Northwind estão instalados e que o banco de dados Northwind reside em C:\Msoffice\Access\Samples.

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

C. Usando o Microsoft OLE DB Provider para ODBC com o parâmetro data_source

O exemplo a seguir cria um servidor vinculado nomeado SEATTLE Payroll que usa o Microsoft OLE DB Provider para ODBC (MSDASQL) e o parâmetro data_source.

Observação
O nome da fonte de dados ODBC especificado deve ser definido como DSN do sistema antes de você usar o servidor vinculado.

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

D. Usando o Microsoft OLE DB Provider para planilha do Excel

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=N'EXCEL 12.0' ;

E. Usando o Microsoft OLE DB Provider para Jet para acessar um arquivo de texto

--Create a linked server.
EXEC sp_addlinkedserver txtsrv, N'Jet 4.0', 
   N'Microsoft.Jet.OLEDB.4.0',
   N'c:\data\distqry',
   NULL,
   N'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];

F. Usando o Microsoft OLE DB Provider para DB2

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

Consulte também

Referência

Conceitos