OneLake kısayolları

Microsoft OneLake'deki kısayollar, OneLake'i tüm kuruluşunuz için tek bir sanal veri gölü haline getirerek etki alanları, bulutlar ve hesaplar arasında verilerinizi birleştirecek. Fabric deneyimleri ve analiz altyapıları Azure, Amazon Web Services (AWS) ve OneLake gibi mevcut veri kaynaklarınıza birleşik bir ad alanı üzerinden bağlanabilir. OneLake tüm izinleri ve kimlik bilgilerini yönetir, bu nedenle her Fabric iş yükünü her veri kaynağına bağlanmak için ayrı ayrı yapılandırmanız gerekmez. Ayrıca, verilerin uç kopyalarını ortadan kaldırmak ve veri kopyaları ve hazırlama ile ilişkili işlem gecikme süresini azaltmak için kısayolları kullanabilirsiniz. Kısayollar, kısayol tabloları için otomatik şema güncelleştirmeleri de dahil olmak üzere kaynak verilerle eşitlemeyi de korur.

Kısayollar nedir?

Kısayollar, OneLake'te diğer depolama konumlarına işaret eden nesnelerdir. Konum, OneLake'in içinde veya dışında olabilir. Kısayolun işaret olduğu konum, kısayolun hedef yoludur . Kısayolunun görüntülendiği konum , kısayol yoludur.

Kısayollar OneLake'te klasör olarak görünür ve OneLake'e erişimi olan tüm iş yükleri veya hizmetler bunları kullanabilir. Kısayollar sembolik bağlantılar gibi davranır. Hedeften bağımsız bir nesnedir. Bir kısayolu silerseniz hedef etkilenmez. Hedef yolu taşır, yeniden adlandırır veya silerseniz kısayol bozulabilir.

Kısayolları nerede oluşturabilirim?

Lakehouse'larda ve Kusto Sorgu Dili (KQL) veritabanlarında kısayollar oluşturabilirsiniz.

Fabric portalını kullanarak etkileşimli kısayollar oluşturabilir ve program aracılığıyla kısayollar oluşturmak için REST API kullanabilirsiniz.

Göl kenarı evi

Bir göl evinde kısayollar oluştururken, öğenin klasör yapısını anlamanız gerekir. Lakehouse'ların iki üst düzey klasörü vardır: Tablolar klasörü ve Dosyalar klasörü. Tablolar klasörü yapılandırılmış veri kümeleri içindir. Dosyalar klasörü yapılandırılmamış veya yarı yapılandırılmış verilere yöneliktir.

Tablolar klasöründe yalnızca en üst düzeyde kısayollar oluşturabilirsiniz. OneLake, Tablolar klasörünün alt dizinlerindeki kısayolları desteklemez. Tablolar bölümündeki kısayollar genellikle OneLake içindeki iç kaynakları gösterir veya Delta tablo biçimine uygun diğer veri varlıklarına bağlanır. Kısayolun hedefi desteklenen bir tablo biçiminde (Delta gibi) veriler içeriyorsa, lakehouse tablo meta verilerini otomatik olarak eşitler ve klasörü tablo olarak tanır.

Tablo şemaları, hem yeni hem de mevcut tablolar da dahil olmak üzere tüm kısayol tabloları için otomatik olarak eşitlenir. Bu eşitleme, kaynaktaki şema değişikliklerinin el ile güncelleştirme gerektirmeden kısayola yansıtılmasını sağlar. Tablolar bölümündeki kısayollar, tek bir tabloya veya birden çok tablo için üst klasör olan şemaya bağlanabilir.

Uyarı

Delta biçimi, adında boşluk karakterleri olan tabloları desteklemez. OneLake, göl evinde Delta tablosu olarak adında boşluk bulunan hiçbir kısayolu tanımaz.

Dosyalar klasöründe, kısayol oluşturabileceğiniz yerle ilgili bir kısıtlama yoktur. Klasör hiyerarşisinin herhangi bir düzeyinde kısayollar oluşturabilirsiniz. Tablo bulma, dosyalar klasöründe gerçekleşmez. Buradaki kısayollar, herhangi bir biçimde veri içeren iç OneLake ve dış depolama sistemlerini işaret edebilir.

