BUAT SUMBER DATA EKSTERNAL (TRANSACT-SQL)

Membuat sumber data eksternal untuk kueri menggunakan SQL Server, Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW), atau Azure SQL Edge.

Artikel ini menyediakan sintaks, argumen, keterangan, izin, dan contoh untuk produk SQL mana pun yang Anda pilih.

Pilih produk

Di baris berikut, pilih nama produk yang Anda minati, dan hanya informasi produk yang ditampilkan.

* SQL Server *  

Microsoft Azure SQL Database

SQL Managed
Instans

Azure Synapse
Analytics

Platform Analitik
Sistem (PDW)

 

Ringkasan: SQL Server 2022

Berlaku untuk: SQL Server 2022 (16.x) dan yang lebih baru

Membuat sumber data eksternal untuk kueri PolyBase. Sumber data eksternal digunakan untuk membangun konektivitas dan mendukung kasus penggunaan utama ini:

• Virtualisasi data dan pemuatan data menggunakan PolyBase
• Operasi pemuatan massal menggunakan BULK INSERT atau OPENROWSET

Catatan

Sintaks ini bervariasi dalam versi SQL Server yang berbeda. Gunakan menu dropdown pemilih versi untuk memilih versi yang sesuai. Konten ini berlaku untuk SQL Server 2022 (16.x) dan yang lebih baru.

Sintaks untuk SQL Server 2022 dan yang lebih baru

Untuk informasi selengkapnya tentang konvensi sintaks, lihat Konvensi sintaks transact-SQL.

CREATE EXTERNAL DATA SOURCE <data_source_name>
WITH
  ( [ LOCATION = '<prefix>://<path>[:<port>]' ]
    [ [ , ] CONNECTION_OPTIONS = '<key_value_pairs>'[,...]]
    [ [ , ] CREDENTIAL = <credential_name> ]
    [ [ , ] PUSHDOWN = { ON | OFF } ]
  )
[ ; ]

Argumen

data_source_name

Menentukan nama yang ditentukan pengguna untuk sumber data. Nama harus unik dalam database di SQL Server.

LOCATION = '<prefix>://<path[:port]>'

Menyediakan protokol dan jalur konektivitas ke sumber data eksternal.

Sumber Data Eksternal	Awalan lokasi konektor	Jalur lokasi	Lokasi yang didukung berdasarkan produk / layanan	Autentikasi
Akun Azure Storage(V2)	abs	abs://<container_name>@<storage_account_name>.blob.core.windows.net/ or abs://<storage_account_name>.blob.core.windows.net/<container_name>	Dimulai dengan SQL Server 2022 (16.x) Namespace Hierarkis didukung.	Tanda Tangan Akses Bersama (SAS)
Azure Data Lake Storage Gen2	adls	adls://<container_name>@<storage_account_name>.dfs.core.windows.net/ or adls://<storage_account_name>.dfs.core.windows.net/<container_name>	Dimulai dengan SQL Server 2022 (16.x)	Tanda Tangan Akses Bersama (SAS)
SQL Server	sqlserver	<server_name>[\<instance_name>][:port]	Dimulai dengan SQL Server 2019 (15.x)	Autentikasi SQL saja
Oracle	oracle	<server_name>[:port]	Dimulai dengan SQL Server 2019 (15.x)	Autentikasi dasar saja
Teradata	teradata	<server_name>[:port]	Dimulai dengan SQL Server 2019 (15.x)	Autentikasi dasar saja
MongoDB atau Cosmos DB API untuk MongoDB	mongodb	<server_name>[:port]	Dimulai dengan SQL Server 2019 (15.x)	Autentikasi dasar saja
Konektivitas Database Terbuka Generik	odbc	<server_name>[:port]	Dimulai dengan SQL Server 2019 (15.x) - Hanya Windows	Autentikasi dasar saja
Operasi Massal	https	<storage_account>.blob.core.windows.net/<container>	Dimulai dengan SQL Server 2017 (14.x)	Tanda Tangan Akses Bersama (SAS)
Penyimpanan objek yang kompatibel dengan S3	s3	- Kompatibel dengan S3: s3://<server_name>:<port>/ - AWS S3: s3://<bucket_name>.S3.amazonaws.com[:port]/<folder> atau s3://s3.amazonaws.com[:port]/<bucket_name>/<folder>	Dimulai dengan SQL Server 2022 (16.x)	Dasar atau pass-through (STS) *

