PolyBase-connectiviteitsconfiguratie (Transact-SQL)

Van toepassing op: SQL Server Azure SQL Database Azure Synapse Analytics Platform System (PDW)

Hiermee worden algemene configuratie-instellingen voor PolyBase Hadoop- en Microsoft Azure Blob Storage-connectiviteit weergegeven of gewijzigd.

Transact-SQL syntaxis-conventies

Syntaxis

Geef alle configuratieopties weer.

sp_configure
[ ; ]

Hadoop-connectiviteit configureren.

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

RECONFIGURE
[ ; ]

Arguments

[ @configname = ] 'option_name'

De naam van een configuratieoptie. option_name is varchar(35), met een standaardwaarde van NULL. Als dit niet is opgegeven, wordt de volledige lijst met opties geretourneerd.

[ @configvalue = ] 'waarde'

De nieuwe configuratie-instelling. de waarde is int, met een standaardwaarde van NULL. De maximumwaarde is afhankelijk van de afzonderlijke optie.

'hadoop-connectiviteit'

Hiermee geeft u het type Hadoop-gegevensbron op voor alle verbindingen van PolyBase naar Hadoop-clusters of Azure Blob Storage. Zie CREATE EXTERNAL DATA SOURCEvoor meer informatie.

De volgende lijst bevat de Hadoop-connectiviteitsinstellingen en de bijbehorende ondersteunde Hadoop-gegevensbronnen. Er kan slechts één instelling tegelijk worden ingesteld.

Met opties 1, 4, 7 en 8 kunnen meerdere typen externe gegevensbronnen worden gemaakt en gebruikt voor alle sessies op de server.

• Optie 0: Hadoop-connectiviteit uitschakelen

• Optie 1: Hortonworks HDP 1.3 op Windows Server

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

• Optie 2: Hortonworks HDP 1.3 op Linux

• Optie 3: Cloudera CDH 4.3 op Linux

• Optie 4: Hortonworks HDP 2.0 op Windows Server

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

• Optie 5: Hortonworks HDP 2.0 op Linux

• Optie 6: Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12 en 5.13 op Linux

• Optie 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 op Linux

• Optie 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4 op Windows Server

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

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

¹ Optie 8 is geïntroduceerd met SQL Server 2019 (15.x) CU 11.

Standaard is de Hadoop-connectiviteit ingesteld op 0 (uitgeschakeld). U moet de verbindingswaarde van PolyBase hadoop configureren nadat u PolyBase hebt geïnstalleerd en vervolgens PolyBase hebt ingeschakeld. Zie PolyBase installeren in Windows en PolyBase configureren voor toegang tot externe gegevens in Hadoop voor meer informatie.

RECONFIGURE

Hiermee wordt de uitvoeringswaarde (run_value) bijgewerkt zodat deze overeenkomt met de configuratiewaarde (config_value). Bekijk resultatensets voor definities van run_value en config_value. De nieuwe configuratiewaarde die door sp_configure is ingesteld, wordt pas van kracht nadat de uitvoeringswaarde door de RECONFIGURE instructie is ingesteld. Vervolgens moet u na het uitvoeren RECONFIGUREde SQL Server-service stoppen en opnieuw starten.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

Wanneer deze wordt uitgevoerd zonder parameters, sp_configure wordt een resultatenset met vijf kolommen geretourneerd.

Opmerkingen

Nadat SQL Server is uitgevoerd RECONFIGURE, moet u SQL Server opnieuw opstarten om de uitvoeringswaarde van de hadoop-connectiviteit van kracht te laten worden.

In Analytics Platform System (PDW), nadat deze is uitgevoerd RECONFIGURE, moet u de regio Analytics Platform System (PDW) opnieuw starten om de uitvoeringswaarde van de hadoop-connectiviteit van kracht te laten worden.

In SQL Server 2022 (16.x) en latere versies wordt Hadoop niet meer ondersteund in PolyBase.

Beperkingen

RECONFIGURE is niet toegestaan in een expliciete of impliciete transactie.

Permissions

Alle gebruikers kunnen zonder parameters of de parameter @configname uitvoerensp_configure.

Vereist ALTER SETTINGS machtiging op serverniveau of lidmaatschap van de vaste serverfunctie sysadmin om een configuratiewaarde te wijzigen of uit te voeren RECONFIGURE.

Voorbeelden

Eén. Alle beschikbare configuratie-instellingen weergeven

In het volgende voorbeeld ziet u hoe u alle configuratieopties weergeeft.

EXECUTE sp_configure;

Het resultaat retourneert de naam van de optie, gevolgd door de minimum- en maximumwaarden voor de optie. Dit config_value is de waarde die PolyBase gebruikt wanneer de configuratie is voltooid. Dit run_value is de waarde die momenteel wordt gebruikt. De config_value en run_value zijn meestal hetzelfde, tenzij de waarde wordt gewijzigd.

B. De configuratie-instellingen voor één configuratienaam weergeven

EXECUTE sp_configure @configname = 'hadoop connectivity';

C. Hadoop-connectiviteit instellen

In dit voorbeeld wordt PolyBase ingesteld op optie 7. Met deze optie kan PolyBase externe tabellen maken en gebruiken op Hortonworks HDP 2.1, 2.2 en 2.3 op Linux en Windows Server en Azure Blob Storage. SQL Server kan bijvoorbeeld 30 externe tabellen hebben, waarbij 7 ervan verwijst naar gegevens op Hortonworks HDP 2.1 op Linux, 4 op Hortonworks HDP 2.2 op Linux, 7 op Hortonworks HDP 2.3 op Linux en de andere 12 die naar Azure Blob Storage verwijzen.

Met deze code worden externe tabellen geconfigureerd om te verwijzen naar gegevens op Hortonworks HDP 2.1, 2.2 en 2.3 op Linux en Azure Blob Storage.

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

RECONFIGURE;
GO

Verwante inhoud

• Gegevensvirtualisatie met PolyBase in SQL Server
• sp_configure (Transact-SQL)
• CREËER EXTERNE TABEL (Transact-SQL)
• CREATE EXTERNAL FILE FORMAT (Transact-SQL)
• CREATE EXTERNAL DATA SOURCE (Transact-SQL)