Configurazione della connettività PolyBase (Transact-SQL)

Si applica a: SQL Server Database SQL di Azure Azure Synapse Analytics Analytics Platform System (PDW)

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

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.

Nella piattaforma di strumenti analitici (PDW) dopo aver eseguito RECONFIGURE, per rendere effettivo il valore di esecuzione di 'hadoop connectivity', è necessario riavviare l'area della piattaforma di strumenti analitici (PDW).

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_value run_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

• Virtualizzazione dei dati con 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)