HARICI VERI KAYNAĞI OLUŞTUR (Transact-SQL)

Şunlar için geçerlidir: SQL Server 2016 (13.x) ve sonraki sürümleri Azure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsAnalytics Platform Sistemi (PDW)Microsoft Fabric'teki Microsoft Fabric SQL veritabanındaKi Microsoft FabricAmbarı'ndakiSQL analiz uç noktası

PolyBase ve veri sanallaştırma özellikleri için kullanılan dış verileri sorgulamak için bir dış veri kaynağı oluşturur.

Bu makalede, seçtiğiniz SQL ürünü için söz dizimi, bağımsız değişkenler, açıklamalar, izinler ve örnekler sağlanır.

Ürün seçin

Aşağıdaki satırda, ilgilendiğiniz ürün adını seçin ve yalnızca bu ürünün bilgileri görüntülenir.

* SQL Server *  

Azure SQL Veritabanı

SQL Yönetilen
Örnek

Azure Synapse'i
Analiz

Analytics Platformu
Sistem (PDW)

Microsoft Fabric Veri Ambarı

Microsoft Fabric SQL veritabanı

 

Genel Bakış: SQL Server 2025

Uygulanır: SQL Server 2025 (17.x)

PolyBase sorguları için bir dış veri kaynağı oluşturur. Dış veri kaynakları, bağlantı kurmak ve şu birincil kullanım örneklerini desteklemek için kullanılır:

• SQL Server'da PolyBase kullanarak veri sanallaştırma ve veri yükü
• veya kullanarak BULK INSERT toplu yükleme işlemleri OPENROWSET

Azure Arc tarafından etkinleştirilen örnekler için Yönetilen Kimlik bağlantılarını destekler. Detaylar için PolyBase'ten yönetilen kimlik ile Azure Storage'a Connect programını inceleyin.

Uyarı

Bu söz dizimi SQL Server'ın farklı sürümlerinde farklılık gösterir. Uygun sürümü seçmek için sürüm seçici açılan listesini kullanın. Bu içerik, SQL Server 2025 (17.x) ve sonraki sürümler için geçerlidir.

SQL Server 2025 ve sonraki sürümleri için söz dizimi

Söz dizimi kuralları hakkında daha fazla bilgi için bkz.Transact-SQL söz dizimi kuralları.

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

Tartışmalar

data_source_name

Veri kaynağı için kullanıcı tanımlı adı belirtir. Ad, SQL Server'daki veritabanında benzersiz olmalıdır.

LOCATION = '<prefix>://<path[:p ort]>'

Bağlantı protokolunu ve dış veri kaynağının yolunu sağlar.

Dış veri kaynağı	Bağlayıcı konumu ön eki	Konum yolu	Ürüne/hizmete göre desteklenen konumlar	Kimlik doğrulama
Azure Depolama Hesabı (V2)	abs	abs://<container_name>@<storage_account_name>.blob.core.windows.net/ veya abs://<storage_account_name>.blob.core.windows.net/<container_name>	SQL Server 2022 (16.x) ile başlayarak Hiyerarşik Ad Alanı desteklenir.	Paylaşılan erişim imzası (SAS) veya Azure Depolama 1'e Yönetilen Kimlik için PolyBase desteği
Azure Data Lake Storage (İkinci Nesil)	adls	adls://<container_name>@<storage_account_name>.dfs.core.windows.net/ veya adls://<storage_account_name>.dfs.core.windows.net/<container_name>	SQL Server 2022 (16.x) ile başlayarak	Paylaşılan erişim imzası (SAS) veya Azure Depolama 1'e Yönetilen Kimlik için PolyBase desteği
SQL Sunucusu	sqlserver	<server_name>[\<instance_name>][:port]	SQL Server 2019 (15.x) ile başlayarak	Yalnızca SQL kimlik doğrulaması
Oracle	oracle	<server_name>[:port]	SQL Server 2019 (15.x) ile başlayarak	Yalnızca temel kimlik doğrulaması
Teradata	teradata	<server_name>[:port]	SQL Server 2019 (15.x) ile başlayarak	Yalnızca temel kimlik doğrulaması
MongoDB için MongoDB veya Cosmos DB API'si	mongodb	<server_name>[:port]	SQL Server 2019 (15.x) ile başlayarak	Yalnızca temel kimlik doğrulaması
Genel ODBC	odbc	<server_name>[:port]	SQL Server 2019 (15.x) ile başlayarak - Yalnızca Windows	Yalnızca temel kimlik doğrulaması
Toplu İşlemler	https	<storage_account>.blob.core.windows.net/<container>	SQL Server 2017 'den (14.x) başlayarak	Paylaşılan erişim imzası (SAS)
S3 uyumlu nesne depolama	s3	- S3 uyumlu: s3://<server_name>:<port>/ - AWS S3: s3://<bucket_name>.S3.amazonaws.com[:port]/<folder> veya s3://s3.amazonaws.com[:port]/<bucket_name>/<folder>	SQL Server 2022 (16.x) ile başlayarak	Temel veya geçişli (STS) 2