KQL veritabanı

KQL veritabanında bir kısayol oluşturduğunuzda, bu kısayol veritabanının Kısayollar klasöründe görünür. KQL veritabanı, kısayolları dış tablolar gibi ele alır. Kısayolu sorgulamak için Kusto Sorgu Dili işlevini kullanınexternal_table.

Eventhouse veritabanı kısayolları

Bir olay evinde veritabanı kısayolu oluşturduğunuzda, kaynak veritabanındaki tüm alt öğeleri eklemeyi veya paylaşmak üzere belirli alt öğeleri seçebilirsiniz. Bu tablo düzeyinde paylaşım özelliği, veritabanlarının tamamını göstermeden güvenli, denetimli veri paylaşımı sağlar.

Belirli alt öğeleri seçme

Yeni bir veritabanı kısayolu oluştururken aşağıdaki alt menü türlerinden birini seçebilirsiniz:

• Tablolar - Kaynak veritabanındaki normal tablolar
• Kısayol tabloları - Kendileri kısayol olan tablolar
• Gerçekleştirilmiş görünümler - İyileştirilmiş sorgular için önceden derlenmiş görünümler
• İşlevler - Yeniden kullanılabilir sorgu mantığı için depolanan işlevler

Belirli alt öğeleri seçmek için:

1. Bir etkinlik evinde + Yeni>Veritabanı kısayolunu seçin.
2. Kaynak veritabanını tanımlamak için bir yöntem seçin:
   • OneLake kataloğu - Fabric'teki bir veritabanına göz atın ve seçin.
   • Küme URI'si - Azure Veri Gezgini bir küme URI'si ve veritabanı adını el ile girin.
   • Davet belirteci - Veri üreticisi tarafından verilen bir belirteci yapıştırın. Alt seçim, üretici tarafından önceden tanımlanmıştır.
3. Eklenecek alt bölümler bölümünde Tüm alt öğeleri ekle (varsayılan) veya Belirli alt öğeleri seç'i seçin.
4. Belirli alt öğeleri seçerseniz, türe göre filtrelemek ve ada göre arama yapmak için satır içi seçiciyi kullanın.
5. Kısayolu oluşturmak için Oluştur'u seçin.

Uyarı

Yalnızca paylaşma izniniz olan alt öğeleri görebilir ve seçebilirsiniz. Paylaşma izniniz olmayan alt öğeler gizlenir.

Otomatik şema eşitleme

Veritabanı kısayolu oluşturduğunuzda, tablo şemaları otomatik olarak eşitlenir. Bu eşitleme hem yeni hem de mevcut tabloları içeren tüm tablo türlerini içerir. Tablo düzeyindeki bir paylaşımın tüketicileri yalnızca paylaşıma açıkça dahil edilen alt öğeleri sorgulayabilir ve görüntüleyebilir. Paylaşılmayan alt öğelerin adları tüketiciler tarafından görünmez.

Otomatik şema eşitlemesini devre dışı bırakmak için kaynak veritabanında aşağıdaki komutu çalıştırın:

.create-or-alter external table ExternalTable
kind=delta
(
   h@'https://storageaccount.blob.core.windows.net/container1;secretKey'
) with (AutoUpdateSchema=false)

Alt içerik bağımlılıkları

Alt öğeleri seçtiğinizde, sistem bağımlılıkları otomatik olarak işler:

• Gerçekleştirilmiş bir görünüm veya işlev seçtiğinizde, başvuruda bulunılan tablolar otomatik olarak seçilir.
• Gerçekleştirilmiş bir görünüm veya işlevin seçimini kaldırdığınızda, başvuruda bulunılan tablolar seçili kalır.
• Bir tablonun seçimini kaldırdığınızda, ona bağlı tüm somutlaştırılmış görünümler veya işlevler otomatik olarak seçimden çıkarılır.

Uyarı

Kısayol tablosuna erişirken, tabloyu sorgulayabilir ve meta verilerini yalnızca kısayol tablosunun hem takip edilen veritabanı hem de kaynak verileri için izinleriniz varsa görüntüleyebilirsiniz. Aynı izin gereksinimleri, kısayol tablolarına başvuran işlevler ve gerçekleştirilmiş görünümler için de geçerlidir.

