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

Se aplica a: SQL Server Not supported. Azure SQL Database Not supported. Azure Synapse Analytics Analytics Platform System (PDW)

Muestra o cambia la configuración global para la conectividad de Hadoop de PolyBase y Microsoft Azure Blob Storage.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @configname= ] 'option_name'
Es el nombre de una opción de configuración. option_name es varchar(35) y su valor predeterminado es NULL. Si no se especifica, se devuelve la lista completa de opciones.

[ @configvalue= ] 'value'
Es la nueva configuración. value es de tipo inty su valor predeterminado es NULL. El valor máximo depende de la opción individual.

'conectividad de hadoop'
Especifica el tipo de origen de datos de Hadoop para todas las conexiones de PolyBase a clústeres de Hadoop o Azure Blob Storage. Para obtener más información, vea 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. Solo puede estar en vigor un valor de cada vez.

Las opciones 1, 4, 7 y 8 permiten que se creen y se usen varios tipos de orígenes de datos externos en todas las sesiones en el servidor.

  • Opción 0: deshabilitar la conectividad de Hadoop

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

  • Opción 1: Azure Blob Storage (WASB[S])

  • Opción 2: Hortonworks HDP 1.3 en Linux

  • Opción 3: Cloudera CDH 4.3 en Linux

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

  • Opción 4: Azure Blob Storage (WASB[S])

  • Opción 5: Hortonworks HDP 2.0 en Linux

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

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

  • Opción 7: Hortonworks HDP 2.1, 2.2, 2.3 y 2.4 en Windows Server

  • Opción 7: Azure Blob Storage (WASB[S])

  • Opción 8*: Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2 y 6.3, Azure Blob Storage (WASB[S]) y Azure Data Lake Storage Gen2 (ABFS[S])

* Opción 8 introducida con SQL Server 2019 CU11.

De forma predeterminada, la conectividad de Hadoop está establecida en 0 (deshabilitada). Debe configurar el valor de conectividad de Hadoop de PolyBase después de instalar y habilitar PolyBase. Para obtener más información, consulte Instalación de PolyBase en Windows y Configuración de PolyBase para acceder a datos externos en Hadoop.

RECONFIGURE
Actualiza el valor de ejecución (run_value) para que coincida con el valor de configuración (config_value). Vea Conjuntos de resultados para ver las definiciones de run_value y 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. Tras ejecutar RECONFIGURE, debe detener y reiniciar el servicio de SQL Server.

Importante

Tenga en cuenta que, al detener el servicio de SQL Server, también se detendrán automáticamente los dos servicios adicionales: el motor de PolyBase y el servicio de movimiento de datos. Después de reiniciar el servicio de motor de SQL Server, vuelva a iniciar de forma manual estos dos servicios, ya que no se inician automáticamente.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Cuando se ejecuta sin parámetros, sp_configure devuelve un conjunto de resultados con cinco columnas.

Nombre de la columna Tipo de datos Descripción
name nvarchar(35) Nombre de la opción de configuración.
Mínimo int Valor mínimo de la opción de configuración.
Máximo int Valor máximo de la opción de configuración.
config_value int Valor que se ha configurado con sp_configure.
run_value int Valor actual en uso por PolyBase. Este valor se establece al ejecutar RECONFIGURE.

Los valores config_value y run_value son normalmente los mismos, a menos que el valor se esté modificando.

Si la reconfiguración está en curso, podría ser necesario reiniciar antes de que este valor de ejecución sea preciso.

Observaciones generales

En SQL Server, después de ejecutar RECONFIGURE, debe reiniciar SQL Server para que surta efecto el valor de ejecución de la "conectividad de Hadoop".

En Sistema de la plataforma de análisis (PDW), después de ejecutar RECONFIGURE, debe reiniciar la región Sistema de la plataforma de análisis (PDW) para que surta efecto el valor de ejecución de la "conectividad de Hadoop".

A partir de SQL Server 2022 (16.x), Hadoop ya no se admite en PolyBase.

Limitaciones y restricciones

RECONFIGURE no se permite en una transacción implícita o explícita.

Permisos

Todos los usuarios pueden ejecutar sp_configure sin parámetros o con el parámetro @configname.

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.

Ejemplos

A. Lista de todas las opciones de configuración disponibles

En este ejemplo se muestra cómo enumerar todas las opciones de configuración.

EXEC sp_configure;  

El resultado devuelve el nombre de opción seguido por los valores mínimo y máximo de la opción. El valor config_value es el valor que usará PolyBase cuando se complete la reconfiguración. El valor run_value es el valor que se está usando actualmente. Los valores config_value y run_value son normalmente los mismos, a menos que el valor se esté modificando.

B. Lista de las opciones de configuración para un nombre de configuración

EXEC sp_configure @configname='hadoop connectivity';  

C. Establecer la conectividad de Hadoop

Este ejemplo establece PolyBase a la opción 7. Esta opción permite que PolyBase cree y use tablas externas en Hortonworks HDP 2.1, 2.2 y 2.3 en Linux y Windows Server y en Azure Blob Storage. Por ejemplo, SQL podría tener 30 tablas externas con 7 de ellas que hacen referencia a datos en Hortonworks HDP 2.1 en Linux, 4 en Hortonworks HDP 2.2 en Linux, 7 en Hortonworks HDP 2.3 en Linux y las otras 12 que hacen referencia a Azure Blob Storage.

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

Pasos siguientes