Configurazione della connettività di PolyBase (Transact-SQL)PolyBase Connectivity Configuration (Transact-SQL)

THIS TOPIC APPLIES TO:yesSQL Server (starting with 2016)noAzure SQL DatabasenoAzure SQL Data Warehouse yesParallel Data Warehouse

Visualizza o modifica le impostazioni di configurazione globali per la connettività tra PolyBase, Hadoop e l'archivio BLOB di Azure.Displays or changes global configuration settings for PolyBase Hadoop and Azure blob storage connectivity.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax


--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 }  
[;]  

RECONFIGURE  
[;]  

ArgomentiArguments

[ @configname= ] 'option_name'[ @configname= ] 'option_name'
Nome di un'opzione di configurazione.Is the name of a configuration option. option_name è varchar(35)e il valore predefinito è NULL.option_name is varchar(35), with a default of NULL. Se non si specifica alcun nome di opzione, viene restituito l'elenco completo delle opzioni.If not specified, the complete list of options is returned.

[ @configvalue= ] 'value'[ @configvalue= ] 'value'
Nuova impostazione di configurazione.Is the new configuration setting. value è inte il valore predefinito è NULL.value is int, with a default of NULL. Il valore massimo dipende dalla singola opzione.The maximum value depends on the individual option.

'hadoop connectivity''hadoop connectivity'
Specifica il tipo di origine dati Hadoop per tutte le connessioni da PolyBase a cluster Hadoop o archivi BLOB di Azure (WASB).Specifies the type of Hadoop data source for all connections from PolyBase to Hadoop clusters or Azure blob storage (WASB). Questa impostazione è necessaria per creare un'origine dati esterna per una tabella esterna.This setting is required in order to create an external data source for an external table. Per altre informazioni, vedere CREATE EXTERNAL DATA SOURCE (Transact-SQL).For more information, see CREATE EXTERNAL DATA SOURCE (Transact-SQL),

Queste sono le impostazioni di connettività di Hadoop e le origini dati Hadoop supportate corrispondenti.These are the Hadoop connectivity settings and their corresponding supported Hadoop data sources. Può essere attiva una sola impostazione alla volta.Only one setting can be in effect at a time. Le opzioni 1, 4 e 7 consentono la creazione e l'uso di più tipi di origini dati esterne in tutte le sessioni nel server.Options 1, 4, and 7 allow multiple types of external data sources to be created and used across all sessions on the server.

  • Opzione 0: disabilitazione della connettività HadoopOption 0: Disable Hadoop connectivity

  • Opzione 1: Hortonworks HDP 1.3 su Windows ServerOption 1: Hortonworks HDP 1.3 on Windows Server

  • Opzione 1: archivio BLOB di Azure (WASB[S])Option 1: Azure blob storage (WASB[S])

  • Opzione 2: Hortonworks HDP 1.3 su LinuxOption 2: Hortonworks HDP 1.3 on Linux

  • Opzione 3: Cloudera CDH 4.3 su LinuxOption 3: Cloudera CDH 4.3 on Linux

  • Opzione 4: Hortonworks HDP 2.0 su Windows ServerOption 4: Hortonworks HDP 2.0 on Windows Server

  • Opzione 4: archivio BLOB di Azure (WASB[S])Option 4: Azure blob storage (WASB[S])

  • Opzione 5: Hortonworks HDP 2.0 su LinuxOption 5: Hortonworks HDP 2.0 on Linux

  • Opzione 6: Cloudera 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11 e 5.12 su LinuxOption 6: Cloudera 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, and 5.12 on Linux

  • Opzione 7: Hortonworks 2.1, 2.2, 2.3, 2.4, 2.5 e 2.6 su LinuxOption 7: Hortonworks 2.1, 2.2, 2.3, 2.4, 2.5, and 2.6 on Linux

  • Opzione 7: Hortonworks 2.1, 2.2 e 2.3 su Windows ServerOption 7: Hortonworks 2.1, 2.2, and 2.3 on Windows Server

  • Opzione 7: archivio BLOB di Azure (WASB[S])Option 7: Azure blob storage (WASB[S])

    RECONFIGURERECONFIGURE
    Aggiorna il valore di esecuzione (run_value) in modo che corrisponda al valore di configurazione (config_value).Updates the run value (run_value) to match the configuration value (config_value). Vedere Set di risultati per le definizioni di run_value e config_value.See Result Sets for definitions of run_value and 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.The new configuration value that is set by sp_configure does not become effective until the run value is set by the RECONFIGURE statement.

    Dopo l'esecuzione di RECONFIGURE è necessario arrestare e riavviare il servizio SQL Server.After running RECONFIGURE, you must stop and restart the SQL Server service. Si noti che con l'arresto del servizio SQL Server verranno arrestati automaticamente i due servizi aggiuntivi Motore PolyBase e Polybase Data Movement.Note that when stopping the SQL Server service, the two additional PolyBase Engine and Data Movement Service will automatically stop. Dopo il riavvio del servizio SQL Server, riavviare questi due servizi, che non si riavviano automaticamente.After restarting the SQL Server engine service, re-start these two services again (they won’t start automatically).

Valori restituitiReturn Code Values

0 (esito positivo) o 1 (esito negativo)0 (success) or 1 (failure)

Set di risultati Result Sets

Se eseguita senza parametri, sp_configure restituisce un set di risultati con cinque colonne.When executed with no parameters, sp_configure returns a result set with five columns.