* Harus berupa kredensial tercakup database, di mana IDENTITY dikodekan secara IDENTITY = 'S3 Access Key' permanen dan argumen SECRET dalam format = '<AccessKeyID>:<SecretKeyID>' atau gunakan otorisasi pass-through (STS). Untuk informasi selengkapnya, lihat Mengonfigurasi PolyBase untuk mengakses data eksternal di penyimpanan objek yang kompatibel dengan S3.

Jalur lokasi:

• port = Port yang didengarkan sumber data eksternal. Opsional dalam banyak kasus, tergantung pada konfigurasi jaringan.
• <container_name> = kontainer akun penyimpanan yang menyimpan data. Kontainer root bersifat baca-saja, data tidak dapat ditulis kembali ke kontainer.
• <storage_account> = nama akun penyimpanan sumber daya Azure.
• <server_name> = nama host.
• <instance_name> = nama instans bernama SQL Server. Digunakan jika Anda memiliki SQL Server Browser Service yang berjalan pada instans target.
• <ip_address>:<port> = Hanya untuk penyimpanan objek yang kompatibel dengan S3 (dimulai dengan SQL Server 2022 (16.x)), titik akhir dan port yang digunakan untuk menyambungkan ke penyimpanan yang kompatibel dengan S3.
• <bucket_name> = Hanya untuk penyimpanan objek yang kompatibel dengan S3 (dimulai dengan SQL Server 2022 (16.x)), khusus untuk platform penyimpanan.
• <region> = Hanya untuk penyimpanan objek yang kompatibel dengan S3 (dimulai dengan SQL Server 2022 (16.x)), khusus untuk platform penyimpanan.
• <folder> = Bagian dari jalur penyimpanan dalam URL penyimpanan.

Catatan dan panduan tambahan saat mengatur lokasi:

• Mesin Database SQL Server tidak memverifikasi keberadaan sumber data eksternal saat objek dibuat. Untuk memvalidasi, buat tabel eksternal menggunakan sumber data eksternal.
• Anda dapat menggunakan sqlserver konektor untuk menyambungkan SQL Server 2019 (15.x) ke SQL Server lain atau ke Azure SQL Database.
• Tentukan Driver={<Name of Driver>} saat menyambungkan melalui ODBC.
• Opsi Namespace Hierarkis untuk Akun Penyimpanan Azure (V2) menggunakan awalan adls didukung melalui Azure Data Lake Storage Gen2 di SQL Server 2022 (16.x).

• Dukungan SQL Server untuk sumber data eksternal HDFS Cloudera (CDP) dan Hortonworks (HDP) dihentikan dan tidak termasuk dalam SQL Server 2022 (16.x). Tidak perlu menggunakan argumen TYPE di SQL Server 2022 (16.x).
• Untuk informasi selengkapnya tentang penyimpanan objek yang kompatibel dengan S3 dan PolyBase yang dimulai dengan SQL Server 2022 (16.x), lihat Mengonfigurasi PolyBase untuk mengakses data eksternal di penyimpanan objek yang kompatibel dengan S3. Untuk contoh kueri file parkek dalam penyimpanan objek yang kompatibel dengan S3, lihat Virtualisasi file parkek dalam penyimpanan objek yang kompatibel dengan S3 dengan PolyBase.
• Berbeda dari versi sebelumnya, di SQL Server 2022 (16.x), awalan yang digunakan untuk Akun Azure Storage (v2) berubah dari wasb[s] ke abs.
• Berbeda dari versi sebelumnya, di SQL Server 2022 (16.x), awalan yang digunakan untuk Azure Data Lake Storage Gen2 berubah dari abfs[s] ke adls.
• Untuk contoh menggunakan PolyBase untuk memvirtualisasi file CSV di Azure Storage, lihat Virtualisasi file CSV dengan PolyBase.
• Untuk contoh menggunakan PolyBase untuk memvirtualisasi tabel delta di ADLS Gen2, lihat Virtualisasi tabel delta dengan PolyBase.
• SQL Server 2022 (16.x) sepenuhnya mendukung dua format URL untuk Akun Azure Storage v2 (abs) dan Azure Data Lake Gen2 (adls).
  • Jalur LOCATION dapat menggunakan format: <container>@<storage_account_name>.. (disarankan) atau <storage_account_name>../<container>. Misalnya:
    • Akun Azure Storage v2: abs://<container>@<storage_account_name>.blob.core.windows.net (disarankan) atau abs://<storage_account_name>.blob.core.windows.net/<container>.
    • Azure Data Lake Gen2 mendukung: adls://<container>@<storage_account_name>.blob.core.windows.net (disarankan) atau adls://<storage_account_name>.dfs.core.windows.net/<container>.