¹ Azure Arc tarafından etkinleştirilmiş SQL Server 2025 (17.x) örneği gerektirir. Detaylar için PolyBase'ten yönetilen kimlik ile Azure Storage'a Connect programını inceleyin.

² Veritabanı kapsamlı bir kimlik bilgisi olmalıdır; burada IDENTITY sabit kodlanır IDENTITY = 'S3 Access Key' ve SECRET bağımsız değişken biçimindedir = '<AccessKeyID>:<SecretKeyID>' veya geçiş (STS) yetkilendirmesini kullanır. Daha fazla bilgi için bkz. PolyBase'i S3 uyumlu nesne depolama alanında dış verilere erişecek şekilde yapılandırma.

Konum yolu:

Konum yolu	Açıklama
port	Dış veri kaynağının dinlediği bağlantı noktası. Çoğu durumda, ağ yapılandırmasına bağlı olarak isteğe bağlıdır.
<container_name>	Verileri tutan depolama hesabının kapsayıcısı. Kök kapsayıcılar salt okunur durumdadır, veriler kapsayıcıya geri yazılamaz.
<storage_account>	Azure kaynağının depolama hesabı adı.
<server_name>	Ana bilgisayar adı.
<instance_name>	SQL Server adlı örneğin adı. Hedef örnekte çalışan SQL Server Tarayıcı Hizmetiniz varsa kullanılır.
<ip_address>:<port> 1	Yalnızca S3 uyumlu nesne depolaması için, S3 uyumlu depolamaya bağlanmak için kullanılan uç nokta ve bağlantı noktası.
<bucket_name> 1	Yalnızca S3 uyumlu nesne depolaması için, depolama platformuna özgü.
<region> 1	Yalnızca S3 uyumlu nesne depolaması için, depolama platformuna özgü.
<folder>	Depolama URL'si içindeki depolama yolunun bir parçası.

¹ SQL Server 2022 (16.x) ve sonraki sürümleri.

Konumu ayarlarken ek notlar ve yönergeler:

• SQL Server Veritabanı Altyapısı, nesne oluşturulduğunda dış veri kaynağının varlığını doğrulamaz. Doğrulamak için dış veri kaynağını kullanarak bir dış tablo oluşturun.

• BAĞLAYıCıyı sqlserver kullanarak SQL Server 2019'u (15.x) başka bir SQL Server'a veya Azure SQL Veritabanı'na bağlayabilirsiniz.

• aracılığıyla Driver={<Name of Driver>}bağlanırken değerini ODBC belirtin.

• Ön ekini adls kullanan Azure Depolama Hesapları (V2) için Hiyerarşik Ad Alanı seçeneği, SQL Server 2022 (16.x) ve sonraki sürümlerde Azure Data Lake Storage 2. Nesil aracılığıyla desteklenir.

• HDFS Cloudera (CDP) ve Hortonworks (HDP) dış veri kaynakları için SQL Server desteği kullanımdan kaldırılmıştır ve SQL Server 2022 (16.x) ve sonraki sürümlere dahil değildir. SQL Server 2025 (17.x)'de argümanı TYPE kullanmaya gerek yok.

• SQL Server 2022 (16.x) ve sonraki sürümlerde S3 uyumlu nesne depolama ve PolyBase hakkında daha fazla bilgi için bkz. PolyBase'i S3 uyumlu nesne depolamadaki dış verilere erişecek şekilde yapılandırma. S3 uyumlu nesne depolama alanında bir parquet dosyasını sorgulama örneği için bkz. PolyBase ile S3 uyumlu nesne depolama alanında parquet dosyasını sanallaştırma.

