Configuración de conectividad de PolyBase (Transact-SQL)PolyBase Connectivity Configuration (Transact-SQL)

SE APLICA A: síSQL Server noAzure SQL Database noAzure SQL Data Warehouse síAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse yesParallel Data Warehouse

Muestra o cambia la configuración global de PolyBase Hadoop y la conectividad de almacenamiento de blobs de Azure.Displays or changes global configuration settings for PolyBase Hadoop and Azure blob storage connectivity.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

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

ArgumentosArguments

[ @configname=** ] 'nombre_opción'[ @configname=** ] 'option_name'
Es el nombre de una opción de configuración.Is the name of a configuration option. option_name es varchar(35) y su valor predeterminado es NULL.option_name is varchar(35), with a default of NULL. Si no se especifica, se devuelve la lista completa de opciones.If not specified, the complete list of options is returned.

[ @configvalue=** ] 'valor'[ @configvalue=** ] 'value'
Es la nueva configuración.Is the new configuration setting. value es de tipo inty su valor predeterminado es NULL.value is int, with a default of NULL. El valor máximo depende de la opción individual.The maximum value depends on the individual option.

'conectividad de hadoop''hadoop connectivity'
Especifica el tipo de origen de datos de Hadoop para todas las conexiones de PolyBase a clústeres de Hadoop o almacenamiento de blobs de Azure (WASB).Specifies the type of Hadoop data source for all connections from PolyBase to Hadoop clusters or Azure blob storage (WASB). Esta configuración es necesaria para crear un origen de datos externo para una tabla externa.This setting is required in order to create an external data source for an external table. Para obtener más información, vea CREATE EXTERNAL DATA SOURCE (Transact-SQL).For more information, see CREATE EXTERNAL DATA SOURCE (Transact-SQL),

Esta es la configuración de conectividad de Hadoop y sus orígenes de datos de Hadoop compatibles correspondientes.These are the Hadoop connectivity settings and their corresponding supported Hadoop data sources. Solo puede estar en vigor un valor de cada vez.Only one setting can be in effect at a time. Las opciones 1, 4 y 7 permiten que se creen y usen varios tipos de orígenes de datos externos en todas las sesiones en el servidor.Options 1, 4, and 7 allow multiple types of external data sources to be created and used across all sessions on the server.

  • Opción 0: deshabilitar la conectividad de HadoopOption 0: Disable Hadoop connectivity

  • Opción 1: Hortonworks HDP 1.3 en Windows ServerOption 1: Hortonworks HDP 1.3 on Windows Server

  • Opción 1: almacenamiento de blobs de Azure (WASB[S])Option 1: Azure blob storage (WASB[S])

  • Opción 2: Hortonworks HDP 1.3 en LinuxOption 2: Hortonworks HDP 1.3 on Linux

  • Opción 3: Cloudera CDH 4.3 en LinuxOption 3: Cloudera CDH 4.3 on Linux

  • Opción 4: Hortonworks HDP 2.0 en Windows ServerOption 4: Hortonworks HDP 2.0 on Windows Server

  • Opción 4: almacenamiento de blobs de Azure (WASB[S])Option 4: Azure blob storage (WASB[S])

  • Opción 5: Hortonworks HDP 2.0 en LinuxOption 5: Hortonworks HDP 2.0 on Linux

  • Opción 6: Cloudera 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12 y 5.13 en LinuxOption 6: Cloudera 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12, and 5.13 on Linux

  • Opción 7: Hortonworks 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 en LinuxOption 7: Hortonworks 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 on Linux

  • Opción 7: Hortonworks 2.1, 2.2 y 2.3 en Windows ServerOption 7: Hortonworks 2.1, 2.2, and 2.3 on Windows Server

  • Opción 7: almacenamiento de blobs de Azure (WASB[S])Option 7: Azure blob storage (WASB[S])

RECONFIGURERECONFIGURE
Actualiza el valor de ejecución (run_value) para que coincida con el valor de configuración (config_value).Updates the run value (run_value) to match the configuration value (config_value). Vea Conjuntos de resultados para obtener definiciones de run_value y config_value.See Result Sets for definitions of run_value and config_value. El nuevo valor de configuración que se establece mediante sp_configure no es efectivo hasta que se establezca el valor de ejecución mediante la instrucción 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.

