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