SQL Server 2022 (16.x) ve sonraki sürümlerde:

• Azure Depolama Hesabı (v2) için kullanılan ön ek olarak wasb[s] değiştirildi abs

• Azure Data Lake Storage 2. Nesil için kullanılan ön ek olarak abfs[s] değiştirildi adls

• Azure Depolama'da bir CSV dosyasını sanallaştırmak için PolyBase'i kullanma örneği için bkz. PolyBase ile CSV dosyasını sanallaştırma.

• ADLS 2. Nesil'de delta tablosunu sanallaştırmak için PolyBase kullanma örneği için bkz. PolyBase ile delta tablosunu sanallaştırma.

• SQL Server 2022 (16.x) ve sonraki sürümleri hem Azure Depolama Hesabı v2 () hem de Azure Data Lake 2. Nesil (absadls) için iki URL biçimini tam olarak destekler.

  • Yol LOCATION şu biçimleri kullanabilir: <container>@<storage_account_name>.. (önerilen) veya <storage_account_name>../<container>. Örneğin:

    • Azure Depolama Hesabı v2: abs://<container>@<storage_account_name>.blob.core.windows.net (önerilen) veya abs://<storage_account_name>.blob.core.windows.net/<container>.

• Azure Data Lake 2. Nesil şu desteği destekler: adls://<container>@<storage_account_name>.blob.core.windows.net (önerilen) veya adls://<storage_account_name>.dfs.core.windows.net/<container>.

CONNECTION_OPTIONS = key_value_pair

için geçerlidir: SQL Server 2019 (15.x) ve sonraki sürümler.

Dış veri kaynağına bağlanırken ODBC ek seçenekleri belirtir. Birden çok bağlantı seçeneği kullanmak için bunları noktalı virgülle ayırın.

Genel ODBC bağlantıların yanı sıra SQL Server, Oracle, Teradata, MongoDB ve MongoDB için Azure Cosmos DB API'sine ODBC yönelik yerleşik bağlayıcılar için geçerlidir.

key_value_pair, belirli bir bağlantı seçeneğinin anahtar sözcüğü ve değeridir. Kullanılabilir anahtar sözcükler ve değerler dış veri kaynağı türüne bağlıdır. Sürücünün adı en düşük değer olarak gereklidir, ancak veya gibi APP='<your_application_name>'ApplicationIntent= ReadOnly|ReadWrite ayarlamak için de yararlı olan ve sorun gidermeye yardımcı olabilecek başka seçenekler de vardır.

Olası anahtar değer çiftleri sürücüye özgüdür. Her sağlayıcı hakkında daha fazla bilgi için bkz. CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS.

SQL Server 2022 (16.x) Toplu Güncelleştirme 2'den başlayarak, Oracle TNS dosyalarını desteklemek için ek anahtar sözcükler kullanıma sunulmuştur:

• anahtar sözcüğü TNSNamesFile , Oracle sunucusunda bulunan dosyanın dosya yolu tnsnames.ora belirtir.
• anahtar sözcüğü ServerName , içinde konak tnsnames.ora adını ve bağlantı noktasını değiştirmek için kullanılacak diğer adı belirtir.

SQL Server 2025'te şifreleme seçenekleri (17.x)

SQL Server 2025 (17.x) ile itibaren, veri kaynağı olarak kullanıldığında sqlserver , SQL Server için Microsoft ODBC Driver sürüm 18 varsayılan sürücüdür. Bu Encryption seçenek gereklidir (Yes, No, veya Strict) ve TrustServerCertificate kullanılabilir (Yes veya No). Belirtilmezse Encryption , varsayılan davranış şeklindedir Encrypt=Yes;TrustServerCertificate=No;ve bir sunucu sertifikası gerektirir.

TDS 8.0 protokolunu kullanarak bağlanmak için katı mod (Encrypt=Strict) eklenmiştir. Bu modda, güvenilen bir sunucu sertifikasının yüklenmesi gerekir ve her zaman doğrulanır (TrustServerCertificate yoksayılır). Yeni bir anahtar sözcük olan , HostnameInCertificatebelirtilen sunucudan farklıysa sertifikada bulunan beklenen konak adını belirtmek için kullanılabilir. HostnameInCertificatetüm şifreleme modlarında kullanılabilir ve sunucu tarafı Şifrelemeyi Zorla seçeneği etkinse de geçerlidir. Bu seçenek, kullanılarak devre dışı bırakılmadığı sürece sürücünün İsteğe bağlı veya TrustServerCertificate modlarda sertifikayı doğrulamasına neden olur.