Kısayollara nereden erişebilirim?

OneLake'teki verilere erişebilen tüm Fabric veya Fabric olmayan hizmetler kısayolları kullanabilir. Kısayollar, OneLake API'sini kullanarak verilere erişen tüm hizmetlerde saydamdır. Kısayollar yalnızca gölde başka bir klasör olarak görünür. Apache Spark, SQL, Gerçek Zamanlı Zeka ve Analysis Services, verileri sorgularken kısayolları kullanabilir.

Apache Spark

Apache Spark not defterleri ve Apache Spark işleri, OneLake'te oluşturduğunuz kısayolları kullanabilir. Verileri doğrudan kısayollardan okumak için göreli dosya yollarını kullanın. Ayrıca, lakehouse'un Tablolar bölümünde bir kısayol oluşturursanız ve Delta biçimindeyse, Apache Spark SQL söz dizimini kullanarak bunu yönetilen tablo olarak okuyabilirsiniz.

df = spark.read.format("delta").load("Tables/MyShortcut")
display(df)

df = spark.sql("SELECT * FROM MyLakehouse.MyShortcut LIMIT 1000")
display(df)

SQL

Lakehouse'un Tablolar bölümündeki kısayolları, lakehouse için SQL analiz uç noktası üzerinden okuyabilirsiniz. SQL analytics uç noktasına lakehouse'un mod seçicisi aracılığıyla veya SQL Server Management Studio (SSMS) aracılığıyla erişebilirsiniz.

SELECT TOP (100) *
FROM [MyLakehouse].[dbo].[MyShortcut]

Gerçek Zamanlı Analiz

KQL veritabanlarındaki kısayollar dış tablolar olarak kabul edilir. Kısayolu sorgulamak için Kusto Sorgu Dili işlevini kullanınexternal_table.

external_table('MyShortcut')
| take 100

Analiz Hizmetleri

Lakehouse'daki Tablolar bölümünde kısayollar içeren lakehouse'lar için anlamsal modeller oluşturabilirsiniz. Anlam modeli Direct Lake modunda çalıştırıldığında Analysis Services verileri doğrudan kısayoldan okuyabilir.

Fabric altyapısına dahil olmayan hizmetler

Fabric dışındaki uygulamalar ve hizmetler de OneLake API aracılığıyla kısayollara erişebilir. OneLake, ADLS 2. Nesil ve Blob depolama API'lerinin bir alt kümesini destekler. OneLake API'si hakkında daha fazla bilgi edinmek için bkz. API'lerle OneLake erişimi.

https://onelake.dfs.fabric.microsoft.com/MyWorkspace/MyLakhouse/Tables/MyShortcut/MyFile.csv

Kısayol türleri

OneLake'deki kısayollar birden çok dosya sistemi veri kaynağını destekler. Bu kaynaklar iç OneLake konumlarını ve dış veya Microsoft olmayan kaynakları içerir.

Ayrıca Fabric şirket içi veri ağ geçidi (OPDG) kullanarak şirket içi veya ağ kısıtlamalı konumlara kısayollar oluşturabilirsiniz.

Dahili OneLake kısayolları

Mevcut Fabric öğelerindeki verilere başvurmak için dahili OneLake kısayollarını kullanın, örneğin:

• KQL veritabanları
• Göl evleri
• Yansıtılmış Azure Databricks Katalogları
• Yansıtılmış Veritabanları
• Anlamsal modeller
• SQL veritabanları
• Depolar

İç kısayol oluşturma yönergeleri için bkz. İç OneLake kısayolu oluşturma.

Kısayol, aynı öğe içindeki bir klasör konumunu, aynı çalışma alanı içindeki öğeler arasında veya hatta farklı çalışma alanlarındaki öğeler arasında işaret edebilir. Öğeler arasında bir kısayol oluşturduğunuzda, öğe türlerinin eşleşmesi gerekmez. Örneğin, bir depodaki verilere işaret eden bir göl evinde kısayol oluşturabilirsiniz.

