PolyBase 接続の構成 (Transact-SQL)
適用対象: 
SQL Server 
Azure SQL Database Azure Synapse Analytics Analytics Platform System (PDW)
PolyBase での Hadoop と Microsoft Azure Blob Storage の接続に対するグローバル構成設定を表示または変更します。
構文
すべての構成オプションを一覧表示します。
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 接続'
PolyBase から Hadoop クラスターまたは Azure Blob Storage へのすべての接続に、Hadoop データ ソースの種類を指定します。 詳しくは、「CREATE EXTERNAL DATA SOURCE」をご覧ください。
次の一覧には、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: 1 Hortonworks HDP 3.1、Cloudera CDH 6.1、6.2、6.3、Azure Blob Storage (WASB[S]) および Azure Data Lake Storage Gen2 (ABFS[S])
1 オプション 8 は、SQL Server 2019 (15.x) CU 11 で導入されました。
既定では、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 サービスを停止すると、PolyBase エンジンとデータ移動サービスの 2 つの追加サービスも自動的に停止します。 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. すべての使用可能な構成設定を一覧表示する
次の例では、すべての構成オプションを一覧表示する方法を示します。
EXECUTE sp_configure;
結果は、オプションの最小値と最大値が続くオプション名を返します。 config_valueは、再構成が完了したときに PolyBase が使用する値です。 run_valueは、現在使用されている値です。 値が変更中でない限り、 config_value と run_value は通常同じです。
B. 1 つの構成名の構成設定を一覧表示する
EXECUTE 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 Server には 30 個の外部テーブルがあり、そのうちの 7 個が Linux 上の Hortonworks HDP 2.1、Linux 上の Hortonworks HDP 2.2 上の 4、Linux 上の Hortonworks HDP 2.3、Azure Blob Storage を参照する他の 12 のデータを参照します。
このコードでは、Linux および Azure Blob Storage 上の Hortonworks HDP 2.1、2.2、2.3 上のデータを参照するように外部テーブルを構成します。
EXECUTE sp_configure
@configname = 'hadoop connectivity',
@configvalue = 7;
GO
RECONFIGURE;
GO