Configuración de conectividad de PolyBase (Transact-SQL)
Se aplica a: Sql Server Azure SQL Database 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