Konfigurasi Koneksi ivitas PolyBase (Transact-SQL)

  • Artikel

Berlaku untuk: SQL Server Not supported. Azure SQL DatabaseNot supported.Azure Synapse Analytics Analytics Platform System (PDW)

Menampilkan atau mengubah pengaturan konfigurasi global untuk konektivitas PolyBase Hadoop dan Microsoft Azure Blob Storage.

Konvensi sintaks transact-SQL

Sintaks

  
--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  
[;]

Argumen

[ @configname= ] 'option_name'
Adalah nama opsi konfigurasi. option_name adalah varchar(35), dengan default NULL. Jika tidak ditentukan, daftar lengkap opsi dikembalikan.

[ @configvalue= ] 'nilai'
Adalah pengaturan konfigurasi baru. nilai adalah int, dengan default NULL. Nilai maksimum tergantung pada opsi individual.

'konektivitas hadoop'
Menentukan jenis sumber data Hadoop untuk semua koneksi dari PolyBase ke kluster Hadoop atau Azure Blob Storage. Untuk informasi selengkapnya, lihat MEMBUAT SUMBER DATA EKSTERNAL (Transact-SQL).

Ini adalah pengaturan konektivitas Hadoop dan sumber data Hadoop yang didukung yang sesuai. Hanya satu pengaturan yang dapat berlaku pada satu waktu.

Opsi 1, 4, 7, dan 8 memungkinkan beberapa jenis sumber data eksternal dibuat dan digunakan di semua sesi di server.

  • Opsi 0: Nonaktifkan konektivitas Hadoop

  • Opsi 1: Hortonworks HDP 1.3 di Windows Server

  • Opsi 1: Azure Blob Storage (WASB[S])

  • Opsi 2: Hortonworks HDP 1.3 di Linux

  • Opsi 3: Cloudera CDH 4.3 di Linux

  • Opsi 4: Hortonworks HDP 2.0 di Windows Server

  • Opsi 4: Azure Blob Storage (WASB[S])

  • Opsi 5: Hortonworks HDP 2.0 di Linux

  • Opsi 6: Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12, dan 5.13 di Linux

  • Opsi 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0 di Linux

  • Opsi 7: Hortonworks HDP 2.1, 2.2, 2.3, 2.4 di Windows Server

  • Opsi 7: Azure Blob Storage (WASB[S])

  • Opsi 8:* Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Azure Blob Storage (WASB[S]) dan Azure Data Lake Storage Gen2 (ABFS[S])

* Opsi 8 diperkenalkan dengan SQL Server 2019 CU11.

Secara default, konektivitas Hadoop diatur ke 0 (dinonaktifkan). Anda harus mengonfigurasi nilai konektivitas hadoop PolyBase setelah menginstal lalu mengaktifkan PolyBase. Untuk informasi selengkapnya, lihat Menginstal PolyBase di Windows dan Mengonfigurasi PolyBase untuk mengakses data eksternal di Hadoop.

MENGKONFIGURASI
Memperbarui nilai eksekusi (run_value) agar sesuai dengan nilai konfigurasi (config_value). Lihat Tataan Hasil untuk definisi run_value dan config_value. Nilai konfigurasi baru yang ditetapkan oleh sp_configure tidak menjadi efektif sampai nilai eksekusi ditetapkan oleh RECONFIGURE pernyataan. Kemudian, setelah menjalankan RECONFIGURE, Anda harus menghentikan dan memulai ulang layanan SQL Server.

Penting

Perhatikan bahwa saat menghentikan layanan SQL Server, dua layanan tambahan juga akan secara otomatis berhenti: Mesin PolyBase dan Layanan Pergerakan Data. Setelah memulai ulang layanan mesin SQL Server, mulai lagi kedua layanan ini secara manual, karena tidak akan dimulai secara otomatis.

Mengembalikan nilai kode

0 (keberhasilan) atau 1 (kegagalan)

Tataan Hasil

Saat dijalankan tanpa parameter, sp_configure mengembalikan tataan hasil dengan lima kolom.

Nama kolom Jenis data Deskripsi
nama nvarchar(35) Nama opsi konfigurasi.
Minimum int Nilai minimum opsi konfigurasi.
Maksimum int Nilai maksimum opsi konfigurasi.
config_value int Nilai yang diatur menggunakan sp_configure.
run_value int Nilai saat ini digunakan oleh PolyBase. Nilai ini diatur dengan menjalankan KONFIGURASI ULANG.

config_value dan run_value biasanya sama kecuali nilainya sedang dalam proses diubah.

Mulai ulang mungkin diperlukan sebelum nilai eksekusi ini akurat, jika konfigurasi ulang sedang berlangsung.

Pernyataan umum

Di SQL Server, setelah menjalankan RECONFIGURE, agar nilai eksekusi 'konektivitas hadoop' berlaku, Anda perlu memulai ulang SQL Server.

Di Analytics Platform System (PDW), setelah menjalankan RECONFIGURE, agar nilai eksekusi 'konektivitas hadoop' berlaku, Anda perlu memulai ulang wilayah Analytics Platform System (PDW).

Mulai SQL Server 2022 (16.x), Hadoop tidak lagi didukung di PolyBase.

Pembatasan dan batasan

KONFIGURASI ULANG tidak diperbolehkan dalam transaksi eksplisit atau implisit.

Izin

Semua pengguna dapat menjalankan sp_configure tanpa parameter atau @configname parameter .

ALTER SETTINGS Memerlukan izin tingkat server atau keanggotaan dalam peran server tetap sysadmin untuk mengubah nilai konfigurasi atau untuk menjalankan RECONFIGURE.

Contoh

J. Mencantumkan semua pengaturan konfigurasi yang tersedia

Contoh berikut menunjukkan cara mencantumkan semua opsi konfigurasi.

EXEC sp_configure;

Hasilnya mengembalikan nama opsi diikuti dengan nilai minimum dan maksimum untuk opsi tersebut. config_value adalah nilai yang akan digunakan PolyBase saat konfigurasi ulang selesai. run_value adalah nilai yang saat ini sedang digunakan. config_value dan run_value biasanya sama kecuali nilainya sedang dalam proses diubah.

B. Mencantumkan pengaturan konfigurasi untuk satu nama konfigurasi

EXEC sp_configure @configname='hadoop connectivity';

C. Mengatur konektivitas Hadoop

Contoh ini mengatur PolyBase ke opsi 7. Opsi ini memungkinkan PolyBase untuk membuat dan menggunakan tabel eksternal pada Hortonworks HDP 2.1, 2.2, dan 2.3 di Linux dan Windows Server, dan Azure Blob Storage. Misalnya, SQL dapat memiliki 30 tabel eksternal dengan 7 di antaranya merujuk data pada Hortonworks HDP 2.1 di Linux, 4 di Hortonworks HDP 2.2 di Linux, 7 di Hortonworks HDP 2.3 di Linux, dan 12 lainnya merujuk Azure Blob Storage.

--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

Langkah berikutnya