Configurazione della connettività PolyBase (Transact-SQL)

si applica a:SQL Server

Visualizza o modifica le impostazioni di configurazione globali per la connettività tra Hadoop PolyBase e Archiviazione BLOB di Microsoft Azure.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

Elencare tutte le opzioni di configurazione.

sp_configure
[ ; ]

Configurare la connettività hadoop.

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

RECONFIGURE
[ ; ]

Argomenti

[ @configname = ] 'option_name'

Nome di un'opzione di configurazione. option_name è varchar(35) e il valore predefinito è NULL. Se non si specifica alcun nome di opzione, viene restituito l'elenco completo delle opzioni.

[ @configvalue = ] 'valore'

Nuova impostazione di configurazione. value è inte il valore predefinito è NULL. Il valore massimo dipende dalla singola opzione.

"connettività hadoop"

Specifica il tipo di origine dati Hadoop per tutte le connessioni da PolyBase a cluster Hadoop o Archiviazione BLOB di Azure. Per altre informazioni, vedere CREATE EXTERNAL DATA SOURCE.

L'elenco seguente contiene le impostazioni di connettività hadoop e le corrispondenti origini dati Hadoop supportate. Può essere attiva una sola impostazione alla volta.

Le opzioni 1, 4, 7 e 8 consentono la creazione e l'uso di più tipi di origini dati esterne in tutte le sessioni nel server.

• Opzione 0: disabilitazione della connettività Hadoop

• Opzione 1: Hortonworks HDP 1.3 su Windows Server

• Opzione 1: Archiviazione BLOB di Azure (WASB[S])

• Opzione 2: Hortonworks HDP 1.3 su Linux

• Opzione 3: Cloudera CDH 4.3 su Linux

• Opzione 4: Hortonworks HDP 2.0 su Windows Server

• Option 4: Archiviazione BLOB di Azure (WASB[S])

• Opzione 5: Hortonworks HDP 2.0 su Linux

• Opzione 6: Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12 e 5.13 su Linux

• Opzione 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 su Linux

• Opzione 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4 su Windows Server

• Opzione 7: Archiviazione BLOB di Azure (WASB[S])

• Opzione 8: ¹ Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Archiviazione BLOB di Azure (WASB[S]) e Azure Data Lake Storage Gen2 (ABFS[S])

¹ Opzione 8 è stata introdotta con SQL Server 2019 (15.x) CU 11.

Per impostazione predefinita, la connettività Hadoop è impostata su 0 (disabilitata). È necessario configurare il valore di connettività hadoop PolyBase dopo l'installazione e quindi abilitare PolyBase. Per altre informazioni, vedere Installare PolyBase in Windows e Configurare PolyBase per accedere ai dati esterni in Hadoop.

RECONFIGURE

Aggiorna il valore di esecuzione (run_value) in modo che corrisponda al valore di configurazione (config_value). Vedere Set di risultati per le definizioni di run_value e config_value. Il nuovo valore di configurazione impostato da sp_configure non diventa effettivo finché il valore di esecuzione non viene impostato dall'istruzione RECONFIGURE . Dopo l'esecuzione di RECONFIGURE è necessario arrestare e riavviare il servizio SQL Server.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Quando viene eseguito senza parametri, sp_configure restituisce un set di risultati con cinque colonne.

Osservazioni:

In SQL Server, dopo aver eseguito RECONFIGURE, per rendere effettivo il valore di esecuzione di 'hadoop connectivity', è necessario riavviare SQL Server.

In Azure Synapse Analytics, dopo aver eseguito RECONFIGURE, affinché il valore run della 'hadoop connectivity' entri in vigore, devi riavviare la regione di Azure Synapse Analytics.

In SQL Server 2022 (16.x) e versioni successive Hadoop non è più supportato in PolyBase.

Limiti

RECONFIGURE non è consentito in una transazione esplicita o implicita.

Autorizzazioni

Tutti gli utenti possono essere eseguiti sp_configure senza parametri o con il parametro @configname .

Per modificare un valore di configurazione o per eseguire ALTER SETTINGS, è necessaria l'autorizzazione a livello di server o l'appartenenza al ruolo predefinito del server sysadminRECONFIGURE.

Esempi

R. Elencare tutte le impostazioni di configurazione disponibili

L'esempio seguente mostra come impostare ed elencare tutte le opzioni di configurazione.

EXECUTE sp_configure;

Il risultato restituisce il nome dell'opzione seguito dai valori minimi e massimo per l'opzione. config_value è il valore usato da PolyBase al termine della riconfigurazione. run_value è il valore attualmente in uso. e config_valuerun_value sono in genere uguali, a meno che il valore non sia in corso di modifica.

B. Elencare le impostazioni di configurazione per un nome di configurazione

EXECUTE sp_configure @configname = 'hadoop connectivity';

C. Impostare la connettività Hadoop

Questo esempio imposta PolyBase sull'opzione 7. Questa opzione consente a PolyBase per creare e usare tabelle esterne su Hortonworks HDP 2.1, 2.2 e 2.3 su Linux e Windows Server e in Archiviazione BLOB di Azure. Ad esempio, SQL Server potrebbe avere 30 tabelle esterne, con 7 di essi che fanno riferimento ai dati in Hortonworks HDP 2.1 in Linux, 4 in Hortonworks HDP 2.2 in Linux, 7 in Hortonworks HDP 2.3 in Linux e gli altri 12 che fanno riferimento Archiviazione BLOB di Azure.

Questo codice configura le tabelle esterne per fare riferimento ai dati in Hortonworks HDP 2.1, 2.2 e 2.3 in Linux e Archiviazione BLOB di Azure.

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

RECONFIGURE;
GO

Contenuto correlato

• Panoramica di PolyBase
• sys.sp_configure (Transact-SQL)
• CREATE EXTERNAL TABLE (Transact-SQL)
• CREATE EXTERNAL FILE FORMAT (Transact-SQL)
• CREATE EXTERNAL DATA SOURCE (Transact-SQL)