Configurazione della connettività di PolyBase (Transact-SQL)
Si applica a: SQL Server database SQL di Azure azure Synapse 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
--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