Configurazione della connettività di PolyBase (Transact-SQL)

Articolo
05/03/2023

Si applica a: SQL Server Database SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

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

Convenzioni di sintassi Transact-SQL

Sintassi

  
--List all of the configuration options  
sp_configure  
[;]  
  
--Configure Hadoop connectivity  
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.

'hadoop connectivity'
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 (Transact-SQL).

Queste sono le impostazioni di connettività di Hadoop e le origini dati Hadoop supportate corrispondenti. 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 introdotta con SQL Server 2019 CU11.

Per impostazione predefinita, l'opzione hadoop connectivity è 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 diventa effettivo solo dopo l'impostazione del valore di esecuzione con l'istruzione RECONFIGURE. Dopo l'esecuzione di RECONFIGURE è necessario arrestare e riavviare il servizio SQL Server.

Importante

Si noti che con l'arresto del servizio SQL Server verranno arrestati automaticamente anche i due servizi aggiuntivi Motore PolyBase e Polybase Data Movement Service. Dopo il riavvio del servizio del motore di SQL Server, avviare manualmente questi due servizi, perché non vengono riavviati automaticamente.

Valori del codice restituito

0 (operazione completata) o 1 (operazione non riuscita)

Set di risultati

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

Nome colonna	Tipo di dati	Descrizione
name	nvarchar(35)	Nome dell'opzione di configurazione.
minimum	int	Valore minimo dell'opzione di configurazione.
maximum	int	Valore massimo dell'opzione di configurazione.
config_value	int	Valore impostato con sp_configure.
run_value	int	Valore corrente usato da PolyBase. Questo valore viene impostato tramite l'esecuzione di RECONFIGURE. The config_value e run_value sono in genere uguali, a meno che il valore non sia in corso di modifica. Se la riconfigurazione è in corso, potrebbe essere necessario un riavvio per ottenere un valore di esecuzione accurato.

Osservazioni generali

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).

A partire da SQL Server 2022 (16.x), Hadoop non è più supportato in PolyBase.

Limitazioni e restrizioni

L'istruzione RECONFIGURE non è consentita in una transazione esplicita o implicita.

Autorizzazioni

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

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.

EXEC sp_configure;

Il risultato restituisce il nome dell'opzione seguito dai valori minimi e massimo per l'opzione. config_value è il valore che verrà usato da PolyBase dopo il completamento della riconfigurazione. config_value è il valore in uso. The config_value e 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

EXEC 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. SQL potrebbe includere, ad esempio, 30 tabelle esterne di cui 7 fanno riferimento a dati in Hortonworks HDP 2.1 su Linux, 4 in Hortonworks HDP 2.2 su Linux, 7 in Hortonworks HDP 2.3 su Linux e le altre 12 ad Archiviazione BLOB di Azure.

--Configure external tables to reference data on Hortonworks HDP 2.1, 2.2, and 2.3 on Linux, and Azure Blob Storage  
  
sp_configure @configname = 'hadoop connectivity', @configvalue = 7;  
GO  
  
RECONFIGURE  
GO