PolyBase-Konnektivitätskonfiguration (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

Listet alle Konfigurationsoptionen auf.

sp_configure
[ ; ]

Konfigurieren der Hadoop-Konnektivität.

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 = ] 'value'

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 (CREATE EXTERNAL DATA SOURCE).

Die folgende Liste enthält 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 (15.x) CU 11 eingeführt.

Standardmäßig ist die Hadoop-Konnektivität auf 0 (deaktiviert) festgelegt. 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 von ihnen festgelegte sp_configure neue Konfigurationswert wird erst wirksam, wenn der Ausführungswert von der RECONFIGURE Anweisung festgelegt wird. Nach der Ausführung von RECONFIGURE müssen Sie den SQL Server-Dienst beenden und neu starten.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Bei der Ausführung ohne Parameter gibt sp_configure ein Resultset mit fünf Spalten zurück.

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.

In SQL Server 2022 (16.x) und höheren Versionen wird Hadoop in PolyBase nicht mehr unterstützt.

Begrenzungen

RECONFIGURE ist in einer expliziten oder impliziten Transaktion nicht zulässig.

Berechtigungen

Alle Benutzer können ohne Parameter oder den parameter @configname ausgeführt werdensp_configure.

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.

EXECUTE sp_configure;

Das Ergebnis gibt den Optionsnamen zurück, gefolgt von den minimalen und maximalen Werten für die Option. Der config_value Wert, den PolyBase verwendet, wenn die Neukonfiguration abgeschlossen ist. Dies run_value ist der Wert, der derzeit verwendet wird. Die config_value und run_value sind in der Regel identisch, es sei denn, der Wert befindet sich im Prozess der Änderung.

B. Auflisten der Konfigurationseinstellungen für einen Konfigurationsnamen

EXECUTE 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 Server 30 externe Tabellen haben, mit 7 von ihnen verweisen auf Daten zu Hortonworks HDP 2.1 unter Linux, 4 auf Hortonworks HDP 2.2 unter Linux, 7 auf Hortonworks HDP 2.3 unter Linux und die anderen 12 verweisen auf Azure Blob Storage.

Dieser Code konfiguriert externe Tabellen, um auf Daten in Hortonworks HDP 2.1, 2.2 und 2.3 unter Linux und Azure Blob Storage zu verweisen.

EXECUTE sp_configure
    @configname = 'hadoop connectivity',
    @configvalue = 7;
GO

RECONFIGURE;
GO

Zugehöriger Inhalt

• Datenvirtualisierung mit PolyBase in SQL Server
• sp_configure (Transact-SQL)
• CREATE EXTERNAL TABLE (Transact-SQL)
• CREATE EXTERNAL FILE FORMAT (Transact-SQL)
• CREATE EXTERNAL DATA SOURCE (Transact-SQL)