Конфигурация подключения к PolyBase (Transact-SQL)
Область применения: 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
возвращает результирующий набор с пятью столбцами.
Имя столбца | Тип данных | Описание |
---|---|---|
name | nvarchar(35) | Имя параметра конфигурации. |
minimum | int | Минимальное значение параметра конфигурации. |
maximum | int | Максимальное значение параметра конфигурации. |
config_value | int | Значение, которое было задано с помощью sp_configure. |
run_value | int | Текущее значение, используемое PolyBase. Это значение можно задать, выполнив инструкцию RECONFIGURE. Значения config_value и run_value , как правило, совпадают, если не находятся в процессе изменения. Если выполняется перенастройка, может потребоваться перезагрузка, чтобы это рабочее значение стало точным. |
Общие замечания
В SQL Server после выполнения инструкции RECONFIGURE
для вступления в силу рабочего значения hadoop connectivity необходимо перезапустить SQL Server.
В Система платформы аналитики (PDW) после выполнения инструкции RECONFIGURE
для вступления в силу рабочего значения hadoop connectivity необходимо перезапустить регион Система платформы аналитики (PDW).
Начиная с SQL Server 2022 г. (16.x) Hadoop больше не поддерживается в PolyBase.
ограничения
Недопустимо использование RECONFIGURE в явной или неявной транзакции.
Разрешения
Все пользователи могут выполнять команду sp_configure
без параметров или с параметром @configname.
Для изменения значения конфигурации или выполнения инструкции RECONFIGURE
требуется разрешение ALTER SETTINGS
на уровне сервера или членство в предопределенной роли сервера sysadmin.
Примеры
A. Список всех доступных параметров конфигурации.
В следующем примере демонстрируется, как создать список всех параметров конфигурации.
EXEC sp_configure;
В результате возвращается имя параметра, за которым следуют его минимальное и максимальное значения. config_value — это значение, которое будет использовать PolyBase после завершения перенастройки. run_value — это значение, которое используется в настоящий момент. Значения config_value и run_value , как правило, совпадают, если не находятся в процессе изменения.
Б. Список параметров конфигурации для одного имени конфигурации.
EXEC sp_configure @configname='hadoop connectivity';
В. Установка подключения к 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
Дальнейшие действия
Обратная связь
Отправить и просмотреть отзыв по