Конфигурация подключения к PolyBase (Transact-SQL)

Статья
05/03/2023

Область применения: SQL Server База данных SQL Azure Azure Synapse Analytics Analytics Platform System (PDW)

Отображает или изменяет глобальные параметры конфигурации для подключения к PolyBase Hadoop и Хранилищу BLOB-объектов Microsoft Azure.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @configname= ] 'option_name'
Имя параметра конфигурации. Аргументoption_name имеет тип varchar(35), значение по умолчанию — NULL. Если этот параметр отсутствует, возвращается список всех параметров.

[ @configvalue= ] 'value'
Новое значение параметра конфигурации. Аргументvalue имеет тип int и значение по умолчанию NULL. Максимальное значение зависит от конкретного параметра.

'hadoop connectivity'
Указывает тип источника данных Hadoop для всех подключений из PolyBase к кластерам Hadoop или Хранилищу BLOB-объектов Azure. Дополнительные сведения см. в разделе CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Ниже приведены параметры подключения к Hadoop и соответствующие поддерживаемые источники данных Hadoop. Одновременно может действовать только один параметр.

Варианты 1, 4, 7 и 8 позволяют создать несколько типов внешних источников данных и использовать их во всех сеансах на сервере.

Параметр 0. Отключить подключение Hadoop
Параметр 1. Hortonworks HDP 1.3 в Windows Server
Вариант 1. Хранилище BLOB-объектов Azure (WASB[S])
Параметр 2. Hortonworks HDP 1.3 в Linux
Параметр 3. Cloudera CDH 4.3 в Linux
Параметр 4. Hortonworks HDP 2.0 в Windows Server
Вариант 4. Хранилище BLOB-объектов Azure (WASB[S])
Параметр 5. Hortonworks HDP 2.0 в Linux
Вариант 6. Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12 и 5.13 в Linux
Вариант 7. Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 в Linux
Вариант 7. Hortonworks HDP 2.1, 2.2, 2.3, 2.4 в Windows Server
Вариант 7. Хранилище BLOB-объектов Azure (WASB[S])
Вариант 8.* Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Хранилище BLOB-объектов Azure (WASB[S]) и Azure Data Lake Storage 2-го поколения (ABFS[S])

* Вариант 8 появился в SQL Server 2019 с накопительным пакетом обновлений 11 (CU11).

По умолчанию для подключения к Hadoop установлено значение 0 (отключено). Необходимо настроить значение подключения Hadoop в PolyBase после установки, а затем включить Polybase. Дополнительные сведения см. в статьях Установка PolyBase на Windows и Настройка PolyBase для доступа к внешним данным в Hadoop.

RECONFIGURE
Обновляет значение запуска (run_value) в соответствии со значением конфигурации (config_value). Определения run_value и config_value см. в результирующих наборах. Новое значение конфигурации, которое задается параметром sp_configure, не вступит в силу до тех пор, пока инструкция RECONFIGURE не задаст рабочее значение. После выполнения инструкции RECONFIGURE необходимо остановить и перезапустить службу SQL Server.

Важно!

Обратите внимание, что при остановке службы SQL Server автоматически останавливаются две дополнительные службы — PolyBase Engine и служба перемещения данных. После перезапуска службы ядра SQL Server вручную запустите эти две службы заново (они не запускаются автоматически).

Значения кода возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

При выполнении без параметров sp_configure возвращает результирующий набор с пятью столбцами.

Имя столбца	Тип данных	Description
name	nvarchar(35)	Имя параметра конфигурации.
minimum	int	Минимальное значение параметра конфигурации.
maximum	int	Максимальное значение параметра конфигурации.
config_value	int	Значение, которое было задано с помощью sp_configure.
run_value	int	Текущее значение, используемое PolyBase. Это значение можно задать, выполнив инструкцию RECONFIGURE. Значения config_value и run_value , как правило, совпадают, если не находятся в процессе изменения. Если выполняется перенастройка, может потребоваться перезагрузка, чтобы это рабочее значение стало точным.

Общие замечания

После запуска RECONFIGURESQL Server необходимо перезапустить SQL Server, чтобы значение запуска подключения hadoop вступило в силу.

В системе платформы аналитики (PDW) после выполнения RECONFIGUREдля выполнения значения подключения hadoop необходимо перезапустить регион "Система платформы аналитики" (PDW).

Начиная с SQL Server 2022 (16.x), Hadoop больше не поддерживается в PolyBase.

ограничения

Недопустимо использование RECONFIGURE в явной или неявной транзакции.

Разрешения

Все пользователи могут выполнять команду sp_configure без параметров или с параметром @configname.

Для изменения значения конфигурации или выполнения инструкции RECONFIGURE требуется разрешение ALTER SETTINGS на уровне сервера или членство в предопределенной роли сервера sysadmin.

Примеры

А. Список всех доступных параметров конфигурации.

В следующем примере демонстрируется, как создать список всех параметров конфигурации.

EXEC sp_configure;

В результате возвращается имя параметра, за которым следуют его минимальное и максимальное значения. config_value — это значение, которое будет использовать PolyBase после завершения перенастройки. run_value — это значение, которое используется в настоящий момент. Значения config_value и run_value , как правило, совпадают, если не находятся в процессе изменения.

B. Список параметров конфигурации для одного имени конфигурации.

EXEC sp_configure @configname='hadoop connectivity';

C. Установка подключения к Hadoop.

В этом примере для PolyBase задается параметр 7. Этот параметр позволяет PolyBase создавать и использовать внешние таблицы в Hortonworks HDP 2.1, 2.2 и 2.3 в Linux и Windows Server, а также в Хранилище BLOB-объектов Azure. Например, SQL может содержать 30 внешних таблиц, 7 из которых будут ссылаться на данные в Hortonworks HDP 2.1 в Linux, 4 — в Hortonworks HDP 2.2 в Linux, 7 — в Hortonworks HDP 2.3 в Linux и еще 12 — в Хранилище BLOB-объектов Azure.

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