sp_addlinkedserver (Transact-SQL)

Syntaxe

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

Arguments

• [ @server= ] 'server'
  Nom du serveur lié à créer. L'argument server est de type sysname, sans valeur par défaut.

• [ @srvproduct= ] 'product_name'
  Nom de produit de la source de données OLE DB à ajouter comme serveur lié. product_name est de type nvarchar(128). Sa valeur par défaut est NULL. Si le nom du produit est SQL Server, il n'est pas nécessaire de spécifier provider_name, data_source, location, provider_string et catalog.

• [ @provider= ] 'provider_name'
  ID de programme unique (PROGID) du fournisseur OLE DB correspondant à la source de données. provider_name doit être unique pour le fournisseur OLE DB spécifié installé sur l'ordinateur actuel. provider_name est de type nvarchar(128). Sa valeur par défaut est NULL ; cependant, si provider_name est omis, SQLNCLI est utilisé. (L'utilisation de SQLNCLI et SQL Server vous redirigera vers la version la plus récente du fournisseur SQL Server Native Client OLE DB.) Le fournisseur OLE DB doit être inscrit dans le Registre avec le PROGID spécifié.

• [ @datasrc= ] 'data_source'
  Nom de la source de données interprétée par le fournisseur OLE DB. data_source est de type nvarchar(4000). data_source est transmis comme propriété DBPROP_INIT_DATASOURCE pour initialiser le fournisseur OLE DB.

• [ @location= ] 'location'
  Emplacement de la base de données interprété par le fournisseur OLE DB. location est de type nvarchar(4000). Sa valeur par défaut est NULL. location est passé comme propriété DBPROP_INIT_LOCATION pour initialiser le fournisseur OLE DB.

• [ @provstr= ] 'provider_string'
  Chaîne de connexion spécifique au fournisseur OLE DB identifiant une source de données unique. provider_string est de type nvarchar(4000). Sa valeur par défaut est NULL. provstr est passé à IDataInitialize ou défini comme propriété DBPROP_INIT_PROVIDERSTRING pour initialiser le fournisseur OLE DB.

  Lorsque le serveur lié est créé sur le fournisseur SQL Server Native Client OLE DB, l'instance peut être spécifiée à l'aide du mot clé SERVER sous la forme SERVER=servername\instancename, afin de spécifier une instance de SQL Server spécifique. servername représente le nom de l'ordinateur sur lequel s'exécute SQL Server, tandis que instancename représente le nom de l'instance SQL Server spécifique à laquelle l'utilisateur doit être connecté.

  Notes

  Pour accéder à une base de données miroir, une chaîne de connexion doit contenir le nom de la base de données. Ce nom est nécessaire pour permettre au fournisseur d'accès aux données d'effectuer des tentatives de basculement. La base de données peut être spécifiée dans le paramètre @provstr ou @catalog. Le cas échéant, la chaîne de connexion peut également fournir un nom de partenaire de basculement. Pour plus d'informations, consultez Établissement de la connexion initiale à une session de mise en miroir de bases de données.

• [ @catalog= ] 'catalog'
  Catalogue à utiliser lors de l'établissement d'une connexion au fournisseur OLE DB. catalog est de type sysname Sa valeur par défaut est NULL. catalog est passé comme propriété DBPROP_INIT_CATALOG pour initialiser le fournisseur OLE DB. Lorsque le serveur lié est défini sur une instance de SQL Server, le catalogue fait référence à la base de données par défaut sur laquelle le serveur lié est mappé.

Valeurs du code de retour

0 (succès) ou 1 (échec)

Ensembles de résultats

Aucun.

Notes

Le tableau suivant présente les façons dont un serveur lié peut être configuré pour des sources de données accessibles via OLE DB. Un serveur lié peut être configuré au moyen de plusieurs méthodes pour une même source de données ; il peut y avoir plusieurs lignes pour un type de source de données. Le tableau ci-dessous indique également les valeurs des paramètres de sp_addlinkedserver à utiliser pour configurer le serveur lié.

1 Cette méthode de configuration impose que le nom du serveur lié soit identique au nom réseau de l'instance de SQL Server distante. Utilisez data_source pour spécifier le serveur.

2 « Indifférent » signifie que le nom du produit n'a pas d'importance.

Le fournisseur Microsoft SQL Server Native Client OLE DB est le fournisseur utilisé avec SQL Server si aucun nom de fournisseur n'est spécifié ou si SQL Server est spécifié comme nom de produit. Même si vous spécifiez l'ancien nom du fournisseur, SQLOLEDB, il est remplacé par SQLNCLI lorsqu'il est persistant pour le catalogue.

Les paramètres data_source, location, provider_string et catalog identifient la ou les bases de données vers lesquelles pointe le serveur. Si un de ces paramètres a la valeur NULL, la propriété d'initialisation OLE DB correspondante n'est pas définie.

Dans un environnement ordonné en clusters, lorsque vous spécifiez des noms de fichiers qui pointent vers des sources de données OLE DB, utilisez le nom UNC (Universal Naming Convention) ou un lecteur partagé pour spécifier l'emplacement.

La procédure sp_addlinkedserver ne peut pas être exécutée dans une transaction définie par l'utilisateur.

Remarque relative à la sécurité

Lorsqu'un serveur lié est créé à l'aide de sp_addlinkedserver, un mappage automatique par défaut est ajouté pour toutes les connexions locales. Pour les fournisseurs non-SQL Server, les connexions SQL Server authentifiées peuvent accéder au fournisseur sous le compte de service SQL Server. Les administrateurs doivent envisager d'utiliser sp_droplinkedsrvlogin <linkedserver_name>, NULL pour supprimer le mappage global.

Autorisations

Nécessite l'autorisation ALTER ANY LINKED SERVER.

Exemples

A. Utilisation du fournisseur 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. Utilisation du fournisseur Microsoft OLE DB pour Microsoft Access

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

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. Utilisation du fournisseur Microsoft OLE DB pour ODBC avec le paramètre data_source

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

D. Utilisation du fournisseur Microsoft OLE DB pour une feuille de calcul 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. Utilisation du fournisseur Microsoft OLE DB pour Jet pour accéder à un fichier texte

--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. Utilisation du fournisseur Microsoft OLE DB pour 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;';

Voir aussi

Référence

Concepts