CONNECTION_OPTIONS = key_value_pair

Ditentukan untuk SQL Server 2019 (15.x) dan yang lebih baru. Menentukan opsi tambahan saat menyambungkan ODBC ke sumber data eksternal. Untuk menggunakan beberapa opsi koneksi, pisahkan dengan titik koma.

Berlaku untuk koneksi generik ODBC , serta konektor bawaan ODBC untuk SQL Server, Oracle, Teradata, MongoDB, dan Azure Cosmos DB API untuk MongoDB.

key_value_pair adalah kata kunci dan nilai untuk opsi koneksi tertentu. Kata kunci dan nilai yang tersedia bergantung pada jenis sumber data eksternal. Nama driver diperlukan sebagai minimum, tetapi ada opsi lain seperti APP='<your_application_name>' atau ApplicationIntent= ReadOnly|ReadWrite yang juga berguna untuk diatur dan dapat membantu pemecahan masalah.

Pasangan nilai kunci yang mungkin khusus untuk driver. Untuk informasi selengkapnya untuk setiap penyedia, lihat MEMBUAT SUMBER DATA EKSTERNAL (Transact-SQL) CONNECTION_OPTIONS.

Mulai berlaku untuk: Pembaruan kumulatif SQL Server 2022 (16.x) 2, kata kunci tambahan diperkenalkan untuk mendukung file Oracle TNS:

• Kata kunci TNSNamesFile menentukan jalur file ke file yang tnsnames.ora terletak di server Oracle.
• Kata kunci ServerName menentukan alias yang digunakan di dalam tnsnames.ora yang akan digunakan untuk mengganti nama host dan port.

PUSHDOWN = AKTIF | OFF

Berlaku untuk: SQL Server 2019 (15.x) dan yang lebih baru. Menyatakan apakah komputasi dapat didorong ke sumber data eksternal. Ini aktif secara default.

PUSHDOWN didukung saat menyambungkan ke SQL Server, Oracle, Teradata, MongoDB, API Azure Cosmos DB untuk MongoDB, atau ODBC di tingkat sumber data eksternal.

Mengaktifkan atau menonaktifkan push-down di tingkat kueri dicapai melalui petunjuk.

INFO MASUK = credential_name

Menentukan kredensial cakupan database untuk mengautentikasi ke sumber data eksternal.

Catatan dan panduan tambahan saat membuat kredensial:

• CREDENTIAL hanya diperlukan jika data telah diamankan. CREDENTIAL tidak diperlukan untuk himpunan data yang memungkinkan akses anonim.
• Saat mengakses Akun Azure Storage (V2) atau Azure Data Lake Storage Gen2, IDENTITY harus SHARED ACCESS SIGNATURE.
  • Misalnya, lihat Membuat sumber data eksternal untuk menjalankan operasi massal dan mengambil data dari Azure Storage ke SQL Database.

Ada beberapa cara untuk membuat tanda tangan akses bersama:

• Anda dapat membuat token SAS dengan menavigasi ke portal Azure -><Your_Storage_Account> -> Tanda tangan akses bersama -> Mengonfigurasi izin -> Hasilkan SAS dan string koneksi. Untuk informasi selengkapnya, lihat Membuat tanda tangan akses bersama.

• Anda dapat membuat dan mengonfigurasi SAS dengan Azure Storage Explorer.

