Condividi tramite


Configurazione della connettività PolyBase (Transact-SQL)

Si applica a: SQL Server Non supportato. Database SQL di Azure Non supportato. 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: 1 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])

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

Importante

Quando si arresta il servizio SQL Server, i due servizi aggiuntivi verranno arrestati automaticamente: il motore PolyBase e il servizio di spostamento dati. 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 (esito positivo) o 1 (errore).

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 tramite sp_configure.
run_value int Valore corrente usato da PolyBase. Questo valore viene impostato eseguendo RECONFIGURE.

e config_value 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:

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