OPENQUERY (Transact-SQL)

Führt die angegebene Pass-Through-Abfrage auf dem angegebenen Verbindungsserver aus. Bei diesem Server handelt es sich um eine OLE DB-Datenquelle. Auf OPENQUERY kann in der FROM-Klausel einer Abfrage so verwiesen werden, als ob es ein Tabellenname wäre. Auf OPENQUERY kann auch als Zieltabelle einer INSERT-, UPDATE- oder DELETE-Anweisung verwiesen werden. Dies hängt von den Funktionen des OLE DB-Anbieters ab. Obwohl die Abfrage möglicherweise mehrere Resultsets zurückgibt, gibt OPENQUERY nur das erste zurück.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

OPENQUERY ( linked_server ,'query' )

Argumente

  • linked_server
    Ein Bezeichner, der den Namen des Verbindungsservers darstellt.

  • 'query'
    Ist die Zeichenfolge der Abfrage, die auf dem Verbindungsserver ausgeführt wird. Die maximale Länge der Zeichenfolge beträgt 8 KB.

Hinweise

Für die Argumente von OPENQUERY können keine Variablen verwendet werden.

Mit OPENQUERY können keine erweiterten gespeicherten Prozeduren für einen Verbindungsserver ausgeführt werden. Eine erweiterte gespeicherte Prozedur kann jedoch auf einem Verbindungsserver ausgeführt werden, wenn der vierteilige Name verwendet wird. Beispiel:

EXEC SeattleSales.master.dbo.xp_msver

Jeder Aufruf von OPENDATASOURCE, OPENQUERY oder OPENROWSET in der FROM-Klausel wird separat und unabhängig von Aufrufen dieser Funktionen ausgewertet, die als Ziel der Aktualisierung verwendet werden. Dies ist auch dann der Fall, wenn identische Argumente für die beiden Aufrufe angegeben werden. Insbesondere haben Filter- oder Verknüpfungsbedingungen, die auf das Ergebnis eines dieser Aufrufe angewendet werden, keinen Einfluss auf die Ergebnisse des anderen Aufrufs.

Berechtigungen

Jeder beliebige Benutzer kann OPENQUERY ausführen. Die Berechtigungen, die für die Verbindung mit dem Remoteserver verwendet werden, werden aus den Einstellungen für den Verbindungsserver abgerufen.

Beispiele

A. Ausführen einer UPDATE-Pass-Through-Abfrage

Im folgenden Beispiel wird eine UPDATE-Pass-Through-Abfrage für den in Beispiel A erstellten Verbindungsserver verwendet.

UPDATE OPENQUERY (OracleSvr, 'SELECT name FROM joe.titles WHERE id = 101') 
SET name = 'ADifferentName';

B. Ausführen einer INSERT-Pass-Through-Abfrage

Im folgenden Beispiel wird eine INSERT-Pass-Through-Abfrage für den in Beispiel A erstellten Verbindungsserver verwendet.

INSERT OPENQUERY (OracleSvr, 'SELECT name FROM joe.titles')
VALUES ('NewTitle');

C. Ausführen einer DELETE-Pass-Through-Abfrage

Im folgenden Beispiel wird eine DELETE-Pass-Through-Abfrage verwendet, um die in Beispiel C eingefügte Zeile zu löschen.

DELETE OPENQUERY (OracleSvr, 'SELECT name FROM joe.titles WHERE name = ''NewTitle''');