• Anda dapat membuat SAS secara terprogram melalui PowerShell, Azure CLI, .NET, dan REST API. Untuk informasi selengkapnya, lihat Berikan akses terbatas ke sumber daya Azure Storage menggunakan tanda tangan akses bersama (SAS).

• Token SAS harus dikonfigurasi sebagai berikut:

  • Ketika token SAS dihasilkan, token SAS menyertakan tanda tanya ('?') di awal token. Kecualikan yang terdepan ? saat dikonfigurasi sebagai SECRET.
  • Gunakan periode kedaluwarsa yang valid (semua tanggal dalam waktu UTC).
  • Berikan setidaknya izin baca pada file yang harus dimuat (misalnya srt=o&sp=r). Beberapa tanda tangan akses bersama dapat dibuat untuk kasus penggunaan yang berbeda. Izin harus diberikan sebagai berikut:

  Perbuatan	Izin
  Membaca data dari file	Read
  Membaca data dari beberapa file dan subfolder	Baca dan Daftar
  Gunakan Buat Tabel Eksternal sebagai Pilih (CETAS)	Baca, Buat, Cantumkan, dan Tulis

• Untuk Azure Blob Storage dan Azure Data Lake Gen 2:

  • Layanan yang diizinkan: Blob harus dipilih untuk menghasilkan token SAS
  • Jenis sumber daya yang diizinkan: Container dan Object harus dipilih untuk menghasilkan token SAS

Untuk contoh penggunaan CREDENTIAL dengan penyimpanan objek yang kompatibel dengan S3 dan PolyBase, lihat Mengonfigurasi PolyBase untuk mengakses data eksternal di penyimpanan objek yang kompatibel dengan S3.

Untuk membuat kredensial lingkup database, lihat MEMBUAT KREDENSIAL CAKUPAN DATABASE (Transact-SQL).

Izin

CONTROL Memerlukan izin pada database di SQL Server.

Penguncian

Mengambil kunci bersama pada EXTERNAL DATA SOURCE objek.

Keamanan

PolyBase mendukung autentikasi berbasis proksi untuk sebagian besar sumber data eksternal. Buat kredensial lingkup database untuk membuat akun proksi.

Tingkatkan ke SQL Server 2022

Mulai SQL Server 2022 (16.x), sumber data eksternal Hadoop tidak lagi didukung. Diperlukan untuk membuat ulang sumber data eksternal yang sebelumnya dibuat secara manual dengan TYPE = HADOOP, dan tabel eksternal apa pun yang menggunakan sumber data eksternal ini.

Pengguna juga perlu mengonfigurasi sumber data eksternal mereka untuk menggunakan konektor baru saat menyambungkan ke Azure Storage.

Sumber Data Eksternal	Dari	Untuk
Azure Blob Storage	wasb[s]	abs
ADLS Gen2	abfs[s]	adls

Contoh

Penting

Untuk informasi tentang cara menginstal dan mengaktifkan PolyBase, lihat Menginstal PolyBase di Windows

J. Membuat sumber data eksternal di SQL Server untuk mereferensikan Oracle

Untuk membuat sumber data eksternal yang mereferensikan Oracle, pastikan Anda memiliki kredensial lingkup database. Anda juga dapat secara opsional mengaktifkan atau menonaktifkan push-down komputasi terhadap sumber data ini.

-- Create a database master key if one does not already exist, using your own password.
-- This key is used to encrypt the credential secret in next step.
CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<password>';

-- Create a database scoped credential with Azure storage account key as the secret.
CREATE DATABASE SCOPED CREDENTIAL OracleProxyAccount
    WITH IDENTITY = 'oracle_username',
    SECRET = 'oracle_password';

CREATE EXTERNAL DATA SOURCE MyOracleServer
WITH (
    LOCATION = 'oracle://145.145.145.145:1521',
    CREDENTIAL = OracleProxyAccount,
    PUSHDOWN = ON
);

Secara opsional, sumber data eksternal ke Oracle dapat menggunakan autentikasi proksi untuk memberikan kontrol akses butir halus. Pengguna proksi dapat dikonfigurasi untuk memiliki akses terbatas dibandingkan dengan pengguna yang ditiru.