Seçenekler, sunucu sertifikaları ve Encryptionhakkında TrustServerCertificate daha fazla bilgi için bkz. Windows üzerinde SQL Server için Microsoft ODBC Sürücüsünün Özellikleri.

Her zaman en son sürücüyü kullanmalısınız. Ancak, SQL Server 2025 (17.x) ayrıca geriye dönük uyumluluk için SQL Server için Microsoft ODBC Driver sürüm 17'yi de destekler. PolyBase tarafından kullanılan sürücü sürümünü değiştirme hakkında daha fazla bilgi için bkz. PolyBase için SQL Server sürücü sürümünü değiştirme.

PUSHDOWN = ON | KAPALI

için geçerlidir: SQL Server 2019 (15.x) ve sonraki sürümler.

Hesaplamanın dış veri kaynağına gönderilip gönderilemeyeceğini belirtir. Varsayılan olarak etkindir.

PUSHDOWN SQL Server, Oracle, Teradata, MongoDB, MongoDB için Azure Cosmos DB API'sine veya dış veri kaynağı düzeyinde ODBC'ye bağlanırken desteklenir.

Sorgu düzeyinde aşağı göndermeyi etkinleştirme veya devre dışı bırakma işlemi bir ipucu aracılığıyla oluşturulduğunda elde edilir.

CREDENTIAL = credential_name

Dış veri kaynağında kimlik doğrulaması için veritabanı kapsamlı bir kimlik bilgisi belirtir.

Kimlik bilgisi oluştururken ek notlar ve yönergeler:

• CREDENTIAL yalnızca verilerin güvenliği sağlanmışsa gereklidir. CREDENTIAL anonim erişime izin veren veri kümeleri için gerekli değildir.

• Azure Depolama Hesabına (V2) veya Azure Data Lake Storage 2. Nesil'e erişirken, olması IDENTITYSHARED ACCESS SIGNATUREgerekir.

• Örnek için bkz. Toplu işlemleri yürütmek ve Azure Depolama'dan SQL Veritabanı'na veri almak için dış veri kaynağı oluşturma.

Paylaşılan erişim imzası oluşturmanın birden çok yolu vardır:

• Paylaşılanerişim imzası><>SAS ve bağlantı dizesi oluşturma>> giderek SAS belirteci oluşturabilirsiniz. Daha fazla bilgi için bkz . Paylaşılan erişim imzası oluşturma.

• Azure Depolama Gezgini ile SAS oluşturabilir ve yapılandırabilirsiniz.

• Sas belirtecini PowerShell, Azure CLI, .NET ve REST API aracılığıyla program aracılığıyla oluşturabilirsiniz. Daha fazla bilgi için bkz . Paylaşılan erişim imzalarını (SAS) kullanarak Azure Depolama kaynaklarına sınırlı erişim verme.

• SAS belirteci aşağıdaki gibi yapılandırılmalıdır:

  • SAS belirteci oluşturulduğunda belirtecin başında bir soru işareti ('?') bulunur. olarak yapılandırıldığında baştakileri ?SECREThariç tutun.

  • Geçerli bir süre sonu dönemi kullanın (tüm tarihler UTC saatindedir).

• Yüklenmesi gereken dosya üzerinde en azından okuma izni verin (örneğin srt=o&sp=r). Farklı kullanım örnekleri için birden çok paylaşılan erişim imzası oluşturulabilir. İzinler aşağıdaki gibi verilmelidir:

  Eylem	İzin
  Dosyadan veri okuma	Okumak
  Birden çok dosyadan ve alt klasörden veri okuma	Okuma ve Listeleme
  Dış Tablo Oluştur'u Seç Olarak Kullanma (CETAS)	Okuma, Oluşturma, Listeleme ve Yazma

• Azure Blob Depolama ve Azure Data Lake 2. Nesil için:

  • İzin verilen hizmetler: Blob SAS belirtecini oluşturmak için seçilmelidir

• İzin verilen kaynak türleri: Container ve Object SAS belirtecini oluşturmak için seçilmelidir

