Compartir vía

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

  • Artículo

Se aplica a: SQL Server No compatible. Azure SQL Database No compatible. 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

Enumera todas las opciones de configuración.

sp_configure
[ ; ]

Configuración de la conectividad de Hadoop.

sp_configure [ @configname = ] 'hadoop connectivity' ,
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 }
[ ; ]

RECONFIGURE
[ ; ]

Argumentos

[ @configname = ] 'option_name'

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'

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 más información, vea CREATE EXTERNAL DATA SOURCE.

La lista siguiente contiene 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: 1 Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Azure Blob Storage (WASB[S]) y Azure Data Lake Storage Gen2 (ABFS[S])

1 La opción 8 se introdujo con SQL Server 2019 (15.x) CU 11.

De forma predeterminada, la conectividad de Hadoop está establecida 0 en (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 establecido por sp_configure no se hace efectivo hasta que la RECONFIGURE instrucción establece el valor de ejecución. Tras ejecutar RECONFIGURE, debe detener y reiniciar el servicio de SQL Server.

Importante

Al detener el servicio SQL Server, los dos servicios adicionales también se detendrán automáticamente: PolyBase Engine y Data Movement Service. 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 (erróneo).

Conjunto 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.
minimum int Valor mínimo de la opción de configuración.
maximum int Valor máximo de la opción de configuración.
config_value int Valor que se estableció mediante sp_configure.
run_value int Valor actual en uso por PolyBase. Este valor se establece mediante la ejecución RECONFIGUREde .

y config_value run_value suelen ser los mismos a menos que el valor esté en proceso de cambio.
Si la reconfiguración está en curso, podría ser necesario reiniciar antes de que este valor de ejecución sea preciso.

Comentarios

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

En SQL Server 2022 (16.x) y versiones posteriores, Hadoop ya no se admite en PolyBase.

Limitaciones

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

Permisos

Todos los usuarios pueden ejecutar sp_configure sin parámetros ni 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.

EXECUTE sp_configure;

El resultado devuelve el nombre de opción seguido por los valores mínimo y máximo de la opción. config_value es el valor que PolyBase usa cuando se completa la reconfiguración. run_value es el valor que se está usando actualmente. y config_value run_value suelen ser los mismos a menos que el valor esté en proceso de cambio.

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

EXECUTE 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 Server podría tener 30 tablas externas, con 7 de ellas haciendo 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 en las otras 12 referencias a Azure Blob Storage.

Este código configura tablas externas para hacer referencia a datos en Hortonworks HDP 2.1, 2.2 y 2.3 en Linux y Azure Blob Storage.

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

RECONFIGURE;
GO

Contenido relacionado