PolyBase 接続構成 (Transact-SQL)
適用対象:azure Synapse Analytics Analytics プラットフォーム システム (PDW) Azure SQL Database SQL Server
PolyBase での Hadoop と Microsoft Azure Blob Storage の接続に対するグローバル構成設定を表示または変更します。
構文
--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'
PolyBase から Hadoop クラスターまたは Azure Blob Storage へのすべての接続に、Hadoop データ ソースの種類を指定します。 詳細については、「CREATE EXTERNAL DATA SOURCE (Transact-SQL)」を参照してください。
Hadoop の接続設定とそれに対応してサポートされる Hadoop データ ソースがあります。 一度に 1 つの設定だけを有効にすることができます。
オプション 1、4、7、8 では、複数の種類の外部データ ソースを作成して、サーバー上のすべてのセッションで使用することができます。
オプション 0:Hadoop 接続の無効化
オプション 1: Windows Server 上の Hortonworks HDP 1.3
オプション 1: Azure Blob Storage (WASB[S])
オプション 2:Linux 上の Hortonworks HDP 1.3
オプション 3:Linux 上の Cloudera CDH 4.3
オプション 4:Windows Server 上の Hortonworks HDP 2.0
オプション 4: Azure Blob Storage (WASB[S])
オプション 5:Linux 上の Hortonworks HDP 2.0
オプション 6: Linux 上の Cloudera CDH 5.1、5.2、5.3、5.4、5.5、5.9、5.10、5.11、5.12、5.13
オプション 7: Linux 上の Hortonworks HDP 2.1、2.2、2.3、2.4、2.5、2.6、3.0
オプション 7: Windows Server 上の Hortonworks HDP 2.1、2.2、2.3、2.4
オプション 7: Azure Blob Storage (WASB[S])
オプション 8:* Hortonworks HDP 3.1、Cloudera CDH 6.1、6.2、6.3、Azure Blob Storage (WASB[S])、Azure Data Lake Storage Gen2 (ABFS[S])
* オプション 8 は SQL Server 2019 CU11 で導入されました。
既定で、Hadoop 接続は 0 (無効) に設定されています。 インストール後に PolyBase を有効にして、PolyBase Hadoop 接続の値を構成する必要があります。 詳細については、「Windows への PolyBase のインストール」と「Hadoop 内の外部データにアクセスするように PolyBase を構成する」を参照してください。
RECONFIGURE
構成値 (config_value
) と一致するように、実行値 (run_value
) を更新します。 run_value
と config_value
の定義については、「結果セット」を参照してください。 sp_configure
で設定されている新しい構成値は、実行値が RECONFIGURE
ステートメントによって設定されるまで有効になりません。 RECONFIGURE
を実行した後、SQL Server サービスを停止して再起動する必要があります。
重要
SQL Server サービスを停止すると、それ以外の 2 つのサービス (PolyBase エンジンとデータ移動サービス) が自動的に停止されることにご注意ください。 SQL Server エンジン サービスを再起動した後で、これら 2 つのサービスを手動で起動します (自動的には起動されません)。
リターン コードの値
0 (成功) または 1 (失敗)
結果セット
パラメーターなしで実行すると、sp_configure
からは 5 つの列を含む結果セットが返されます。
列名 | データ型 | 説明 |
---|---|---|
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 を再起動する必要があります。
Analytics Platform System (PDW) では、RECONFIGURE
の実行後に、"hadoop connectivity" の実行値を有効にするため、Analytics Platform System (PDW) リージョンを再起動する必要があります。
SQL Server 2022 (16.x) 以降、Hadoop は PolyBase でサポートされなくなります。
制限事項と制約事項
RECONFIGURE は、明示的または暗黙的なトランザクションでは使用できません。
アクセス許可
すべてのユーザーは、パラメーターなしで、または @configname パラメーターを使用して、sp_configure
を実行することができます。
構成値を変更するか、RECONFIGURE
を実行するには、sysadmin 固定サーバー ロールに ALTER SETTINGS
のサーバー レベル権限またはメンバーシップが必要です。
例
A. すべての使用可能な構成設定を一覧表示する
次の例では、すべての構成オプションを一覧表示する方法を示します。
EXEC sp_configure;
結果は、オプションの最小値と最大値が続くオプション名を返します。 config_value は、再構成が完了したときに PolyBase で使用される値です。 run_value は、現在使用されている値です。 値が変更中のプロセスではない限り、 config_value と run_value は、通常は同じ値です。
B. 1 つの構成名の構成設定を一覧表示する
EXEC sp_configure @configname='hadoop connectivity';
C. Hadoop 接続を設定する
この例では、PolyBase をオプション 7 に設定します。 このオプションでは、PolyBase は、Linux と Windows Server、および Azure Blob Storage 上の Hortonworks HDP 2.1、2.2、および 2.3 の外部テーブルを作成および使用できます。 たとえば、SQL は 30 個の外部テーブルを、Linux 上の Hortonworks HDP 2.1 のデータを参照する 7 個、Linux 上の Hortonworks HDP 2.2 の 4 個、Linux 上の Hortonworks HDP 2.3 の 7 個、Azure Blob Storage を参照するその他の 12 個の外部テーブルとして所有することができます。
--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