CREATE DATABASE SCOPED CREDENTIAL [OracleProxyCredential]
    WITH IDENTITY = 'oracle_username',
    SECRET = 'oracle_password';

CREATE EXTERNAL DATA SOURCE [OracleSalesSrvr]
WITH (
    LOCATION = 'oracle://145.145.145.145:1521',
    CONNECTION_OPTIONS = 'ImpersonateUser=%CURRENT_USER',
    CREDENTIAL = [OracleProxyCredential]
);

Atau, Anda dapat mengautentikasi menggunakan TNS.

Mulai berlaku untuk: SQL Server 2022 (16.x) Pembaruan Kumulatif 2, CREATE EXTERNAL DATA SOURCE sekarang mendukung penggunaan file TNS saat menyambungkan ke Oracle. Parameter CONNECTION_OPTIONS diperluas dan sekarang menggunakan TNSNamesFile dan ServerName sebagai variabel untuk menelusuri tnsnames.ora file dan membangun koneksi dengan server.

Dalam contoh di bawah ini, selama runtime SQL Server akan mencari tnsnames.ora lokasi file yang ditentukan oleh TNSNamesFile dan mencari host dan port jaringan yang ditentukan oleh ServerName.

CREATE EXTERNAL DATA SOURCE [external_data_source_name]
WITH (
    LOCATION = N'oracle://XE',
    CREDENTIAL = [OracleCredentialTest],
    CONNECTION_OPTIONS = N'TNSNamesFile=C:\Temp\tnsnames.ora;ServerName=XE'
);

B. Membuat sumber data eksternal untuk mereferensikan instans bernama SQL Server melalui konektivitas PolyBase

Berlaku untuk: SQL Server 2019 (15.x) dan yang lebih baru

Untuk membuat sumber data eksternal yang mereferensikan instans bernama SQL Server, gunakan CONNECTION_OPTIONS untuk menentukan nama instans.

Pertama, buat kredensial lingkup database, menyimpan kredensial untuk login terautentikasi SQL. Konektor ODBC SQL untuk PolyBase hanya mendukung autentikasi dasar. Sebelum Anda membuat kredensial lingkup database, database harus memiliki kunci master untuk melindungi kredensial. Untuk informasi selengkapnya, lihat MEMBUAT KUNCI MASTER. Contoh berikut membuat kredensial cakupan database, menyediakan login dan kata sandi Anda sendiri.

CREATE DATABASE SCOPED CREDENTIAL SQLServerCredentials
    WITH IDENTITY = 'username',
    SECRET = 'password';

Dalam contoh berikut, WINSQL2019 adalah nama host dan SQL2019 merupakan nama instans. 'Server=%s\SQL2019' adalah pasangan nilai kunci.

CREATE EXTERNAL DATA SOURCE SQLServerInstance2
WITH (
    LOCATION = 'sqlserver://WINSQL2019',
    CONNECTION_OPTIONS = 'Server=%s\SQL2019',
    CREDENTIAL = SQLServerCredentials
);

Atau, Anda dapat menggunakan port untuk menyambungkan ke instans default SQL Server.

CREATE EXTERNAL DATA SOURCE SQLServerInstance2
WITH (
    LOCATION = 'sqlserver://WINSQL2019:58137',
    CREDENTIAL = SQLServerCredentials
);

C. Membuat sumber data eksternal untuk mereferensikan replika sekunder grup ketersediaan AlwaysOn yang dapat dibaca

Berlaku untuk: SQL Server 2019 (15.x) dan yang lebih baru

Untuk membuat sumber data eksternal yang mereferensikan replika sekunder SQL Server yang dapat dibaca, gunakan CONNECTION_OPTIONS untuk menentukan ApplicationIntent=ReadOnly. Selain itu, Anda harus mengatur database ketersediaan seperti Database={dbname} dalam CONNECTION_OPTIONS, atau mengatur database ketersediaan sebagai database default login yang digunakan untuk kredensial cakupan database. Anda harus melakukan ini pada semua replika ketersediaan grup ketersediaan.

