OPENDATASOURCE (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

Fournit les informations de connexion appropriées pour un nom d'objet en quatre parties sans utiliser de nom de serveur lié.

Conventions de la syntaxe Transact-SQL

Syntaxe

OPENDATASOURCE ( 'provider_name', 'init_string' )  

Arguments

'provider_name'

Nom enregistré comme PROGID du fournisseur OLE DB utilisé pour accéder à la source de données. provider_name est du type de données char, sans valeur par défaut.

'init_string'

Chaîne de connexion transmise à l’interface IDataInitialize du fournisseur de destination. La syntaxe de la chaîne du fournisseur est basée sur des paires mot clé-valeur séparées par un point-virgule, par exemple : 'mot-clé1=valeur ; mot-clé2=valeur'.

Pour plus d'informations sur les paires mot clé-valeur prises en charge par le fournisseur, consultez le kit de développement logiciel (SDK) de Microsoft Data Access. Cette documentation définit la syntaxe de base. Le tableau suivant répertorie les mots clés utilisés fréquemment dans l’argument init_string.

Remarques

OPENROWSET hérite toujours du classement de l’instance, quel que soit le classement défini pour les colonnes.

OPENDATASOURCE peut être utilisé pour accéder à des données distantes à partir de sources de données OLE DB seulement si l’option de Registre DisallowAdhocAccess est explicitement définie sur 0 pour le fournisseur spécifié et que l’option de configuration avancée Ad Hoc Distributed Queries est activée. Lorsque ces options ne sont pas définies, le comportement par défaut n'autorise pas l'accès d'égal à égal.

La fonction OPENDATASOURCE peut être utilisée aux mêmes endroits de la syntaxe Transact-SQL qu’un nom de serveur lié. OPENDATASOURCE peut donc constituer la première des quatre parties d’un nom qui fait référence à un nom de table ou de vue (dans une instruction SELECT, INSERT, UPDATE ou DELETE) ou à une procédure stockée distante (dans une instruction EXECUTE). Lors de l’exécution de procédures stockées distantes, OPENDATASOURCE doit référencer une autre instance de SQL Server. OPENDATASOURCE n'accepte pas de variables pour ses arguments.

Comme la fonction OPENROWSET, OPENDATASOURCE doit référencer seulement des sources de données OLE DB qui ne sont pas sollicitées fréquemment. Définissez un serveur lié pour toutes les sources de données qui font l'objet de nombreux accès. Ni OPENDATASOURCE ni OPENROWSET n’offrent toutes les fonctionnalités des définitions de serveur lié, notamment la gestion de la sécurité et la possibilité de consulter des informations du catalogue. Toutes les informations de connexion, y compris les mots de passe, doivent être fournies à chaque appel de OPENDATASOURCE.

Les exigences de connexion pour chaque fournisseur sont semblables à celles de ces paramètres lors de la création de serveurs liés. Des informations relatives à de nombreux fournisseurs courants sont présentées dans l’article sp_addlinkedserver (Transact-SQL).

Tout appel à OPENDATASOURCE, OPENQUERY ou OPENROWSET dans la clause FROM est évalué séparément et indépendamment de tout appel à ces fonctions utilisé comme cible de la mise à jour, même si des arguments identiques sont fournis aux deux appels. En particulier, les conditions de filtre ou de jointure appliquées au résultat de l’un de ces appels n’ont aucun effet sur les résultats de l’autre.

Autorisations

Tous les utilisateurs peuvent exécuter OPENDATASOURCE. Les autorisations utilisées pour la connexion au serveur distant sont déterminées à partir de la chaîne de connexion.

Exemples

R. Utilisation d’OPENDATASOURCE avec SELECT et OLE DB Driver pour SQL Server

L’exemple suivant utilise le pilote Microsoft OLE DB Driver pour SQL Server pour accéder à la table HumanResources.Department dans la base de données AdventureWorks2022 sur le serveur distant Seattle1. Une instruction SELECT définit l’ensemble de lignes retourné. La chaîne de caractères du fournisseur contient les mots clés Server et Trusted_Connection. Ces mots clés sont reconnus par le pilote SQL Server OLE DB Driver.

SELECT GroupName, Name, DepartmentID  
FROM OPENDATASOURCE('MSOLEDBSQL', 'Server=Seattle1;Database=AdventureWorks2022;TrustServerCertificate=Yes;Trusted_Connection=Yes;').HumanResources.Department  
ORDER BY GroupName, Name;  

B. Utilisation d’OPENDATASOURCE avec SELECT et le fournisseur SQL Server OLE DB

L'exemple suivant crée une connexion appropriée à l'instance Payroll de SQL Server sur le serveur London, puis interroge la table AdventureWorks2022.HumanResources.Employee.

SELECT *  
FROM OPENDATASOURCE('SQLNCLI',  
    'Data Source=London\Payroll;Integrated Security=SSPI')  
    .AdventureWorks2022.HumanResources.Employee;  

C. Utilisation du fournisseur Microsoft OLE DB pour Jet

L’exemple suivant crée une connexion ad hoc avec une feuille de calcul Excel au format de document Word 1997 - 2003.

SELECT * FROM OPENDATASOURCE('Microsoft.Jet.OLEDB.4.0',  
    'Data Source=C:\DataFolder\Documents\TestExcel.xls;Extended Properties=EXCEL 5.0')...[Sheet1$] ;  

Étapes suivantes

• OPENROWSET (Transact-SQL)
• sp_addlinkedserver (Transact-SQL)