Dela via


PolyBase-anslutningskonfiguration (Transact-SQL)

Gäller för: SQL Server stöds inte. Azure SQL Database stöds inte. Azure Synapse Analytics Platform System (PDW)

Visar eller ändrar globala konfigurationsinställningar för PolyBase Hadoop- och Microsoft Azure Blob Storage-anslutning.

Transact-SQL syntaxkonventioner

Syntax

Visa en lista över alla konfigurationsalternativ.

sp_configure
[ ; ]

Konfigurera Hadoop-anslutning.

sp_configure [ @configname = ] 'hadoop connectivity' ,
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 }
[ ; ]

RECONFIGURE
[ ; ]

Arguments

[ @configname = ] "option_name"

Namnet på ett konfigurationsalternativ. option_name är varchar(35), med standardvärdet NULL. Om det inte anges returneras den fullständiga listan med alternativ.

[ @configvalue = ] "värde"

Den nya konfigurationsinställningen. värdet är int, med standardvärdet NULL. Det maximala värdet beror på det enskilda alternativet.

"hadoop-anslutning"

Anger typen av Hadoop-datakälla för alla anslutningar från PolyBase till Hadoop-kluster eller Azure Blob Storage. Mer information finns i CREATE EXTERNAL DATA SOURCE.

Följande lista innehåller Hadoop-anslutningsinställningarna och deras motsvarande Hadoop-datakällor som stöds. Endast en inställning kan gälla i taget.

Med alternativ 1, 4, 7 och 8 kan flera typer av externa datakällor skapas och användas i alla sessioner på servern.

  • Alternativ 0: Inaktivera Hadoop-anslutning

  • Alternativ 1: Hortonworks HDP 1.3 på Windows Server

  • Alternativ 1: Azure Blob Storage (WASB[S])

  • Alternativ 2: Hortonworks HDP 1.3 på Linux

  • Alternativ 3: Cloudera CDH 4.3 på Linux

  • Alternativ 4: Hortonworks HDP 2.0 på Windows Server

  • Alternativ 4: Azure Blob Storage (WASB[S])

  • Alternativ 5: Hortonworks HDP 2.0 på Linux

  • Alternativ 6: Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12 och 5.13 på Linux

  • Alternativ 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 på Linux

  • Alternativ 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4 på Windows Server

  • Alternativ 7: Azure Blob Storage (WASB[S])

  • Alternativ 8: 1 Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Azure Blob Storage (WASB[S]) och Azure Data Lake Storage Gen2 (ABFS[S])

1 Alternativ 8 introducerades med SQL Server 2019 (15.x) CU 11.

Som standard är Hadoop-anslutningen inställd på 0 (inaktiverad). Du bör konfigurera polybase hadoop-anslutningsvärdet efter installationen och sedan aktivera PolyBase. Mer information finns i Installera PolyBase i Windows och Konfigurera PolyBase för åtkomst till externa data i Hadoop.

RECONFIGURE

Uppdaterar körningsvärdet (run_value) så att det matchar konfigurationsvärdet (config_value). Se Resultatuppsättningar för definitioner av run_value och config_value. Det nya konfigurationsvärdet som anges av sp_configure börjar inte gälla förrän körningsvärdet har angetts av -instruktionen RECONFIGURE . När du har kört RECONFIGUREmåste du sedan stoppa och starta om SQL Server-tjänsten.

Viktigt!

När du stoppar SQL Server-tjänsten stoppas även de två ytterligare tjänsterna automatiskt: PolyBase Engine och Data Movement Service. När du har startat om SQL Server-motortjänsten startar du dessa två tjänster manuellt igen eftersom de inte startas automatiskt.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

När den körs utan parametrar sp_configure returnerar en resultatuppsättning med fem kolumner.

Kolumnnamn Datatyp Description
name nvarchar(35) Namn på konfigurationsalternativet.
minimum int Minsta värde för konfigurationsalternativet.
maximum int Maximalt värde för konfigurationsalternativet.
config_value int Värde som angavs med hjälp av sp_configure.
run_value int Aktuellt värde som används av PolyBase. Det här värdet anges genom att köra RECONFIGURE.

Och config_valuerun_value är vanligtvis samma om inte värdet håller på att ändras.
En omstart kan krävas innan körningsvärdet är korrekt om omkonfigurationen pågår.

Anmärkningar

När du har kört RECONFIGURESQL Server måste du starta om SQL Server för att körningsvärdet för hadoop-anslutningen ska börja gälla.

När du har kört RECONFIGUREAnalytics Platform System (PDW) måste du starta om pdw-regionen (Analytics Platform System) för att körningsvärdet för hadoop-anslutningen ska börja gälla.

Hadoop stöds inte längre i PolyBase i SQL Server 2022 (16.x) och senare versioner.

Begränsningar

RECONFIGURE tillåts inte i en explicit eller implicit transaktion.

Permissions

Alla användare kan köra sp_configure utan parametrar eller parametern @configname .

Kräver ALTER SETTINGS behörighet på servernivå eller medlemskap i den fasta serverrollen sysadmin för att ändra ett konfigurationsvärde eller köra RECONFIGURE.

Examples

A. Visa en lista över alla tillgängliga konfigurationsinställningar

I följande exempel visas hur du listar alla konfigurationsalternativ.

EXECUTE sp_configure;

Resultatet returnerar alternativnamnet följt av lägsta och högsta värden för alternativet. config_value är det värde som PolyBase använder när omkonfigurationen är klar. run_value är det värde som används för närvarande. Och config_valuerun_value är vanligtvis samma om inte värdet håller på att ändras.

B. Ange konfigurationsinställningarna för ett konfigurationsnamn

EXECUTE sp_configure @configname = 'hadoop connectivity';

C. Ange Hadoop-anslutning

I det här exemplet anges PolyBase till alternativ 7. Med det här alternativet kan PolyBase skapa och använda externa tabeller i Hortonworks HDP 2.1, 2.2 och 2.3 på Linux och Windows Server samt Azure Blob Storage. SQL Server kan till exempel ha 30 externa tabeller, där 7 av dem refererar till data i Hortonworks HDP 2.1 på Linux, 4 på Hortonworks HDP 2.2 i Linux, 7 på Hortonworks HDP 2.3 i Linux och de andra 12 som refererar till Azure Blob Storage.

Den här koden konfigurerar externa tabeller för att referera till data i Hortonworks HDP 2.1, 2.2 och 2.3 i Linux och Azure Blob Storage.

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

RECONFIGURE;
GO