Kullanıcı bir kısayol aracılığıyla başka bir OneLake konumundan verilere eriştiğinde OneLake, verilere erişim yetkisi vermek için çağıran kullanıcının kimliğini kullanır. Bu kullanıcının verileri okumak için hedef konumda izinleri olmalıdır.

Önemli

Kullanıcılar, Power BI semantik modelleri aracılığıyla SQL üzerinden Direct Lake veya Devredilmiş kimlik modundaki T-SQL altyapılarını kullanarak kısayollara eriştiğinde, çağıran kullanıcının kimliği kısayol hedefine geçirilmez. Bunun yerine, arama öğesinin sahibinin kimliği geçirilir ve bu da arayan kullanıcıya erişim yetkisi verir. Bu sınırlamayı çözmek için OneLake modunda Direct Lake'te Power BI anlamsal modelleri veya Kullanıcı kimliği modunda T-SQL'i kullanın.

Harici OneLake kısayolları

Belirli bir kısayol türü oluşturmaya yönelik ayrıntılı yönergeler için desteklenen dış kaynaklar listesinden bir makale seçin:

• Amazon S3 kısayolları
• Amazon S3 uyumlu kısayollar
• Azure Data Lake Storage (ADLS) 2. Nesil kısayolları
• Azure Blob Depolama kısayolları
• Dataverse kısayolları
• Google Cloud Storage kısayolları
• Iceberg kısayolları
• OneDrive ve SharePoint kısayolları

Önbellekleme

Kısayol önbelleğe alma, bulutlar arası veri erişimiyle ilişkili çıkış maliyetlerini azaltabilir. OneLake dosyaları bir dış kısayol aracılığıyla okurken, hizmet dosyaları Fabric çalışma alanı için bir önbellekte depolar. OneLake, uzak depolama sağlayıcısı yerine önbellekten gelen sonraki okuma isteklerine yanıt verir. Önbelleğe alınan dosyalar için saklama süresini 1-28 gün arasında ayarlayabilirsiniz. Dosyaya her erişişiniz için saklama süresi sıfırlanır. Uzak depolama alanı, dosyanın önbelleğin sürümünden daha yeni bir sürümüne sahipse, OneLake uzak depolama sağlayıcısından gelen isteği sunar ve dosyayı önbellekte güncelleştirir. Seçilen saklama süresi içinde bir dosyaya erişmezseniz, dosya önbellekten temizlenir. Boyutu 1 GB'tan büyük tek tek dosyalar önbelleğe alınmaz.

Uyarı

Kısayol önbelleğe alma şu anda Google Cloud Storage (GCS), S3, S3 uyumlu ve şirket içi veri ağ geçidi kısayollarını desteklemektedir.

Önbelleğe alma, Microsoft Entra hizmet sorumlusu kimlik doğrulamasını kullanan şirket içi Amazon S3 kısayolları için de desteklenir.

Kısayollar için önbelleğe almayı etkinleştirmek için Çalışma alanı ayarları panelini açın. OneLake sekmesini seçin. Önbellek ayarını Açık konuma getirin ve Bekletme Dönemi'ni seçin.

Önbelleği istediğiniz zaman temizleyebilirsiniz. Aynı ayarlar sayfasında Önbelleği sıfırla düğmesini seçin. Bu eylem, bu çalışma alanında kısayol önbelleğindeki tüm dosyaları kaldırır.

Kısayolların bulut bağlantılarını kullanma şekli

ADLS ve S3 kısayolları, bulut bağlantılarını kullanarak yetkilendirme yetkisi verir. Yeni bir ADLS veya S3 kısayolu oluşturduğunuzda, yeni bir bağlantı oluşturur veya veri kaynağı için var olan bir bağlantıyı seçersiniz. Kısayol için bağlantı ayarlamak bir bağlama işlemidir. Bağlama işlemini yalnızca bağlantı üzerinde izni olan kullanıcılar gerçekleştirebilir. Bağlantı üzerinde izniniz yoksa, bu bağlantıyı kullanarak yeni kısayollar oluşturamazsınız.

Bulut bağlantılarını görüntüleme ve güncelleştirme hakkında daha fazla bilgi için bkz. Kısayollar için bağlantıları yönetme.

Kısayol güvenliği