S3 uyumlu nesne depolama ve PolyBase ile kullanma CREDENTIAL örneği için bkz. PolyBase'i S3 uyumlu nesne depolama alanında dış verilere erişecek şekilde yapılandırma.

Veritabanı kapsamlı kimlik bilgileri oluşturmak için bkz. CREATE DATABASE SCOPED CREDENTIAL.

İzinler

CONTROL SQL Server'daki veritabanında izin gerektirir.

Kilitleme

Nesne üzerinde EXTERNAL DATA SOURCE paylaşılan bir kilit alır.

Güvenlik

PolyBase, dış veri kaynaklarının çoğu için ara sunucu tabanlı kimlik doğrulamasını destekler. Proxy hesabını oluşturmak için veritabanı kapsamlı bir kimlik bilgisi oluşturun.

SQL Server 2025'e yükseltme

SQL Server 2022 (16.x) ve sonraki sürümlerinde Hadoop dış veri kaynakları desteklenmez. Daha önce ile TYPE = HADOOPoluşturulan dış veri kaynaklarını ve bu dış veri kaynağını kullanan tüm dış tabloları el ile yeniden oluşturmak gerekir.

Kullanıcıların Azure Depolama'ya bağlanırken yeni bağlayıcıları kullanacak şekilde dış veri kaynaklarını da yapılandırmaları gerekir.

Dış veri kaynağı	Kaynak	İçin
Azure Blob Saklama Alanı	wasb[s]	Karın kasları
ADLS 2. Nesil	abfs[s]	adls

Örnekler

Önemli

PolyBase'i yükleme ve etkinleştirme hakkında bilgi için bkz. Windows'a PolyBase yükleme.

A. Oracle'a başvurmak için SQL Server'da dış veri kaynağı oluşturma

Oracle'a başvuran bir dış veri kaynağı oluşturmak için veritabanı kapsamlı bir kimlik bilgileriniz olduğundan emin olun. Ayrıca, isteğe bağlı olarak bu veri kaynağında hesaplamanın aşağı itilmesi özelliğini etkinleştirebilir veya devre dışı bırakabilirsiniz.

-- 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',
    PUSHDOWN = ON,
    CREDENTIAL = OracleProxyAccount
);

İsteğe bağlı olarak, Oracle'a dış veri kaynağı ayrıntılı erişim denetimi sağlamak için ara sunucu kimlik doğrulamasını kullanabilir. Ara sunucu kullanıcısı, kimliğine bürünülen kullanıcıyla karşılaştırıldığında sınırlı erişime sahip olacak şekilde yapılandırılabilir.

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

Alternatif olarak, TNS kullanarak kimlik doğrulaması yapabilirsiniz.

SQL Server 2022 (16.x) Toplu Güncelleştirme 2'den başlayarak, CREATE EXTERNAL DATA SOURCE artık Oracle'a bağlanırken TNS dosyalarının kullanımını destekliyor.

CONNECTION_OPTIONS parametresi genişletildi ve şimdi dosyaya TNSNamesFile göz atmak ServerName ve sunucuyla bağlantı kurmak için ve değişken olarak ve kullanıyortnsnames.ora.

Aşağıdaki örnekte, çalışma zamanı sırasında SQL Server tnsnames.ora tarafından TNSNamesFile belirtilen dosya konumunu ve tarafından ServerNamebelirtilen konak ve ağ bağlantı noktasını arar.

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. PolyBase bağlantısı aracılığıyla örnek adlı bir SQL Server'a başvurmak için dış veri kaynağı oluşturma

Şunlar için geçerlidir: SQL Server 2019 (15.x) ve sonraki sürümleri.

SQL Server'ın adlandırılmış bir örneğine başvuran bir dış veri kaynağı oluşturmak için örnek adını belirtmek için kullanın CONNECTION_OPTIONS .

İlk olarak, SQL kimliği doğrulanmış oturum açma bilgileri için kimlik bilgilerini depolayarak veritabanı kapsamlı kimlik bilgilerini oluşturun. PolyBase için SQL ODBC Bağlayıcısı yalnızca temel kimlik doğrulamasını destekler. Veritabanı kapsamlı bir kimlik bilgisi oluşturmadan önce, veritabanının kimlik bilgilerini korumak için bir ana anahtarı olmalıdır. Daha fazla bilgi için bkz. CREATE MASTER KEY . Aşağıdaki örnek, veritabanı kapsamlı bir kimlik bilgisi oluşturur, kendi oturum açma bilgilerinizi ve parolanızı sağlar.

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