Pertama, buat kredensial lingkup database, menyimpan kredensial untuk login terautentikasi SQL. Konektor ODBC SQL untuk PolyBase hanya mendukung autentikasi dasar. Sebelum Anda membuat kredensial lingkup database, database harus memiliki kunci master untuk melindungi kredensial. Untuk informasi selengkapnya, lihat MEMBUAT KUNCI MASTER. Contoh berikut membuat kredensial cakupan database, menyediakan login dan kata sandi Anda sendiri.

CREATE DATABASE SCOPED CREDENTIAL SQLServerCredentials
    WITH IDENTITY = 'username',
    SECRET = 'password';

Selanjutnya, buat sumber data eksternal baru.

Apakah Anda menyertakan Database=dbname atau CONNECTION_OPTIONS mengatur database ketersediaan sebagai database default untuk masuk dalam kredensial lingkup database, Anda masih harus memberikan nama database melalui nama tiga bagian dalam pernyataan CREATE EXTERNAL TABLE, dalam parameter LOCATION. Misalnya, lihat MEMBUAT TABEL EKSTERNAL.

Dalam contoh berikut, WINSQL2019AGL adalah nama pendengar grup ketersediaan dan dbname merupakan nama database yang akan menjadi target pernyataan CREATE EXTERNAL TABLE.

CREATE EXTERNAL DATA SOURCE SQLServerInstance2
WITH (
    LOCATION = 'sqlserver://WINSQL2019AGL',
    CONNECTION_OPTIONS = 'ApplicationIntent=ReadOnly; Database=dbname',
    CREDENTIAL = SQLServerCredentials
);

Anda dapat menunjukkan perilaku pengalihan grup ketersediaan dengan menentukan ApplicationIntent dan membuat tabel eksternal pada tampilan sys.serverssistem . Dalam contoh skrip berikut, dua sumber data eksternal dibuat, dan satu tabel eksternal dibuat untuk masing-masing. Gunakan tampilan untuk menguji server mana yang merespons koneksi. Hasil serupa juga dapat dicapai melalui fitur perutean baca-saja. Untuk informasi selengkapnya, lihat Mengonfigurasi perutean baca-saja untuk grup ketersediaan AlwaysOn.

CREATE EXTERNAL DATA SOURCE [DataSource_SQLInstanceListener_ReadOnlyIntent]
WITH (
    LOCATION = 'sqlserver://WINSQL2019AGL',
    CONNECTION_OPTIONS = 'ApplicationIntent=ReadOnly; Database=dbname',
    CREDENTIAL = [SQLServerCredentials]
);
GO

CREATE EXTERNAL DATA SOURCE [DataSource_SQLInstanceListener_ReadWriteIntent]
WITH (
    LOCATION = 'sqlserver://WINSQL2019AGL',
    CONNECTION_OPTIONS = 'ApplicationIntent=ReadWrite',
    CREDENTIAL = [SQLServerCredentials]
);
GO

Di dalam database dalam grup ketersediaan, buat tampilan untuk dikembalikan sys.servers dan nama instans lokal, yang membantu Anda mengidentifikasi replika mana yang merespons kueri. Untuk informasi selengkapnya, lihat sys.servers.

CREATE VIEW vw_sys_servers
AS
SELECT [name]
FROM sys.servers
WHERE server_id = 0;
GO

Kemudian, buat tabel eksternal pada instans sumber:

CREATE EXTERNAL TABLE vw_sys_servers_ro (name SYSNAME NOT NULL)
WITH (
    DATA_SOURCE = [DataSource_SQLInstanceListener_ReadOnlyIntent],
    LOCATION = N'dbname.dbo.vw_sys_servers'
);
GO

CREATE EXTERNAL TABLE vw_sys_servers_rw (name SYSNAME NOT NULL)
WITH (
    DATA_SOURCE = [DataSource_SQLInstanceListener_ReadWriteIntent],
    LOCATION = N'dbname.dbo.vw_sys_servers'
);
GO

SELECT [name]
FROM dbo.vw_sys_servers_ro;--should return secondary replica instance

SELECT [name]
FROM dbo.vw_sys_servers_rw;--should return primary replica instance
GO

D. Membuat sumber data eksternal untuk mengkueri file parkek di penyimpanan objek yang kompatibel dengan S3 melalui PolyBase