Nome colonnaColumn name Tipo di datiData type DescriptionDescription
namename nvarchar(35)nvarchar(35) Nome dell'opzione di configurazione.Name of the configuration option.
minimumminimum intint Valore minimo dell'opzione di configurazione.Minimum value of the configuration option.
maximummaximum intint Valore massimo dell'opzione di configurazione.Maximum value of the configuration option.
config_valueconfig_value intint Valore impostato con sp_configure.Value that was set using sp_configure.
run_valuerun_value intint Valore corrente usato da PolyBase.Current value in use by PolyBase. Questo valore viene impostato tramite l'esecuzione di RECONFIGURE.This value is set by running RECONFIGURE.

The config_value e run_value sono in genere uguali, a meno che il valore non sia in corso di modifica.The config_value and run_value are usually the same unless the value is in the process of being changed.

Se la riconfigurazione è in corso, potrebbe essere necessario un riavvio per ottenere un valore di esecuzione accurato.A restart might be required before this run value is accurate, if the reconfiguration is in progress.

Osservazioni generaliGeneral Remarks

In SQL ServerSQL Server, dopo aver eseguito RECONFIGURE, per rendere effettivo il valore di esecuzione di 'hadoop connectivity', è necessario riavviare SQL ServerSQL Server.In SQL ServerSQL Server, after running RECONFIGURE, for the run value of the 'hadoop connectivity' to take effect, you need to restart SQL ServerSQL Server.
In Parallel Data WarehouseParallel Data Warehouse, dopo aver eseguito RECONFIGURE, per rendere effettivo il valore di esecuzione di 'hadoop connectivity', è necessario riavviare l'area Parallel Data WarehouseParallel Data Warehouse .In Parallel Data WarehouseParallel Data Warehouse, after running RECONFIGURE, for the run value of the 'hadoop connectivity' to take effect, you need to restart the Parallel Data WarehouseParallel Data Warehouse region.

Limitazioni e restrizioniLimitations and Restrictions

L'istruzione RECONFIGURE non è consentita in una transazione esplicita o implicita.RECONFIGURE is not allowed in an explicit or implicit transaction.

PermissionsPermissions

Tutti gli utenti possono eseguire sp_configure senza parametri o con il parametro @configname .All users can execute sp_configure with no parameters or the @configname parameter.

Per modificare un valore di configurazione o per eseguire RECONFIGURE, è necessaria l'autorizzazione a livello di server ALTER SETTINGS o l'appartenenza al ruolo predefinito del server sysadmin .Requires ALTER SETTINGS server-level permission or membership in the sysadmin fixed server role to change a configuration value or to run RECONFIGURE.

EsempiExamples

A.A. Elencare tutte le impostazioni di configurazione disponibiliList all available configuration settings

L'esempio seguente mostra come impostare ed elencare tutte le opzioni di configurazione.The following example shows how to list all configuration options.

EXEC sp_configure;  

Il risultato restituisce il nome dell'opzione seguito dai valori minimi e massimo per l'opzione.The result returns the option name followed by the minimum and maximum values for the option. config_value è il valore che verrà usato da SQL o PolyBase dopo il completamento della riconfigurazione.The config_value is the value that SQL, or PolyBase, will use when reconfiguration is complete. config_value è il valore in uso.The run_value is the value that is currently being used. The config_value e run_value sono in genere uguali, a meno che il valore non sia in corso di modifica.The config_value and run_value are usually the same unless the value is in the process of being changed.

B.B. Elencare le impostazioni di configurazione per un nome di configurazioneList the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

C.C. Impostare la connettività HadoopSet Hadoop connectivity

Questo esempio imposta PolyBase sull'opzione 7.This example sets PolyBase to option 7. Questa opzione consente a PolyBase per creare e usare tabelle esterne su Hortonworks 2.1, 2.2 e 2.3 su Linux e Windows Server e nell'archivio BLOB di Azure.This option allows PolyBase to create and use external tables on Hortonworks 2.1, 2.2, and 2.3 on Linux and Windows Server, and Azure blob storage. SQL potrebbe includere, ad esempio, 30 tabelle esterne di cui 7 fanno riferimento a dati in Hortonworks 2.1 su Linux, 4 in Hortonworks 2.2 su Linux, 7 in Hortonworks 2.3 su Linux e le altre 12 all'archivio BLOB di Azure.For example, SQL could have 30 external tables with 7 of them referencing data on Hortonworks 2.1 on Linux, 4 on Hortonworks 2.2 on Linux, 7 on Hortonworks 2.3 on Linux, and the other 12 referencing Azure blob storage.

--Configure external tables to reference data on Hortonworks 2.1, 2.2, and 2.3 on Linux, and Azure blob storage  

sp_configure @configname = 'hadoop connectivity', @configvalue = 7;  
GO  

RECONFIGURE  
GO  

Vedere ancheSee Also

sp_configure (Transact-SQL) sp_configure (Transact-SQL)
CREATE EXTERNAL TABLE (Transact-SQL) CREATE EXTERNAL TABLE (Transact-SQL)
CREATE EXTERNAL FILE FORMAT (Transact-SQL) CREATE EXTERNAL FILE FORMAT (Transact-SQL)
CREATE EXTERNAL DATA SOURCE (Transact-SQL)CREATE EXTERNAL DATA SOURCE (Transact-SQL)