Aşağıdaki örnekte konak WINSQL2019 adı ve SQL2019 örnek adıdır. 'Server=%s\SQL2019' anahtar değer çiftidir.

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

Alternatif olarak, sql server varsayılan örneğine bağlanmak için bir bağlantı noktası kullanabilirsiniz.

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

C. Always On kullanılabilirlik grubunun okunabilir ikincil çoğaltmasına başvurmak için dış veri kaynağı oluşturma

Şunlar için geçerlidir: SQL Server 2019 (15.x) ve sonraki sürümleri.

SQL Server'ın okunabilir ikincil çoğaltmasına başvuran bir dış veri kaynağı oluşturmak için öğesini CONNECTION_OPTIONS kullanarak belirtin ApplicationIntent=ReadOnly. Buna ek olarak, kullanılabilirlik veritabanını içinde Database={dbname}olarak CONNECTION_OPTIONS ayarlamanız veya kullanılabilirlik veritabanını, veritabanı kapsamlı kimlik bilgileri için kullanılan oturum açma bilgilerinin varsayılan veritabanı olarak ayarlamanız gerekir. Bunu kullanılabilirlik grubunun tüm kullanılabilirlik çoğaltmalarında yapmanız gerekir.

İlk olarak, SQL kimliği doğrulanmış oturum açma bilgileri için kimlik bilgilerini depolayarak veritabanı kapsamlı kimlik bilgilerini oluşturun. PolyBase için SQL ODBC Bağlayıcısı yalnızca temel kimlik doğrulamasını destekler. Veritabanı kapsamlı bir kimlik bilgisi oluşturmadan önce, veritabanının kimlik bilgilerini korumak için bir ana anahtarı olmalıdır. Daha fazla bilgi için bkz. CREATE MASTER KEY . Aşağıdaki örnek, veritabanı kapsamlı bir kimlik bilgisi oluşturur, kendi oturum açma bilgilerinizi ve parolanızı sağlar.

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

Ardından yeni dış veri kaynağını oluşturun.

veritabanı kapsamlı kimlik bilgilerindeki Database=dbname oturum açma bilgileri için kullanılabilirlik veritabanını varsayılan veritabanı olarak dahil CONNECTION_OPTIONS etmeniz veya ayarlamanız fark etmeksizin, LOCATION parametresinde CREATE EXTERNAL TABLE deyiminde veritabanı adını üç parçalı bir adla sağlamanız gerekir. Örnek için bkz . EXTERNAL TABLE OLUŞTURMA.

Aşağıdaki örnekte kullanılabilirlik WINSQL2019AGL grubu dinleyici adı ve dbname CREATE EXTERNAL TABLE deyiminin hedefi olacak veritabanının adıdır.

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

Sistem görünümünde ApplicationIntentbir dış tablo belirtip sys.servers oluşturarak kullanılabilirlik grubunun yeniden yönlendirme davranışını gösterebilirsiniz. Aşağıdaki örnek betikte iki dış veri kaynağı oluşturulur ve her biri için bir dış tablo oluşturulur. Hangi sunucunun bağlantıya yanıt verdiğini test etmek için görünümleri kullanın. Benzer sonuçlar salt okunur yönlendirme özelliği aracılığıyla da elde edilebilir. Daha fazla bilgi için bkz. Always On kullanılabilirlik grubu için salt okunur yönlendirmeyi yapılandırma.

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

Kullanılabilirlik grubundaki veritabanının içinde, döndürülecek sys.servers bir görünüm ve sorguya hangi çoğaltmanın yanıt verdiğini belirlemenize yardımcı olan yerel örneğin adını oluşturun. Daha fazla bilgi için bkz. sys.servers.

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

Ardından kaynak örnekte bir dış tablo oluşturun:

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. PolyBase aracılığıyla S3 uyumlu nesne depolama alanında bir parquet dosyasını sorgulamak için dış veri kaynağı oluşturma

Şunlar için geçerlidir: SQL Server 2022 (16.x) ve sonraki sürümleri.

Aşağıdaki örnek betik, SQL Server'daki kaynak kullanıcı veritabanında bir dış veri kaynağı s3_ds oluşturur. Dış veri kaynağı, s3_dc veritabanı kapsamlı kimlik bilgilerine başvurur.

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