Tras ejecutar RECONFIGURE, debe detener y reiniciar el servicio de SQL Server.After running RECONFIGURE, you must stop and restart the SQL Server service. Tenga en cuenta que, al detener el servicio de SQL Server, los dos motores PolyBase adicionales y el servicio de movimiento de datos se detendrán automáticamente.Note that when stopping the SQL Server service, the two additional PolyBase Engine and Data Movement Service will automatically stop. Después de reiniciar el servicio de motor de SQL Server, vuelva a iniciar estos dos servicios de nuevo (no se inician automáticamente).After restarting the SQL Server engine service, re-start these two services again (they won't start automatically).

Valores de código de retornoReturn Code Values

0 (correcto) o 1 (error)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Cuando se ejecuta sin parámetros, sp_configure devuelve un conjunto de resultados con cinco columnas.When executed with no parameters, sp_configure returns a result set with five columns.

Nombre de columnaColumn name Tipo de datosData type DescripciónDescription
Nombrename nvarchar(35)nvarchar(35) Nombre de la opción de configuración.Name of the configuration option.
Mínimominimum intint Valor mínimo de la opción de configuración.Minimum value of the configuration option.
Máximomaximum intint Valor máximo de la opción de configuración.Maximum value of the configuration option.
config_valueconfig_value intint Valor que se ha configurado con sp_configure.Value that was set using sp_configure.
run_valuerun_value intint Valor actual en uso por PolyBase.Current value in use by PolyBase. Este valor se establece al ejecutar RECONFIGURE.This value is set by running RECONFIGURE.

Los valores config_value y run_value son normalmente los mismos, a menos que el valor se esté modificando.The config_value and run_value are usually the same unless the value is in the process of being changed.

Si la reconfiguración está en curso, podría ser necesario reiniciar antes de que este valor de ejecución sea preciso.A restart might be required before this run value is accurate, if the reconfiguration is in progress.

Notas generalesGeneral Remarks

En SQL ServerSQL Server, después de volver a ejecutar RECONFIGURE, para que surta efecto el valor de ejecución de la “conectividad de Hadoop”, debe reiniciar 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.
En Almacenamiento de datos paralelosParallel Data Warehouse, después de volver a ejecutar RECONFIGURE, para que surta efecto el valor de ejecución de la “conectividad de Hadoop”, debe reiniciar la región de Almacenamiento de datos paralelosParallel Data Warehouse .In Almacenamiento de datos paralelosParallel Data Warehouse, after running RECONFIGURE, for the run value of the 'hadoop connectivity' to take effect, you need to restart the Almacenamiento de datos paralelosParallel Data Warehouse region.

Limitaciones y restriccionesLimitations and Restrictions

RECONFIGURE no se permite en una transacción implícita o explícita.RECONFIGURE is not allowed in an explicit or implicit transaction.

PermisosPermissions

Todos los usuarios pueden ejecutar sp_configure sin parámetros o con el parámetro @configname .All users can execute sp_configure with no parameters or the @configname parameter.

Requiere permiso a nivel de servidor de ALTER SETTINGS o la pertenencia al rol fijo de servidor sysadmin para cambiar un valor de configuración o para ejecutar RECONFIGURE.Requires ALTER SETTINGS server-level permission or membership in the sysadmin fixed server role to change a configuration value or to run RECONFIGURE.

EjemplosExamples

A.A. Lista de todas las opciones de configuración disponiblesList all available configuration settings

En este ejemplo se muestra cómo enumerar todas las opciones de configuración.The following example shows how to list all configuration options.

EXEC sp_configure;  

El resultado devuelve el nombre de opción seguido por los valores mínimo y máximo de la opción.The result returns the option name followed by the minimum and maximum values for the option. El valor config_value es el valor que usarán SQL o PolyBase al completar la reconfiguración.The config_value is the value that SQL, or PolyBase, will use when reconfiguration is complete. El valor run_value es el valor que se está usando actualmente.The run_value is the value that is currently being used. Los valores config_value y run_value son normalmente los mismos, a menos que el valor se esté modificando.The config_value and run_value are usually the same unless the value is in the process of being changed.

B.B. Lista de las opciones de configuración para un nombre de configuraciónList the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

C.C. Establecer la conectividad de HadoopSet Hadoop connectivity

Este ejemplo establece PolyBase a la opción 7.This example sets PolyBase to option 7. Esta opción permite que PolyBase cree y use tablas externas en Hortonworks 2.1, 2.2 y 2.3 en Linux y Windows Server y en el almacenamiento de blobs de 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. Por ejemplo, SQL podría tener 30 tablas externas con 7 de ellas haciendo referencia a datos en Hortonworks 2.1 en Linux, 4 en Hortonworks 2.2 en Linux, 7 en Hortonworks 2.3 en Linux y las otras 12 haciendo referencia al almacenamiento de blobs de 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  

Ver tambiénSee 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)