Bagikan melalui

Konfigurasi konektivitas PolyBase (Transact-SQL)

  • Artikel

Berlaku untuk: SQL Server Tidak didukung. Azure SQL DatabaseTidak didukung. 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

Cantumkan semua opsi konfigurasi.

sp_configure
[ ; ]

Mengonfigurasi konektivitas Hadoop.

sp_configure [ @configname = ] 'hadoop connectivity' ,
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 }
[ ; ]

RECONFIGURE
[ ; ]

Argumen

[ @configname = ] 'option_name'

Nama opsi konfigurasi. option_name adalah varchar(35), dengan default NULL. Jika tidak ditentukan, daftar lengkap opsi dikembalikan.

[ @configvalue = ] 'nilai'

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.

Daftar berikut berisi pengaturan konektivitas Hadoop dan sumber data Hadoop yang didukung terkait. 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: 1 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])

1 Opsi 8 diperkenalkan dengan SQL Server 2019 (15.x) CU 11.

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.

KONFIGURASI ULANG

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

Saat menghentikan layanan SQL Server, dua layanan tambahan juga akan secara otomatis berhenti: PolyBase Engine dan Data Movement Service. Setelah memulai ulang layanan mesin SQL Server, mulai lagi kedua layanan ini secara manual, karena tidak akan dimulai secara otomatis.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

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

Nama kolom Jenis data Deskripsi
name nvarchar(35) Nama opsi konfigurasi.
minimum int Nilai minimum opsi konfigurasi.
maximum 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 RECONFIGURE.

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.

Keterangan

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

Di SQL Server 2022 (16.x) dan versi yang lebih baru, Hadoop tidak lagi didukung di PolyBase.

Batasan

RECONFIGURE tidak diizinkan dalam transaksi eksplisit atau implisit.

Izin

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

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.

EXECUTE sp_configure;

Hasilnya mengembalikan nama opsi diikuti dengan nilai minimum dan maksimum untuk opsi tersebut. config_value adalah nilai yang 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

EXECUTE 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 Server 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.

Kode ini mengonfigurasi tabel eksternal untuk mereferensikan data pada Hortonworks HDP 2.1, 2.2, dan 2.3 di Linux, dan Azure Blob Storage.

EXECUTE sp_configure
    @configname = 'hadoop connectivity',
    @configvalue = 7;
GO

RECONFIGURE;
GO

Konten terkait