Конфигурация подключения PolyBase (Transact-SQL)
Применимо:
SQL Server
База данных SQL Azure Azure Synapse Analytics Analytics Platform System (PDW)
Отображает или изменяет глобальные параметры конфигурации для подключения к PolyBase Hadoop и Хранилищу BLOB-объектов Microsoft Azure.
Соглашения о синтаксисе Transact-SQL
Синтаксис
Список всех параметров конфигурации.
sp_configure
[ ; ]
Настройка подключения Hadoop.
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"
Указывает тип источника данных Hadoop для всех подключений из PolyBase к кластерам Hadoop или Хранилищу BLOB-объектов Azure. Дополнительные сведения см. в разделе CREATE EXTERNAL DATA SOURCE.
В следующем списке содержатся параметры подключения 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: 1 Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Хранилище BLOB-объектов Azure (WASB[S]) и Azure Data Lake Storage 2-го поколения (ABFS[S])
1 Вариант 8 был представлен в SQL Server 2019 (15.x) CU 11.
По умолчанию для подключения 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 и служба перемещения данных. После перезапуска службы ядра 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.
Примеры
А. Список всех доступных параметров конфигурации.
В следующем примере демонстрируется, как создать список всех параметров конфигурации.
EXECUTE sp_configure;
В результате возвращается имя параметра, за которым следуют его минимальное и максимальное значения. Это config_value значение, которое PolyBase использует при завершении перенастройки. Это run_value значение, которое в настоящее время используется. Обычно config_value значение совпадает, run_value если значение не изменяется.
B. Список параметров конфигурации для одного имени конфигурации.
EXECUTE sp_configure @configname = 'hadoop connectivity';
В. Установка подключения к Hadoop.
В этом примере для PolyBase задается параметр 7. Этот параметр позволяет PolyBase создавать и использовать внешние таблицы в Hortonworks HDP 2.1, 2.2 и 2.3 в Linux и Windows Server, а также в Хранилище BLOB-объектов Azure. Например, SQL Server может содержать 30 внешних таблиц, причем 7 из них ссылаются на данные в Hortonworks HDP 2.1 в Linux, 4 в Hortonworks HDP 2.2 в Linux, 7 в Hortonworks HDP 2.3 в Linux, а также другие 12 ссылочных Хранилище BLOB-объектов Azure.
Этот код настраивает внешние таблицы для ссылок на данные в HDP 2.1, 2.2 и 2.3 в Linux и Хранилище BLOB-объектов Azure.
EXECUTE sp_configure
@configname = 'hadoop connectivity',
@configvalue = 7;
GO
RECONFIGURE;
GO