Бөлісу құралы:

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

Относится к:SQL ServerСистема аналитической платформы (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 .

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

Примеры

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

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

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

Связанный контент

  • Last updated on