yeni dış veri kaynağını sys.external_data_sourcesile doğrulayın.

SELECT *
FROM sys.external_data_sources;

Ardından aşağıdaki örnek, OPENROWSET sorgusu aracılığıyla S3 uyumlu nesne depolama alanında depolanan bir parquet dosyasını sorgulamak için T-SQL'in kullanılmasını gösterir. Daha fazla bilgi için bkz. PolyBase ile S3 uyumlu bir nesne depolama alanında parquet dosyasını sanallaştırma.

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

E. PostgreSQL'e genel ODBC kullanarak dış veri kaynağı oluşturma

Önceki örneklerde olduğu gibi, önce bir veritabanı ana anahtarı ve veritabanı kapsamlı kimlik bilgileri oluşturun. Dış veri kaynağı için veritabanı kapsamlı kimlik bilgileri kullanılır. Bu örnekte, sunucuda PostgreSQL için genel bir ODBC veri sağlayıcısının yüklü olduğu da varsayılır.

Bu örnekte genel ODBC veri sağlayıcısı, varsayılan TCP 5432 bağlantı noktası kullanılarak PostgreSQL sunucusunun tam etki alanı adının olduğu POSTGRES1aynı ağdaki bir PostgreSQL veritabanı sunucusuna bağlanmak için kullanılır.

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

Azure Depolama

Paylaşılan erişim imzası oluşturma

Hem Azure Blob Depolama hem de Azure Data Lake 2. Nesil için desteklenen kimlik doğrulama yöntemi paylaşılan erişim imzası (SAS) yöntemidir. Paylaşılan erişim imzası belirteci oluşturmanın basit bir yolu aşağıdaki adımları izleyin. Daha fazla bilgi için bkz. CREDENTIAL.

1. Azure portalına ve istediğiniz Depolama Hesabına gidin.
2. Veri Depolama menüsü altında istediğiniz Kapsayıcıya gidin.
3. Paylaşılan erişim belirteçleri'ni seçin.
4. İstenen eyleme göre uygun izni seçin. Başvuru için aşağıdaki tabloyu kullanın:

Eylem	İzin
Dosyadan veri okuma	Okumak
Birden çok dosyadan ve alt klasörden veri okuma	Okuma ve Listeleme
Dış Tablo Oluştur'u Seç Olarak Kullanma (CETAS)	Okuma, Oluşturma ve Yazma

1. Belirteç son kullanma tarihini seçin.
2. SAS belirteci ve URL'si oluşturun.
3. SAS belirtecini kopyalayın.

F. abs:// arabirimini kullanarak Azure Blob Depolama'daki verilere erişmek için dış veri kaynağı oluşturma

Şunlar için geçerlidir: SQL Server 2022 (16.x) ve sonraki sürümleri.

Azure Depolama Hesabı v2 için yeni bir ön ek abs kullanın. Ön abs ek, kullanarak SHARED ACCESS SIGNATUREkimlik doğrulamasını destekler. Ön ek, abs önceki sürümlerde wasbkullanılan öğesinin yerini alır. HADOOP artık desteklenmiyor, artık kullanılmasına TYPE = BLOB_STORAGEgerek yok.

Azure depolama hesabı anahtarı artık gerekli değildir; bunun yerine aşağıdaki örnekte görebileceğiniz gibi SAS Belirteci kullanılır:

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

Azure Blob Depolama'da depolanan CSV dosyalarına erişme hakkında daha ayrıntılı bir örnek için bkz. PolyBase ile CSV dosyasını sanallaştırma.

G. Azure Data Lake 2. Nesil'deki verilere erişmek için dış veri kaynağı oluşturma

Şunlar için geçerlidir: SQL Server 2022 (16.x) ve sonraki sürümleri.

Önceki sürümlerde kullanılan yerine Azure Data Lake 2adls. Nesil için yeni bir ön ek abfs kullanın. Ön ek, adls bu örnekte gösterildiği gibi kimlik doğrulama yöntemi olarak SAS belirtecini de destekler:

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

Azure Data Lake 2. Nesil'de depolanan delta dosyalarına erişme hakkında daha ayrıntılı bir örnek için bkz. PolyBase ile delta tablosunu sanallaştırma.

Örnekler: Toplu İşlemler

Önemli