Berlaku untuk: SQL Server 2022 (16.x) dan yang lebih baru

Contoh skrip berikut membuat sumber s3_ds data eksternal di database pengguna sumber di SQL Server. Sumber data eksternal mereferensikan s3_dc kredensial cakupan database.

CREATE DATABASE SCOPED CREDENTIAL s3_dc
    WITH IDENTITY = 'S3 Access Key', -- for S3-compatible object storage the identity must always be S3 Access Key
    SECRET = '<access_key_id>:<secret_key_id>' -- provided by the S3-compatible object storage
GO

CREATE EXTERNAL DATA SOURCE s3_ds
WITH (
    LOCATION = 's3://<ip_address>:<port>/',
    CREDENTIAL = s3_dc
);
GO

Verifikasi sumber data eksternal baru dengan sys.external_data_sources.

SELECT * FROM sys.external_data_sources;

Kemudian, contoh berikut menunjukkan penggunaan T-SQL untuk mengkueri file parket yang disimpan dalam penyimpanan objek yang kompatibel dengan S3 melalui kueri OPENROWSET. Untuk informasi selengkapnya, lihat Virtualisasi file parkek di penyimpanan objek yang kompatibel dengan S3 dengan PolyBase.

SELECT *
FROM OPENROWSET (
    BULK '/<bucket>/<parquet_folder>',
    FORMAT = 'PARQUET',
    DATA_SOURCE = 's3_ds'
) AS [cc];

E. Membuat sumber data eksternal menggunakan ODBC generik ke PostgreSQL

Seperti dalam contoh sebelumnya, pertama-tama buat kunci master database dan kredensial cakupan database. Kredensial cakupan database akan digunakan untuk sumber data eksternal. Contoh ini juga mengasumsikan bahwa penyedia data ODBC generik untuk PostgreSQL diinstal di server.

Dalam contoh ini, penyedia data ODBC generik digunakan untuk menyambungkan ke server database PostgreSQL di jaringan yang sama, di mana nama domain server PostgreSQL yang sepenuhnya memenuhi syarat adalah POSTGRES1, menggunakan port default TCP 5432.

CREATE EXTERNAL DATA SOURCE POSTGRES1
WITH (
    LOCATION = 'odbc://POSTGRES1.domain:5432',
    CONNECTION_OPTIONS = 'Driver={PostgreSQL Unicode(x64)};',
    CREDENTIAL = postgres_credential
);

Azure Storage

Buat tanda tangan akses bersama

Untuk Azure Blob Storage dan Azure Data Lake Gen2, metode autentikasi yang didukung adalah tanda tangan akses bersama (SAS). Salah satu cara sederhana untuk menghasilkan token tanda tangan akses bersama mengikuti langkah-langkah berikut. Untuk informasi selengkapnya, lihat INFO MASUK.

1. Navigasikan ke portal Azure, dan Akun Penyimpanan yang diinginkan.
2. Navigasi ke Kontainer yang Anda inginkan di bawah menu Penyimpanan Data.
3. Pilih Token akses bersama.
4. Pilih izin yang sesuai berdasarkan tindakan yang diinginkan, untuk referensi gunakan tabel bellow:

Perbuatan	Izin
Membaca data dari file	Read
Membaca data dari beberapa file dan subfolder	Baca dan Daftar
Gunakan Buat Tabel Eksternal sebagai Pilih (CETAS)	Baca, Buat, dan Tulis

5. Pilih tanggal kedaluwarsa token.
6. Hasilkan token dan URL SAS.
7. Salin token SAS.

F. Membuat sumber data eksternal untuk mengakses data di Azure Blob Storage menggunakan antarmuka abs://

Berlaku untuk: SQL Server 2022 (16.x) dan yang lebih baru

Mulai SQL Server 2022 (16.x), gunakan awalan abs baru untuk Akun Azure Storage v2. abs Awalan mendukung autentikasi menggunakan SHARED ACCESS SIGNATURE. abs Awalan wasbmenggantikan , digunakan dalam versi sebelumnya. HADOOP tidak lagi didukung, tidak perlu lagi menggunakan TYPE = BLOB_STORAGE.