Kısayolların yönetilmesi ve kullanılması için belirli izinler gerekir. OneLake kısayol güvenliği , kısayol oluşturmak ve bunlar aracılığıyla verilere erişmek için ihtiyacınız olan izinleri açıklar.

Kısayollar silme işlemlerini nasıl işler?

Kısayollar art arda silmeleri desteklemez. Bir kısayolu sildiğinizde, yalnızca kısayol nesnesini silersiniz. Kısayol hedefindeki veriler değişmeden kalır. Ancak, bir kısayol içindeki bir dosya veya klasörü silerseniz ve kısayol hedefinde silme işlemini gerçekleştirme izinleriniz varsa, hedefteki dosya veya klasörü de silersiniz.

Örneğin, içinde şu yolu olan bir göl kenarındaki evi düşünün: MyLakehouse\Files\MyShortcut\Foo\Bar. MyShortcut , Foo\Bar dizinlerini içeren bir ADLS 2. Nesil hesabına işaret eden bir kısayoldur.

Eğer MyLakehouse\Files\MyShortcut öğesini silerseniz, lakehouse'daki MyShortcut kısayolunu silersiniz, ancak ADLS Gen2 hesabındaki Foo\Bar dosya ve dizinler etkilenmeden kalır.

Eğer MyLakehouse\Files\MyShortcut\Foo\Bar öğesini silerseniz ve ADLS Gen2 hesabında yazma izinleriniz varsa, ADLS Gen2 hesabından Bar dizinini silersiniz.

Bir başka örnek olarak, içinde şu yolun bulunduğu şema etkin bir lakehouse düşünün: MyLakehouse\Tables\MySchemaShortcut\Dir1. MySchemaShortcut , Dir1 dizinini içeren bir ADLS 2. Nesil hesabına işaret eden bir şema kısayoludur.

MyLakehouse\Tables\MySchemaShortcut öğesini silerseniz, MySchemaShortcut şema kısayolunu lakehouse’tan silersiniz, ancak ADLS Gen2 Dir1 hesabındaki dosyalar ve dizinler etkilenmez.

öğesini silerseniz MyLakehouse\Tables\MySchemaShortcut\Dir1ve ADLS 2. Nesil hesabında yazma izinleriniz varsa, ADLS 2. Nesil hesabından Dir1 dizinini silersiniz.

Çalışma alanı kökeni görünümü

Çalışma alanı içindeki birden çok Fabric öğesi arasında kısayollar oluşturduğunuzda, çalışma alanı kökeni görünümü aracılığıyla kısayol ilişkilerini görselleştirebilirsiniz. Çalışma Alanı gezgininin sağ üst köşesindeki Köken görünümü düğmesini ( ) seçin.

Uyarı

Köken görünümü tek bir çalışma alanıyla sınırlıdır. Seçili çalışma alanının dışındaki konumların kısayolları görünmez.

Sınırlamalar ve önemli noktalar

• Her Fabric öğesi en fazla 100.000 kısayolu destekler. Bu bağlamda, öğe terimi uygulamalar, göl evleri, ambarlar, raporlar ve daha fazlasını ifade eder.
• Tek bir OneLake yolu en fazla 10 kısayolu destekler.
• Kısayol bağlantılarına yönelik en fazla doğrudan kısayol sayısı 5'tir.
• Kısayol adları, üst yollar ve hedef yollar "%" veya "+" karakterleri içeremez.
• Kısayollar Latin olmayan karakterleri desteklemez.
• Ambarlara ve anlamsal modellere yönelik kısayollar için köken şu anda kullanılamıyor.
• Fabric kısayolu, kaynak ile kendiliğinden senkronize olur. Şema ve meta veri güncelleştirmeleri el ile müdahale edilmeden uygulanır, ancak yayma süresi veri kaynağı performansı, önbelleğe alınmış görünümler veya ağ bağlantısı nedeniyle değişebilir.
• Tablo API'sinin yeni kısayolları tanıması bir dakika kadar sürebilir.
• Şema kısayolları yalnızca şema özellikli lakehouse'larda oluşturulabilir.

İlgili içerik

• OneLake kısayolu oluşturma
• OneLake kısayol REST API'lerini kullanma