Bir dış veri kaynağını toplu işlemler için yapılandırırken URL'nin sonuna sondaki /, dosya adı veya paylaşılan erişim imzası parametrelerini eklemeyin LOCATION .

H. Azure Depolama'dan veri alma toplu işlemleri için dış veri kaynağı oluşturma

Şunlar için geçerlidir: SQL Server 2022 (16.x) ve sonraki sürümleri.

BULK INSERT veya OPENROWSET kullanarak toplu işlemler için aşağıdaki veri kaynağını kullanın. Kimlik bilgisi kimlik olarak ayarlanmalıdır SHARED ACCESS SIGNATURE , SAS belirtecinde başta ? yer almamalıdır, yüklenmesi gereken dosyada (örneğin srt=o&sp=r) en az okuma iznine sahip olmalıdır ve süre sonu süresi geçerli olmalıdır (tüm tarihler UTC saatindedir). Paylaşılan erişim imzaları hakkında daha fazla bilgi için bkz. Paylaşılan Erişim İmzalarını (SAS) Kullanma.

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,
);

Ben. Başka bir SQL Server'a bağlanmak için TDS 8.0 kullanarak dış veri kaynağı oluşturma

SQL Server 2025 (17.x) ve sonraki sürümler için geçerlidir.

SQL Server için en son Microsoft ODBC Sürücüsü 18'i kullanırken altında Encryptionseçeneğini kullanmanız CONNECTION_OPTIONS gerekir ve TrustServerCertificate ayrıca desteklenir. Belirtilmezse Encryption , varsayılan davranış şeklindedir Encrypt=Yes;TrustServerCertificate=No;ve bir sunucu sertifikasına ihtiyacınız vardır.

Bu örnekte SQL Kimlik Doğrulaması kullanılmıştır. Kimlik bilgilerini korumak için bir veritabanı ana anahtarına (DMK) ihtiyacınız vardır. Daha fazla bilgi için bkz. CREATE MASTER KEY . Aşağıdaki örnek, özel oturum açma bilgileri ve parola ile veritabanı kapsamlı bir kimlik bilgisi oluşturur.

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

Hedef sunucu adı WINSQL2022, bağlantı noktası 58137ve varsayılan bir örnektir. belirterek Encrypt=Strict, bağlantı TDS 8.0 kullanır ve sunucu sertifikası her zaman doğrulanır. bu örnekte HostnameinCertificate kullanılan:WINSQL2022

CREATE EXTERNAL DATA SOURCE SQLServerInstance2
WITH (
    LOCATION = 'sqlserver://WINSQL2022:58137',
    CONNECTION_OPTIONS = 'Encrypt=Strict;HostnameInCertificate=WINSQL2022;'
    CREDENTIAL = SQLServerCredentials
);

J. Şifreleme ve TrustServerCertificate seçeneğini kullanarak dış veri kaynağı oluşturma

Aşağıdaki önceki örnekte iki kod örneği verilmiştır. İlk kod parçacığında ve EncryptionTrustServerCertificate ayarlanmıştır.

CREATE EXTERNAL DATA SOURCE SQLServerInstance2
WITH (
    LOCATION = 'sqlserver://WINSQL2022:58137',
    CONNECTION_OPTIONS = 'Encrypt=Yes;HostnameInCertificate=WINSQL2022;TrustServerCertificate=Yes;'
    CREDENTIAL = SQLServerCredentials
);

Aşağıdaki kod parçacığı etkinleştirilmemiş Encryption .

CREATE EXTERNAL DATA SOURCE SQLServerInstance2
WITH (
    LOCATION = 'sqlserver://WINSQL2022:58137',
    CONNECTION_OPTIONS = 'Encrypt=no;'
    CREDENTIAL = SQLServerCredentials
);

İlgili içerik

• HARICI VERI KAYNAĞINI DEĞIŞTIR (Transact-SQL)
• VERİTABANI KAPSAMINDA KIMLIK BİLGİSİ OLUŞTUR (Transact-SQL)
• HARICI DOSYA FORMATI OLUŞTUR (Transact-SQL)
• DIŞ TABLO OLUŞTUR (Transact-SQL)
• sys.external_data_sources (Transact-SQL)
• Paylaşılan Erişim İmzalarını (SAS) Kullanma
• PolyBase bağlantı yapılandırması (Transact-SQL)