Konfiguration der PolyBase-Netzwerkkonnektivität (Transact-SQL)
Gilt für: SQL Server Azure SQL-Datenbank Azure Synapse Analytics Analytics Platform System (PDW)
Stellt globale Konfigurationseinstellungen für die PolyBase-Hadoop- und Microsoft Azure Blob Storage-Konnektivität dar oder ändert diese.
Transact-SQL-Syntaxkonventionen
Syntax
--List all of the configuration options
sp_configure
[;]
--Configure Hadoop connectivity
sp_configure [ @configname = ] 'hadoop connectivity',
[ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 }
[;]
RECONFIGURE
[;]
Argumente
[ @configname= ] 'option_name'
Der Name einer Konfigurationsoption. option_name ist vom Datentyp varchar(35) . Der Standardwert ist NULL
. Erfolgt keine Angabe, wird die gesamte Liste der Optionen zurückgegeben.
[ @configvalue= ] 'Wert'
Die neue Konfigurationseinstellung. value ist vom Datentyp int. Der Standardwert ist NULL
. Der Maximalwert kann je nach Option unterschiedlich sein.
'hadoop connectivity'
Gibt den Typ der Hadoop-Datenquelle für alle Verbindungen von PolyBase mit Hadoop-Clustern oder Azure Blob Storage an. Weitere Informationen finden Sie unter CREATE EXTERNAL DATA SOURCE (Transact-SQL).
Dies sind die Hadoop-Konnektivitätseinstellungen und die entsprechenden unterstützten Hadoop-Datenquellen. Es kann immer nur eine Einstellung zu einer Zeit wirksam sein.
Die Optionen 1, 4, 7 und 8 ermöglichen das Erstellen mehrerer externer Datenquellen und das Verwenden dieser in allen Sitzungen auf dem Server.
Option 0: Hadoop-Konnektivität deaktivieren
Option 1: Hortonworks HDP 1.3 unter Windows Server
Option 1: Azure Blob Storage (WASB[S])
Option 2: Hortonworks HDP 1.3 unter Linux
Option 3: Cloudera CDH 4.3 unter Linux
Option 4: Hortonworks HDP 2.0 unter Windows Server
Option 4: Azure Blob Storage (WASB[S])
Option 5: Hortonworks HDP 2.0 unter Linux
Option 6: Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12 und 5.13 unter Linux
Option 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 unter Linux
Option 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4 unter Windows Server
Option 7: Azure Blob Storage (WASB[S])
Option 8:* Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Azure Blob Storage (WASB[S]) und Azure Data Lake Storage Gen2 (ABFS[S])
* Option 8 wurde mit SQL Server 2019 CU11 eingeführt.
Standardmäßig ist die Hadoop-Konnektivität auf 0 festgelegt (deaktiviert). Den PolyBase Hadoop-Konnektivitätswert sollten Sie nach der Installation konfigurieren und anschließend PolyBase aktivieren. Weitere Informationen finden Sie unter Installieren von PolyBase unter Windows und Konfigurieren von PolyBase für den Zugriff auf externe Daten in Hadoop.
RECONFIGURE
Aktualisiert den Ausführungswert (run_value
), sodass er mit dem Konfigurationswert (config_value
) übereinstimmt. Definitionen zu run_value
und config_value
finden Sie unter Resultsets. Der neue Konfigurationswert, der von sp_configure
festgelegt wird, wird erst dann wirksam, wenn der Ausführungswert durch die RECONFIGURE
-Anweisung festgelegt wird. Nach der Ausführung von RECONFIGURE
müssen Sie den SQL Server-Dienst beenden und neu starten.
Wichtig
Beim Beenden des SQL Server-Diensts werden die beiden zusätzlichen Dienste (PolyBase Engine und Datenverschiebungsdienst) automatisch beendet. Starten Sie diese beiden Dienste nach dem Neustart des SQL Server-Engine-Diensts manuell, da sie nicht automatisch gestartet werden.
Rückgabecodewerte
„0“ (erfolgreich) oder „1“ (fehlerhaft)
Resultsets
Bei der Ausführung ohne Parameter gibt sp_configure
ein Resultset mit fünf Spalten zurück.
Spaltenname | Datentyp | BESCHREIBUNG |
---|---|---|
name | nvarchar(35) | Der Name der Konfigurationsoption. |
minimum | int | Der Mindestwert der Konfigurationsoption. |
maximum | int | Der Höchstwert der Konfigurationsoption. |
config_value | int | Mithilfe von sp_configurefestgelegter Wert. |
run_value | int | Von PolyBase aktuell verwendeter Wert. Dieser Wert wird durch Ausführen von RECONFIGURE festgelegt. config_value und run_value sind in der Regel gleich, sofern der Wert nicht gerade geändert wird. Bevor dieser Ausführungswert richtig ist, ist möglicherweise ein Neustart erforderlich, falls gerade eine Neukonfiguration ausgeführt wird. |
Allgemeine Hinweise
In SQL Server müssen Sie nach der Ausführung von RECONFIGURE
SQL Server neu starten, damit der Ausführungswert von „hadoop connectivity“ wirksam wird.
In Analytics-Plattformsystem (PDW) müssen Sie nach der Ausführung von RECONFIGURE
die Region Analytics-Plattformsystem (PDW) neu starten, damit der Ausführungswert von „hadoop connectivity“ wirksam wird.
Ab SQL Server 2022 (16.x) wird Hadoop in PolyBase nicht mehr unterstützt.
Einschränkungen
RECONFIGURE ist in einer expliziten oder impliziten Transaktion nicht zulässig.
Berechtigungen
Alle Benutzer können sp_configure
ohne Parameter oder mit dem Parameter @configname ausführen.
Erfordert die ALTER SETTINGS
-Berechtigung auf Serverebene oder die Mitgliedschaft in der festen sysadmin-Serverrolle, um einen Konfigurationswert zu ändern oder RECONFIGURE
auszuführen.
Beispiele
A. Auflisten aller verfügbaren Konfigurationseinstellungen
Im folgenden Beispiel wird dargestellt, wie alle Konfigurationsoptionen aufgelistet werden.
EXEC sp_configure;
Das Ergebnis gibt den Optionsnamen zurück, gefolgt von den minimalen und maximalen Werten für die Option. config_value ist der Wert, den PolyBase verwendet, wenn die Neukonfiguration abgeschlossen ist. run_value ist der Wert, der gerade verwendet wird. config_value und run_value sind in der Regel gleich, sofern der Wert nicht gerade geändert wird.
B. Auflisten der Konfigurationseinstellungen für einen Konfigurationsnamen
EXEC sp_configure @configname='hadoop connectivity';
C. Festlegen der Hadoop-Konnektivität
In diesem Beispiel wird PolyBase auf die Option 7 festgelegt. Diese Option ermöglicht es PolyBase, externe Tabellen unter Hortonworks HDP 2.1, 2.2, und 2.3 unter Linux und Windows Server und unter Azure Blob Storage zu erstellen und zu verwenden. Beispielsweise könnte SQL über 30 externe Tabellen verfügen, wobei 7 davon auf Daten in Hortonworks HDP 2.1 unter Linux, 4 auf Daten in Hortonworks HDP 2.2 unter Linux, 7 auf Daten in Hortonworks HDP 2.3 unter Linux und die restlichen 12 auf Daten in Azure Blob Storage verweisen würden.
--Configure external tables to reference data on Hortonworks HDP 2.1, 2.2, and 2.3 on Linux, and Azure Blob Storage
sp_configure @configname = 'hadoop connectivity', @configvalue = 7;
GO
RECONFIGURE
GO