Kunci akun penyimpanan Azure tidak lagi diperlukan, sebagai gantinya menggunakan Token SAS seperti yang dapat kita lihat dalam contoh berikut:

-- Create a database master key if one does not already exist, using your own password.
-- This key is used to encrypt the credential secret in next step.
CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<password>';
GO

CREATE DATABASE SCOPED CREDENTIAL AzureStorageCredentialv2
    WITH IDENTITY = 'SHARED ACCESS SIGNATURE', -- to use SAS the identity must be fixed as-is
    SECRET = '<Blob_SAS_Token>';
GO

-- Create an external data source with CREDENTIAL option.
CREATE EXTERNAL DATA SOURCE MyAzureStorage
WITH (
    LOCATION = 'abs://<container>@<storage_account_name>.blob.core.windows.net/',
    CREDENTIAL = AzureStorageCredentialv2,
);

Untuk contoh yang lebih rinci tentang cara mengakses file CSV yang disimpan di Azure Blob Storage, lihat Virtualisasi file CSV dengan PolyBase.

G. Membuat sumber data eksternal untuk mengakses data di Azure Data Lake Gen2

Berlaku untuk: SQL Server 2022 (16.x) dan versi yang lebih baru

Mulai SQL Server 2022 (16.x), gunakan awalan adls baru untuk Azure Data Lake Gen2, menggantikan abfs yang digunakan dalam versi sebelumnya. adls Awalan juga mendukung token SAS sebagai metode autentikasi seperti yang ditunjukkan dalam contoh ini:

--Create a database scoped credential using SAS Token
CREATE DATABASE SCOPED CREDENTIAL datalakegen2
    WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
    SECRET = '<DataLakeGen2_SAS_Token>';
GO

CREATE EXTERNAL DATA SOURCE data_lake_gen2_dfs
WITH (
    LOCATION = 'adls://<container>@<storage_account>.dfs.core.windows.net',
    CREDENTIAL = datalakegen2
);

Untuk contoh yang lebih rinci tentang cara mengakses file delta yang disimpan di Azure Data Lake Gen2, lihat Virtualisasi tabel delta dengan PolyBase.

Contoh: Operasi Massal

Penting

Jangan tambahkan /parameter tanda tangan akses berikutnya, nama file, atau tanda tangan akses bersama di akhir LOCATION URL saat mengonfigurasi sumber data eksternal untuk operasi massal.

H. Membuat sumber data eksternal untuk operasi massal yang mengambil data dari Azure Storage

Berlaku untuk: SQL Server 2022 (16.x) dan yang lebih baru.

Gunakan sumber data berikut untuk operasi massal menggunakan BULK INSERT atau OPENROWSET. Kredensial harus ditetapkan SHARED ACCESS SIGNATURE sebagai identitas, tidak boleh memiliki yang terdepan ? dalam token SAS, harus memiliki setidaknya izin baca pada file yang harus dimuat (misalnya srt=o&sp=r), dan periode kedaluwarsa harus valid (semua tanggal dalam waktu UTC). Untuk informasi selengkapnya tentang tanda tangan akses bersama, lihat Menggunakan Tanda Tangan Akses Bersama (SAS).

CREATE DATABASE SCOPED CREDENTIAL AccessAzureInvoices
WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
    -- Remove ? from the beginning of the SAS token
    SECRET = '<azure_shared_access_signature>';

CREATE EXTERNAL DATA SOURCE MyAzureInvoices
WITH (
    LOCATION = 'abs://<container>@<storage_account_name>.blob.core.windows.net/',
    CREDENTIAL = AccessAzureInvoices,
);

Langkah berikutnya

• UBAH SUMBER DATA EKSTERNAL (Transact-SQL)
• MEMBUAT KREDENSIAL CAKUPAN DATABASE (Transact-SQL)
• BUAT FORMAT FILE EKSTERNAL (TRANSACT-SQL)
• BUAT TABEL EKSTERNAL (Transact-SQL)
• sys.external_data_sources (T-SQL)
• Menggunakan Tanda Tangan Akses Bersama (SAS)
• Konfigurasi Konektivitas PolyBase