Konfiguration der PolyBase-Netzwerkkonnektivität (Transact-SQL)

  • Artikel

Gilt für: SQL Server Not supported. Azure SQL-Datenbank Not supported. 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

Nächste Schritte