Delta Sharing için paylaşım oluşturma ve yönetme

Bu sayfada Delta Sharing için paylaşım oluşturma ve yönetme açıklanmaktadır.

Paylaşım, Unity Kataloğu'nda bir veya daha fazla alıcıyla aşağıdaki veri varlıklarını paylaşmak için kullandığınız güvenli hale getirilebilir bir nesnedir:

• Tablolar ve tablo bölümlendirmeleri
• Akış tabloları
• Yönetilen Iceberg tabloları
• Dış Buzdağı tabloları
• Yabancı şemalar ve tablolar
• Satır ve sütun düzeyinde erişimi kısıtlayan dinamik görünümler de dahil olmak üzere görünümler
• Gerçekleştirilmiş görünümler
• Hacimler
• Python UDF'ler
• Notebooks
• Yapay zeka modelleri

• FeatureSpecs

Bir şemanın (veritabanının) tamamını paylaşırsanız, alıcı şemayı paylaştığınız anda şemadaki tüm tablolara, akış tablolarına, görünümlere, gerçekleştirilmiş görünümlere, modellere ve birimlere ve gelecekte şemaya eklenen tüm verilere ve yapay zeka varlıklarına erişebilir.

Bir paylaşım yalnızca bir Unity Kataloğu meta veri deposundaki verileri ve yapay zeka varlıklarını içerebilir. İstediğiniz zaman bir paylaşıma veri ve yapay zeka varlıkları ekleyebilir veya kaldırabilirsiniz.

Paylaşım oluşturmadan önce hesabınız (sağlayıcılar için) için Delta Paylaşımı'nı ayarladığınızdan emin olun.

Paylaşım modeli hakkında daha fazla bilgi edinmek için bkz. Paylaşımlar, sağlayıcılar ve alıcılar.

Requirements

Tamamlamak istediğiniz her görev için listelenen gereksinimleri karşılayıp karşılamadığınıza bakın.

Tavsiye

Bir paylaşıma veri varlıkları eklerken Databricks, paylaşım sahibi olarak bir grup kullanmanızı önerir.

Görev	Requirements
Paylaşım oluşturma	CREATE SHARE Paylaşmak istediğiniz verilerin kayıtlı olduğu Unity Kataloğu meta veri deposu için ayrıcalığına sahip olun. Unity Kataloğu meta veri deposunun eklendiği bir Azure Databricks çalışma alanı kullanarak paylaşımı oluşturun.
Bir paylaşıma aşağıdakileri ekleyin: Tables Akış tabloları Yönetilen Iceberg tabloları Harici veritabanı tabloları Harici Iceberg tabloları İzlenimler Gerçekleştirilmiş görünümler	Hisse sahibi olun. Katalog ve verisi varlığını içeren şemada USE CATALOG ve USE SCHEMA ayrıcalıklarına sahip olun. SELECT Veri varlığı üzerinde ayrıcalığa sahip olun. Varlığın paylaşılmaya devam edebilmesi için bu ayrıcalığı korumanız gerekir. Kaybederseniz, alıcı paylaşım aracılığıyla varlığa erişemez.
Şemanın tamamını veya yabancı şemayı paylaşma	Paylaşım sahibi ve şema sahibi veya sahibi USE SCHEMAolun. Tabloları paylaşmak için SELECT şemada bulundurun. Verileri paylaşmak için şema üzerinde READ VOLUME bulundurun.
Paylaşıma hacim ekle	Hisse sahibi olun. Katalog ve şemanın birimde yer aldıkları veya katalog veya şema üzerinde sahipliği bulunan kişilerde USE CATALOG ve USE SCHEMA ayrıcalıklarına sahip olun. Birim üzerinde READ VOLUME ayrıcalığına sahip olun. Hacmin paylaşılmaya devam edebilmesi için bu ayrıcalığı korumanız gerekir. Kaybedersen, alıcı birime paylaşım yoluyla erişemez.
Paylaşıma Python UDF ekleme	Hisse sahibi olun. Python UDF'sini içeren katalog ve şemada USE CATALOG ve USE SCHEMA ayrıcalığına ya da kataloğun veya şemanın sahipliğine sahip olun. Python UDF'de EXECUTE ayrıcalığına sahip olun. Python UDF'nin paylaşılmaya devam etmesi için bu ayrıcalığı korumanız gerekir. Kaybederseniz, alıcı paylaşım aracılığıyla Python UDF'ye erişemez.
Paylaşıma model ekleme	Hisse sahibi olun. Modelin bulunduğu katalog ve şema üzerinde USE CATALOG ve USE SCHEMA ayrıcalığına sahip olun veya katalog ya da şemanın sahipliğini elinde bulundurun. Modelde EXECUTE ayrıcalığına sahip olun. Modelin paylaşılmaya devam edebilmesi için bu ayrıcalığı korumanız gerekir. Bağlantıyı kaybederseniz, alıcı paylaşım aracılığıyla modele erişemez.
Paylaşıma not defteri dosyaları ekleme	Not defterinde OKUYABILIR iznine sahip paylaşım sahibi olun.
Alıcıya paylaşıma erişim izni verme	Meta veri deposu yöneticisi olun. VEYA Hem paylaşım hem de alıcı nesnelerinde temsilci izinleri veya sahipliği olan bir kullanıcı olun; bu da kullanıcının aşağıdaki gereksinimlerin her ikisini de karşılaması gerektiği anlamına gelir: Hem USE SHARE hem de SET SHARE PERMISSION ayrıcalıklarına sahip olun ya da paylaşım sahibi olun Ayrıcalığa sahip olun USE RECIPIENT VEYA alıcının sahibi olun
Paylaşımları görüntüleme	Meta veri deposu yöneticisi olun (tümünü görüntüleyebilir). OR Ayrıcalığı olan USE SHARE bir kullanıcı olun (tümünü görüntüleyebilir). OR Paylaşım nesnesi sahibi olun.
Paylaşım sahibini güncelleştirme	Meta veri deposu yöneticisi olun.
Paylaşım adını güncelleştirme	Ayrıcalığa sahipsiniz CREATE SHARE . Hisse sahibi olun.
Diğer paylaşım özelliklerini güncelleştirme	Hisse sahibi olun.
Paylaşımları silme	Paylaşım nesnesi sahibi olun.

İşlem gereksinimleri

• Paylaşımı oluşturmak için Databricks not defteri kullanıyorsanız işlem kaynağınızın Databricks Runtime 11.3 LTS veya üzerini kullanması ve standart veya ayrılmış erişim moduna (eski adıyla paylaşılan ve tek kullanıcı) sahip olması gerekir.
• Paylaşıma şema eklemek (veya şemayı güncelleştirmek veya kaldırmak) için SQL deyimleri kullanıyorsanız Databricks Runtime 13.3 LTS veya üzerini çalıştıran bir SQL ambarı veya işlem kullanmanız gerekir. Katalog Gezgini'ni kullanarak aynı işlemi yapmak için işlem gereksinimi yoktur.

Paylaşılan nesne oluştur

Bir paylaşım nesnesi oluşturmadan önce gereksinimleri karşıladığınızdan denetleyin.

Paylaşım oluşturmak için Katalog Gezgini'ni, Databricks Unity Kataloğu CLI'sını veya Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde CREATE SHARE SQL komutunu kullanın.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde Verileri paylaş düğmesine tıklayın.

4. Paylaşım oluştur sayfasında paylaşım Adını ve isteğe bağlı bir açıklamayı girin.

5. Kaydet'e tıklayın ve devam edin.

   Veri varlıkları eklemeye devam edebilir veya daha sonra durdurup geri dönebilirsiniz.

6. Veri varlıkları ekle sekmesinde, paylaşmak istediğiniz veri varlıklarını seçin.

   Ayrıntılı yönergeler, ek gereksinimler ve ilgili sınırlamalar için bkz:

   • Paylaşıma tablo ekleme
   • Paylaşıma akış tabloları ekleme
   • Bir paylaşıma yönetilen Iceberg tabloları ekleme
   • Paylaşıma yabancı şemalar veya tablolar ekleme
   • Paylaşıma birim ekleme
   • Paylaşıma görünüm ekleme
   • Paylaşıma gerçekleştirilmiş görünümler ekleyin
   • Paylaşıma model ekleme

7. Kaydet'e tıklayın ve devam edin.

8. Not defterleri ekle sekmesinde, paylaşmak istediğiniz not defterlerini seçin.

   Ayrıntılı yönergeler için bkz . Paylaşıma not defteri dosyaları ekleme.

9. Kaydet'e tıklayın ve devam edin.

10. Alıcı ekle sekmesinde, paylaşmak istediğiniz alıcıları seçin.

    Ayrıntılı yönergeler için bkz. Delta Sharing veri paylaşımlarına erişimi yönetme (sağlayıcılar için).

11. Verileri alıcılarla paylaşmak için Verileri paylaş'a tıklayın.

SQL

Not defterinde veya Databricks SQL sorgu düzenleyicisinde aşağıdaki komutu çalıştırın:

CREATE SHARE [IF NOT EXISTS] <share-name>
[COMMENT "<comment>"];

Artık paylaşıma tablolar, akış tabloları, birimler, görünümler, gerçekleştirilmiş görünümler ve modeller ekleyebilirsiniz.

Ayrıntılı yönergeler, ek gereksinimler ve ilgili sınırlamalar için bkz:

• Paylaşıma tablo ekleme
• Paylaşıma akış tabloları ekleme
• Bir paylaşıma yönetilen Iceberg tabloları ekleme
• Paylaşıma yabancı şemalar veya tablolar ekleme
• Paylaşıma birim ekleme
• Paylaşıma görünüm ekleme
• Paylaşıma gerçekleştirilmiş görünümler ekleyin
• Paylaşıma model ekleme

CLI

Databricks CLI kullanarak aşağıdaki komutu çalıştırın.

databricks shares create <share-name>

Yorum eklemek veya --comment paylaşıma varlık eklemek için kullanabilirsiniz--json. Ayrıntılar için aşağıdaki bölümlere bakın.

Artık paylaşıma tablolar, akış tabloları, birimler, görünümler, gerçekleştirilmiş görünümler ve modeller ekleyebilirsiniz.

Ayrıntılı yönergeler, ek gereksinimler ve ilgili sınırlamalar için bkz:

• Paylaşıma tablo ekleme
• Paylaşıma akış tabloları ekleme
• Bir paylaşıma yönetilen Iceberg tabloları ekleme
• Paylaşıma yabancı şemalar veya tablolar ekleme
• Paylaşıma birim ekleme
• Paylaşıma görünüm ekleme
• Paylaşıma gerçekleştirilmiş görünümler ekleyin
• Paylaşıma model ekleme

Paylaşıma tablo ekleme

Paylaşıma tablo eklemeden önce gereksinimleri karşıladığınızdan denetleyin.

Çalışma alanı yöneticisiyseniz ve çalışma alanı yönetici grubundan USE SCHEMA tabloyu içeren şema ve katalog üzerindeki ve USE CATALOG izinlerini devraldıysanız, tabloyu bir paylaşıma ekleyemezsiniz. Önce şema ve katalog üzerinde kendinize USE SCHEMA ve USE CATALOG izinlerini vermelisiniz.

Note

Tablo açıklamaları, sütun açıklamaları ve birincil anahtar kısıtlamaları , 25 Temmuz 2024 veya sonrasında Databricks-to-Databricks paylaşımı kullanılarak bir alıcıyla paylaşılan paylaşımlara eklenir. Açıklama ve kısıtlamaları, yayın tarihinden önce bir alıcıyla paylaşılan bir paylaşım aracılığıyla paylaşmaya başlamak istiyorsanız, açıklama ve kısıtlama paylaşımını tetikleyebilmek için alıcı erişimini iptal edip yeniden vermelisiniz.

Bir paylaşıma tablo eklemek için, Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini, Databricks Unity Kataloğu CLI veya SQL komutlarını kullanın.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, tablo eklemek istediğiniz paylaşımı bulun ve adına tıklayın. Satır izlemenin etkinleştirildiği tablolar ekleyebilirsiniz. Alıcılar satır izleme sütunlarını sorgulayabilir.

4. Varlıkları Yönet > Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, şemanın tamamını (veritabanı) veya tek tek tabloları seçin.

   • Tablo seçmek için önce kataloğu, ardından tabloyu içeren şemayı ve ardından tablonun kendisini seçin.

     Çalışma alanı aramasını kullanarak tabloları ada, sütun adına veya açıklamaya göre arayabilirsiniz. Bkz . Çalışma alanı nesnelerini arama.

   • Şema seçmek için önce kataloğu ve ardından şemayı seçin.

     Şemaları paylaşma hakkında ayrıntılı bilgi için bkz . Paylaşıma şema ekleme.

6. Geçmiş: Alıcıların zaman yolculuğu sorguları gerçekleştirmesine, Spark Yapılandırılmış Akış ile tabloyu okumasına veya işlemleri çalıştırmasına izin vermek için tablo geçmişini paylaşın. Databricks-Databricks paylaşımları için, performansı artırmak amacıyla tablonun Delta log dosyası da paylaşılır. Bkz. Geçmiş paylaşımı ile tablo okuma performansını geliştirme. Geçmiş paylaşımı için Databricks Runtime 12.2 LTS veya üzeri gerekir.

   Note

   Müşterilerinizin table_changes() işlevini kullanarak tablonun değişiklik veri akışını (CDF) sorgulayabilmesini de istiyorsanız, paylaşmadan önce WITH HISTORY gerekir.

7. (İsteğe bağlı) Diğer ad veya bölüm eklemek için Speech bubble plus icon.Diğer ad veya Bölüm sütunları altında tıklayın. Şemanın tamamını seçerseniz takma adlar ve bölümler kullanılamaz. Bir şemanın tamamını seçerseniz tablo geçmişi varsayılan olarak eklenir.

   • Diğer ad: Tablo adını daha anlaşılır hale getirmek için alternatif bir tablo adı. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken tablonun adıdır. Diğer ad belirtilirse alıcılar gerçek tablo adını kullanamaz.
   • Bölüm: Tablonun yalnızca bir bölümünü paylaşın. Örneğin, (column = 'value'). Bkz. Paylaşılacak tablo bölümlerini belirtme ve Bölüm filtreleme yapmak için alıcı özelliklerini kullanma.

8. Kaydet'e tıklayın.

SQL

Tablo eklemek için bir not defterinde veya Databricks SQL sorgu düzenleyicisinde aşağıdaki komutu çalıştırın:

ALTER SHARE <share-name> ADD TABLE <catalog-name>.<schema-name>.<table-name>  [COMMENT "<comment>"]
   [PARTITION(<clause>)] [AS <alias>]
   [WITH HISTORY | WITHOUT HISTORY];

Şemanın tamamını eklemek için aşağıdakileri çalıştırın. Komut ADD SCHEMA , Databricks Runtime 13.3 LTS veya üzerini çalıştıran bir SQL ambarı veya işlem gerektirir. Şemaları paylaşma hakkında ayrıntılı bilgi için bkz . Paylaşıma şema ekleme.

ALTER SHARE <share-name> ADD SCHEMA <catalog-name>.<schema-name>
[COMMENT "<comment>"];

Seçenekler şunlardır. PARTITION ve AS <alias> bir şemanın tamamını seçerseniz kullanılamaz.

• PARTITION(<clause>): Tablonun yalnızca bir bölümünü paylaşmak istiyorsanız bir bölüm belirtebilirsiniz. Örneğin, (column = 'value') bkz Paylaşılacak tablo bölümlerini belirtme ve Bölüm filtreleme yapmak için alıcı özelliklerini kullanma.

• AS <alias>: Tablo adını daha okunabilir hale getirmek için alternatif bir ad veya takma ad. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken tablonun adıdır. Diğer ad belirtilirse alıcılar gerçek tablo adını kullanamaz. <schema-name>.<table-name> biçimini kullanın.

• WITH HISTORY veya WITHOUT HISTORY: WITH HISTORY belirtildiğinde, tabloyu tam geçmişle paylaşarak alıcıların zaman yolculuğu sorguları gerçekleştirmesine, akış okuması yapmasına ve işlemleri çalıştırmasına izin verin. Databricks-Databricks paylaşımları için geçmiş paylaşımı, performansı geliştirmek için tablonun Delta günlüğünü de paylaşır. Tablo paylaşımı için varsayılan davranış, işlemciniz Databricks Runtime 16.2 veya üzerini çalıştırıyorsa WITH HISTORY, önceki Databricks Runtime sürümleri için ise WITHOUT HISTORY'dir. Şema paylaşımında, herhangi bir Databricks Runtime sürümünden bağımsız olarak varsayılan ayar WITH HISTORY'dır. WITH HISTORY ve WITHOUT HISTORY Databricks Runtime 12.2 LTS veya üzerini gerektirir. Ayrıca bkz. Geçmiş paylaşımı ile tablo okuma performansını iyileştirme.

  Note

  Zaman yolculuğu sorguları ve akış okumalarına ek olarak, alıcılarınızın table_changes() işlevini kullanarak tablonun değişiklik veri akışını (CDF) sorgulamasını istiyorsanız, paylaşmadan önce WITH HISTORY gerekir.

ALTER SHARE seçenekleri hakkında daha fazla bilgi için bkz. ALTER SHARE.

CLI

Tablo eklemek için Databricks CLI kullanarak aşağıdaki komutu çalıştırın.

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

Şema eklemek için aşağıdaki Databricks CLI komutunu çalıştırın:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<schema-full-name>",
          "data_object_type": "SCHEMA"
        }
      }
    ]
  }'

Note

Tablolar ve yalnızca tablolar için "data_object_type"'yi çıkartabilirsiniz.

Bu örnekte listelenen seçenekler hakkında bilgi edinmek için SQL sekmesindeki yönergeleri görüntüleyin.

Ek parametreler hakkında bilgi edinmek için databricks shares update --help komutunu çalıştırın veya REST API başvurusundaki PATCH /api/2.1/unity-catalog/shares/ kısmına bakın.

Bir paylaşımdan tabloları kaldırma hakkında bilgi için bkz. Paylaşımları güncelleştirme.

Bulut jetonu uygunluğu

Azure Databricks, alıcılara paylaşılan Delta tablo dosyalarına doğrudan okuma erişimi vermek için bulut belirteçlerini (geçici, yol kapsamlı bulut kimlik bilgileri) kullanır. Açık paylaşım protokolünde bu, dizin tabanlı erişim modu olarak da adlandırılır. Görünümler, gerçekleştirilmiş görünümler, yabancı tablolar, akış tabloları, hacimler, not defterleri, Python UDF'ler ve yapay zeka modelleri desteklenmez. Hangi tabloların uygun olduğu paylaşım protokolüne bağlıdır.

Databricks-Databricks paylaşımı: Aşağıdakilerin tümü doğru olduğunda bulut belirteçleri kullanılır:

• Tablo, başlangıçtan itibaren bütün geçmişiyle paylaşılıyor WITH HISTORY.
• Tablo bölüm filtresi olmadan paylaşılır.

Açık paylaşım: Aşağıdakilerin tümü doğru olduğunda bulut belirteçleri (dizin tabanlı erişim modu) kullanılır:

• Paylaşılan nesne yönetilen veya dış Delta tablosudur.
• Tablo paylaşıldı WITH HISTORY (başlangıçtan itibaren tüm geçmiş).
• Tablo bölüm filtresi olmadan paylaşılır.
• Tablo bir CCv2 tablosu değil.
• Tablo varsayılan depolamayı kullanmaz.

Databricks-Databricks paylaşımları için bulut belirteçleri, uzun süreli taşıyıcı belirteçleri olmadan Unity Kataloğu meta veri depoları arasında doğrudan değiştirilir ve doğrudan kaynak tablo erişimiyle karşılaştırılabilir performans elde edilir. Açık paylaşım için Delta Sharing sunucusu, tablonun bulut depolama konumunu ve liste ve meta veri yanıtlarında accessModes: ["url", "dir"] içerir. Açık alıcılar, kimlik bilgilerini almak ve doğrudan bulut depolamadan okumak için Geçici Tablo Kimlik Bilgileri Oluştur uç noktasını çağırabilir.

Important

Bulut belirteci erişimi kullanıldığında, alıcılar paylaşılan Delta tablosunun kök dizini kapsamında kimlik bilgilerini alır. Bu, hem veri dosyalarına hem de Delta günlüğüne okuma erişimi verir. Delta günlüğü her tablo sürümü için işleme geçmişini, işleme aracı hakkındaki bilgileri ve vakumlanmamış silinen verileri içerir.

Paylaşılacak tablo bölümlerini belirtme

Tabloyu bir paylaşıma eklediğinizde tablonun yalnızca bir bölümünü paylaşmak için bir bölüm belirtimi sağlayın. Bir Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini'ni, Databricks Unity Kataloğu CLI'sini veya SQL komutlarını kullanarak bir paylaşıma tablo eklediğinizde veya bir paylaşımı güncelleştirdiğinizde bölümleri belirtin. Bkz. Paylaşıma tablo ekleme ve Paylaşımları güncelleştirme.

Example

Aşağıdaki SQL örneği, tablodaki inventory verilerin , yearve month sütunları tarafından datebölümlenmiş bir bölümünü paylaşır:

• 2021 yılına ilişkin veriler.
• Aralık 2020 verileri.
• 25 Aralık 2019 verileri.

ALTER SHARE share_name
ADD TABLE inventory
PARTITION (year = "2021"),
          (year = "2020", month = "Dec"),
          (year = "2019", month = "Dec", date = "2019-12-25");

Bölüm filtreleme yapmak için alıcı özelliklerini kullanma

Parametreli bölüm paylaşımı olarak da bilinen veri alıcısı özellikleriyle eşleşen bir tablo bölümünü paylaşabilirsiniz.

Varsayılan özellikler şunlardır:

• databricks.accountId: Veri alıcısının ait olduğu Azure Databricks hesabı (yalnızca Databricks-Databricks paylaşımı).
• databricks.metastoreId: Veri alıcısının ait olduğu Unity Catalog metastore (yalnızca Databricks-Databricks paylaşımı).
• databricks.name: Veri alıcısının adı.

Alıcı oluştururken veya güncelleştirirken herhangi bir özel özellik oluşturabilirsiniz.

Alıcı özelliğine göre filtreleme, aynı paylaşımı kullanarak birden çok Databricks hesabı, çalışma alanı ve kullanıcı arasında veri sınırlarını korurken aynı tabloları paylaşmanızı sağlar.

Örneğin, tablolarınız bir Azure Databricks hesap kimliği sütunu içeriyorsa, Azure Databricks hesap kimliği tarafından tanımlanan tablo bölümleriyle tek bir paylaşım oluşturabilirsiniz. Paylaştığınızda Delta Sharing, her alıcıya yalnızca Azure Databricks hesabıyla ilişkili verileri dinamik olarak teslim eder.

Özelliğe göre dinamik olarak bölümleme özelliği olmadan, her alıcı için ayrı bir paylaşım oluşturmanız gerekir.

Bir paylaşımı oluştururken veya güncelleştirirken alıcı özelliklerine göre filtreleyen bir bölüm belirtmek için, bir Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini'ni veya CURRENT_RECIPIENT SQL işlevini kullanabilirsiniz:

Note

Alıcı özellikleri Databricks Runtime 12.2 veya üzerinde kullanılabilir.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, güncelleştirmek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları yönet > Veri varlıklarını ekle'ye tıklayın.

5. Tablo ekle sayfasında, tabloyu içeren kataloğu ve veritabanını ve ardından tabloyu seçin.

   Tabloyu hangi katalog ve veritabanının içerdiğinden emin değilseniz, çalışma alanı aramasını kullanarak ad, sütun adı veya açıklamaya göre arama yapabilirsiniz. Bkz . Çalışma alanı nesnelerini arama.

6. (İsteğe bağlı) Bölüm eklemek için Bölüm sütunu altında.

   Tabloya bölüm ekle iletişim kutusunda, aşağıdaki söz dizimini kullanarak özellik tabanlı bölüm belirtimini ekleyin:

   (<column-name> = CURRENT_RECIPIENT().<property-key>)
   

   Örneğin

   (country = CURRENT_RECIPIENT().country)
   

7. Kaydet'e tıklayın.

SQL

Not defterinde veya Databricks SQL sorgu düzenleyicisinde aşağıdaki komutu çalıştırın:

ALTER SHARE <share-name> ADD TABLE <catalog-name>.<schema-name>.<table-name>
   PARTITION (<column-name> = CURRENT_RECIPIENT().<property-key>);

Örneğin

ALTER SHARE acme ADD TABLE acme.default.some_table
  PARTITION (country = CURRENT_RECIPIENT().country);

Bir paylaşıma silme vektörleri veya sütun eşlemesi içeren tablolar ekleme

Important

Bu özellik Genel Önizlemededir.

Silme vektörleri, Delta tablolarında etkinleştirebileceğiniz bir depolama iyileştirme özelliğidir. Bkz . Databricks'te silme vektörleri.

Azure Databricks Delta tabloları için sütun eşlemeyi de destekler. Bkz Delta Lake sütun eşlemesi ile sütunları yeniden adlandırma ve bırakma.

Silme vektörleri veya sütun eşlemesi olan bir tabloyu paylaşmak için tabloyu geçmişle paylaşmanız gerekir. Bkz. Paylaşıma tablo ekleme.

Silme vektörleri veya sütun eşlemesi içeren bir tabloyu paylaştığınızda, alıcılar sql ambarı, Databricks Runtime 14.1 veya üzerini çalıştıran bir işlem veya açık kaynak delta-sharing-spark 3.1 veya üzerini çalıştıran bir işlem kullanarak tabloyu sorgulayabilir. Bkz Silme vektörleri veya sütun eşlemesi etkin tabloları okuma ve Silme vektörleri veya sütun eşlemesi etkin tabloları okuma.

Paylaşıma şema ekleme

Paylaşıma şema eklemeden önce gereksinimleri karşıladığınızdan denetleyin.

Bir paylaşıma şemanın tamamını eklemek, alıcılarınızın paylaşımı oluşturduğunuz sırada şemadaki tüm veri varlıklarına ve zaman içinde şemaya eklenen tüm varlıklara erişmesini sağlar. Bu şemadaki tüm tabloları, görünümleri ve birimleri içerir. Bu şekilde paylaşılan tablolar her zaman tam geçmiş içerir.

Şemaları alıcıyla paylaşma

Paylaşıma şema eklemek için Paylaşıma tablo ekleme başlığındaki yönergeleri izleyin ve şemanın nasıl ekleneceğini belirten içeriğe dikkat edin.

SQL kullanarak şema eklemek, güncelleştirmek veya kaldırmak için Databricks Runtime 13.3 LTS veya üzerini çalıştıran bir SQL ambarı veya işlem gerekir. Katalog Gezgini'ni kullanarak aynı işlemi yapmak için işlem gereksinimi yoktur.

Sınırlama

• Desteklenmeyen veri varlıkları içerseler bile şemaları paylaşabilirsiniz. Bu varlıklar filtrelenir ve alıcılarla paylaşılmaz. Desteklenmeyen veri varlıkları şunları içerir:

  • Bölüm filtreleme ile sıvı kümeleme kullanan tablolar
  • V2 denetim noktası ile R2 tabloları
  • Harmanlamaların etkinleştirildiği tablolar
  • Satır filtreleri veya sütun maskeleri olan tablolar
  • SHALLOW CLONE Tablolar
  • Paylaşılan tablolardaki yabancı anahtar kısıtlamaları

• Bir şemanın tamamını paylaşırsanız tablo takma adları, bölümlemeler ve birim takma adları kullanılamaz. Şemadaki herhangi bir varlık için diğer adlar veya bölümler oluşturduysanız, tüm şemayı paylaşıma eklediğinizde bunlar kaldırılır.

• Şemadaki bir tablo veya birim için gelişmiş seçenekler belirtmek istiyorsanız, SQL kullanarak tabloyu veya birimi paylaşmalı ve tabloya veya birime farklı bir şema adına sahip bir diğer ad vermelisiniz.

• Şema düzeyinde ad kullanımı desteklenmez. Farklı kataloglardan aynı isimdeki şemalar aynı paylaşıma eklenemez. Bunun yerine, takma adlı şema adlarıyla tek tek tabloları paylaşın.

Paylaşıma ABAC ilkeleriyle güvenliği sağlanan tablolar ve şemalar ekleme

Important

Bu özellik Genel Önizlemededir.

Attribute tabanlı erişim denetimi (ABAC) Azure Databricks genelinde esnek, ölçeklenebilir ve merkezi erişim denetimi sağlayan bir veri idare modelidir.

Standart tablolar gibi ABAC ilkeleri tarafından güvenliği sağlanan bir tabloyu veya şemayı paylaşabilirsiniz. Veri varlıklarınıza ABAC ilkelerini uygulamayı öğrenmek için bkz. Öznitelik tabanlı erişim denetimi (ABAC) ilkeleri oluşturma ve yönetme.

Ancak, ayrıcalıklı bir kullanıcı olmanız gerekir. Ayrıcalıklı kullanıcı, paylaşım sahibi ve veri varlığına uygulanan ABAC ilkelerinin dışında tutulan bir kullanıcıdır. İlke, alıcının erişimini yönetmez. Alıcıların paylaşılan varlığa tam erişimi vardır. ABAC sınırlamaları geçerlidir.

Paylaşıma akış tabloları ekleme

Akış tabloları, akış veya artımlı veri işleme için ek destek içeren normal Delta tablolarıdır. Akış tabloları yalnızca ekleme veri kaynakları için tasarlanmıştır ve girişleri yalnızca bir kez işler. Bkz. Databricks SQL'de akış tablolarını kullanma.

Paylaşıma akış tabloları eklemeden önce gereksinimleri karşıladığınızdan emin olun.

Ek gereksinimler

• Çalışma alanınızda çalışma alanı-katalog bağlamaları etkinleştirildiyse, çalışma alanının akış tablosunun içinde yer aldığı kataloğa okuma ve yazma erişimi olup olmadığını denetleyin. Daha fazla bilgi için bkz. Katalog erişiminibelirli çalışma alanlarıyla sınırlama.
• Paylaşılabilir akış tabloları Delta tablolarında veya diğer paylaşılabilir akış tablolarında veya görünümlerinde tanımlanmalıdır.
• Bir akış tablosunu paylaşıma eklerken Databricks Runtime 13.3 LTS veya üstünde bir SQL ambarı veya bir işlem kullanmanız gerekir.

Sınırlamalar

• Akış tablosunda satır filtreleri ve sütun maskeleri olamaz.
  • Akış tablosunun temel tablosunda satır filtreleri ve sütun maskeleri olabilir.
• Akış tablosunda bölüm filtreleri olamaz. Bunun yerine akış tablosunun üzerinde bir görünüm oluşturun.
• Açık paylaşım alıcıları yalnızca akış tablosunun geçerli anlık görüntüsünü okuyabilir. Zaman yolculuğu, sorgu geçmişi, akış okumaları ve CDF açık alıcılar için desteklenmez. Alıcılarınızın CDF'ye ihtiyacı varsa, CDF'nin etkin olduğu normal bir Delta tablosunu paylaşın.
• Alıcının temel alınan verilere doğrudan erişimi yoksa yan LIMIT tümceler ve koşul gönderimi desteklenmez. Sistem, sorgu filtrelerinden bağımsız olarak tüm sorgu sonuçlarını alıcıya döndürmeden önce tamamen gerçekleştirir. Bkz. Alıcıların paylaşılan görünümlerdeki, gerçekleştirilmiş görünümlerdeki ve akış tablolarındaki temel verilere doğrudan erişimi var mı?.
• Akış tabloları için genel sınırlamalar da geçerlidir. Bkz . Akış tablosu sınırlamaları.

Akış tablolarını alıcıyla paylaşma

Paylaşıma akış tabloları eklemek için:

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde akış tablosu eklemek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları Yönet > Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, paylaşmak istediğiniz akış tablosunu arayın veya tabloya göz atın ve seçin.

6. (İsteğe bağlı) Diğer Ad sütununda Akış tablosu adını daha okunabilir hale getirmek için bir diğer ad veya alternatif akış tablosu adı belirtin. Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır. Eğer bir diğer ad belirtilirse, alıcılar gerçek akış tablosu adını kullanamaz.

7. Kaydet'e tıklayın.

SQL

Aşağıdaki komutu bir not defterinde veya Databricks SQL sorgu düzenleyicisinde çalıştırın.

ALTER SHARE <share_name> ADD TABLE <st_name> [COMMENT <comment>] [AS <shared_st_name>];

CLI

Aşağıdaki Databricks CLI komutunu çalıştırın.

databricks shares update <share-name> \
  --json '{
    “updates”: [
      {
        “action”: “ADD”,
        “data_object”: {
          “name”: “<st-full-name>",
          “data_object_type”: “TABLE”,
          “comment”: “<comment>”
        }
      }
    ]
  }'

Akış tablolarını bir paylaşımdan kaldırma hakkında bilgi için bkz. Paylaşımları güncelleştirme.

Bir paylaşıma yönetilen Iceberg tabloları ekleme

Important

Bu özellik Genel Önizlemededir.

Apache Iceberg, analiz iş yükleri için açık kaynak bir tablo biçimidir. Azure Databricks'te, Unity Catalog'da Iceberg tablolar oluşturabilir ve bunlara yönetilen Iceberg tablolar adı verilebilir.

Yönetilen Iceberg tablolarını bir paylaşıma eklemeden önce gereksinimleri karşıladığınızı kontrol edin. Iceberg tablosu ve yönetilen Iceberg tablosu sınırlamaları geçerlidir. Bkz. Iceberg tablo sınırlamaları.

Note

Azure Databricks, yönetilen Iceberg tablolarını dış Iceberg istemcilerine paylaşmayı desteklemez.

Bir paylaşıma yönetilen Iceberg tabloları eklemek için:

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benim paylaştığım sekmesinde, yönetilen Iceberg tablosu eklemek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları Yönet>Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, paylaşmak istediğiniz yönetilen Iceberg tablosunu arayın veya bu tabloyu seçin.

6. (İsteğe bağlı) Diğer Ad sütununda Adı daha okunabilir hale getirmek için bir diğer ad veya alternatif yönetilen Iceberg tablo adı belirtin. Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır. Diğer ad belirtilirse alıcılar gerçek yönetilen Iceberg tablo adını kullanamaz.

7. Kaydet'e tıklayın.

SQL

Aşağıdaki komutu bir not defterinde veya Databricks SQL sorgu düzenleyicisinde çalıştırın. İsteğe bağlı olarak, yönetilen Iceberg tablosunu farklı bir adla kullanıma açmak için belirtin <shared_iceberg_table_name> .

ALTER SHARE <share_name> ADD TABLE <managed_iceberg_name> [COMMENT <comment>] [AS <shared_iceberg_table_name>];

CLI

Aşağıdaki Databricks CLI komutunu çalıştırın.

databricks shares update <share-name> \
  --json '{
    “updates”: [
      {
        “action”: “ADD”,
        “data_object”: {
          “name”: “<managed-iceberg-full-name>",
          “data_object_type”: “TABLE”,
          “comment”: “<comment>”
        }
      }
    ]
  }'

Paylaşıma yabancı şemalar veya tablolar ekleme

Important

Bu özellik Beta sürümündedir. Çalışma alanı yöneticileri Bu özelliğe erişimi Önizlemeler sayfasından denetleyebilir. Bkz. Azure Databricks önizlemelerini yönetme.

Lakehouse Federation, dış veri kaynaklarına yönelik sorgular çalıştırmak için Azure Databricks kullanmanızı sağlar. Unity Kataloğu'nun bu tabloları sorgulamak için veri idaresi eklemesiyle dış sistemler tarafından yönetilen verileri ve meta verileri içeren yabancı şemalar ve tablolar oluşturabilirsiniz. Dış kaynaklara bağlanma hakkında daha fazla bilgi edinmek için bkz. Lakehouse Federasyonu nedir?.

Delta Sharing, verileri Azure Databricks, karmaşık ağ kurulumlarına veya kimlik bilgileri aktarımlarına kopyalamadan yabancı verileri özgün konumundan güvenli bir şekilde paylaşmanızı sağlar.

Paylaşıma yabancı şemalar veya tablolar eklemeden önce gereksinimleri karşıladığınızdan denetleyin.

Ek gereksinimler

• Hesap düzeyi Önizlemelerinizde Lakehouse Federasyon Paylaşımı'nı etkinleştirmeniz gerekir. Bkz. Azure Databricks önizlemelerini yönetme.

• Yabancı şema veya yabancı tablo paylaşımının ayarlandığı hesapta iş akışları, not defterleri ve Lakeflow Spark Bildirimli İşlem Hatları için Sunucusuz işlemi etkinleştirmeniz gerekir. Bkz. Sunucusuz bilişime bağlanma.

• Yabancı şemaları ve tabloları paylaşırken veriler sorgulanır ve sağlayıcı tarafında geçici olarak gerçekleştirilir. Varsayılan olarak, gerçekleştirilmiş veriler Azure Databricks default storage kullanılarak gizli bir şemada depolanır. Gereksinimleri karşıladığınızdan emin olun ve varsayılan depolama için sınırlamaları gözlemleyin.

  Varsayılan depolama bölgesel kullanılabilirliği hakkında ayrıntılı bilgi için bkz. Sunucusuz kullanılabilirlik.

  Varsayılan Azure Databricks depolamanın kullanımından vazgeçmek ve geçici materyalizasyon için kendi depolama alanınızı kullanmak üzere bir destek talebi açın.

  Important

  Gerçekleştirilemeyecek kadar büyük yabancı tablolar paylaşılamaz. Gerçekleştirme sınırları aşarsa sorgu başarısız olur.

• Varsayılan depolamayı kullanmayı seçerseniz, Hesap düzeyinde Varsayılan Depolama – Genişletilmiş Erişim için Delta Paylaşımı önizlemesini etkinleştirmeniz gerekir. Bkz. Azure Databricks önizlemelerini yönetme.

Sınırlama

• Paylaşılan yabancı tablolar LIMIT yan tümceleri veya koşul geçirmeyi desteklemez. Sistem, sorgu filtrelerinden bağımsız olarak tüm sorgu sonuçlarını alıcıya iletmeden önce tamamen oluşturur.

Önerilen kullanım desenleri

Sorgu sonuçları her sorgu için isteğe bağlı olarak oluşturulur, bu nedenle yabancı tablo ve şema paylaşımı, tabloları veya gerçekleştirilmiş görünümleri paylaşmaya kıyasla uygun maliyetli olmayabilir. Azure Databricks performansı geliştirmek için aşağıdakileri önerir:

• Tipik sorgu sonuçlarının boyutunu 10 GB'tan az tutun.
• Sık veri dökümleri yerine geçici keşif sorguları kullanın.
• Bulut belirteci paylaşımını kullanırken, maliyet verimliliği ve daha iyi performans için yabancı tabloların üzerinde oluşturulan gerçekleştirilmiş görünümleri paylaşmayı göz önünde bulundurun.

Yabancı şemayı veya tabloyu alıcıyla paylaşma

Paylaşıma yabancı şemalar veya tablolar eklemek için, Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini, Databricks Unity Kataloğu CLI veya SQL komutlarını kullanın.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, yabancı tablo veya şema eklemek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları Yönet > Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, paylaşmak istediğiniz yabancı tablo veya şemayı arayın veya göz atın ve seçin.

6. (İsteğe bağlı) Diğer Ad sütununda Yabancı şemayı veya tablo adını daha okunabilir hale getirmek için bir diğer ad veya alternatif yabancı şema veya tablo adı belirtin. Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır. Eğer bir diğer ad belirtilmişse, alıcılar gerçek yabancı şemayı veya tablo adını kullanamaz.

7. Kaydet'e tıklayın.

SQL

ALTER SHARE <share-name>
  ADD {TABLE | SCHEMA} {federated_catalog.federated_schema.federated_table | federated_catalog.federated_schema}
  [COMMENT "<comment>"]
  [AS <alias>];

Seçenekler şunlardır:

• AS <alias>: Veri varlığı adını daha okunabilir hale getirmek için alternatif bir ad veya takma ad. Alıcının gördüğü ve sorgularda kullanması gereken veri varlığı adına diğer ad denir. Diğer ad belirtilirse alıcılar gerçek adı kullanamaz. <catalog-name>.<schema-name>.<view-name> biçimini kullanın.
• COMMENT "<comment>": Açıklamalar Katalog Gezgini kullanıcı arabiriminde ve SQL deyimlerini kullanarak veri varlığı ayrıntılarını listeleyip görüntülediğinizde görüntülenir.

ALTER SHARE seçenekleri hakkında daha fazla bilgi için bkz. ALTER SHARE.

CLI

databricks shares update <share-name> \
  --json '{
    “updates”: [
      {
        “action”: “ADD”,
        “data_object”: {
          “name”: “<federated-data-asset-full-name>",
          “data_object_type”: “{TABLE | SCHEMA}”,
          "shared_as": "<foreign-data-asset-alias>",
          “comment”: “<comment>”
        }
      }
    ]
  }'

Paylaşıma yabancı Iceberg tabloları ekleme

Important

Bu özellik Genel Önizlemededir.

Yabancı Buzdağı tabloları, Lakehouse Federasyonu kullanılarak yabancı Iceberg kataloglarından birleştirilmiş tablolardır. Azure Databricks Apache Iceberg tabloları hakkında daha fazla bilgi edinmek için bkz. Azure Databricks?'da Apache Iceberg nedir?

Başlamadan önce genel gereksinimleri karşılayıp karşılamadığınızı ve bir paylaşım oluşturduğunuzu denetleyin. Ayrıca dış Iceberg istemcilerini kullanarak yabancı Iceberg tablolarını alıcılarla paylaşabilirsiniz. Daha fazla bilgi için bkz. Dış Iceberg istemcilerine paylaşımı etkinleştirme.

Note

Alıcıların en yeni verileri aldığını doğrulamak için yabancı Iceberg tablolarınızı düzenli aralıklarla yenileyin. Herhangi bir SELECT sorgu veya REFRESH TABLE komut tablo meta verilerini yeniler.

Databricks, Azure Databricks üzerindeki yabancı Iceberg tablosunun uzak Iceberg kaynağıyla eşitlenmiş durumda kalması için zamanlanmış bir iş ayarlamanızı önerir. Yenilemeleri zamanlama hakkında daha fazla bilgi için bkz. Bir sorgu zamanlayın.

Ek gereksinimler

• Lakehouse Federasyon Paylaşımı önizlemesini hesap düzeyinde etkinleştirmeniz gerekir. Bkz. Azure Databricks önizlemelerini yönetme.
• Iceberg istemcilerini kullanmayan açık alıcılarla yabancı Iceberg tablolarını paylaşıyorsanız varsayılan depolamayı kullanmanız gerekir. Varsayılan Depolama – Genişletilmiş Erişim önizlemesi için Delta Paylaşımı'nı hesap düzeyinde etkinleştirmeniz gerekir. Bkz. Azure Databricks önizlemelerini yönetme.
• Iceberg istemcilerini kullanmayan açık alıcılarla paylaşım yaparken, paylaşılan veriler önce işlem ve depolama alanınız kullanılarak filtrelenip gerçekleştirilir. Ek maliyetler doğurabilirsiniz. Daha fazla bilgi için bkz . Delta Sharing maliyetlerini nasıl karşılayıp denetleyebilirim? ve Alıcıların paylaşılan görünümlerdeki, gerçekleştirilmiş görünümlerdeki ve akış tablolarındaki temel verilere doğrudan erişimi var mı?.
• Yabancı Iceberg tablolarında Delta Uniform etkinleştirilmelidir. Tekdüzen etkinleştirilmediyse, tablo paylaşıma eklenemez. Bkz. Iceberg istemcileri ile Delta tablolarını okuma.

Sınırlama

• Bölümler desteklenmez.
• Iceberg istemcisi kullanmayan açık alıcılarla paylaşım yaparken LIMIT klausüler ve koşul itme desteklenmez. Sistem, sorgu filtrelerinden bağımsız olarak tüm sorgu sonuçlarını alıcıya sunmadan önce daima tamamen tamamlar.

Paylaşıma yabancı bir Iceberg tablosu ekleme

Yabancı Iceberg tabloları otomatik olarak tüm geçmiş verileriyle paylaşılır.

Paylaşıma yabancı bir Iceberg tablosu eklemek için:

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, yabancı bir Iceberg tablosu eklemek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları Yönet>Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, paylaşmak istediğiniz yabancı Iceberg tablosunu arayın veya bu tabloyu seçin.

6. (İsteğe bağlı) Diğer Ad sütununda Diğer ad belirtmek için. Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır.

7. Kaydet'e tıklayın.

SQL

Aşağıdaki komutu bir not defterinde veya Databricks SQL sorgu düzenleyicisinde çalıştırın. İsteğe bağlı olarak, yabancı Iceberg tablosunun farklı bir adla görünmesini sağlamak için <shared_table_name> belirtin.

ALTER SHARE <share_name> ADD TABLE <foreign_iceberg_table_name> [COMMENT <comment>] [AS <shared_table_name>];

CLI

Aşağıdaki Databricks CLI komutunu çalıştırın.

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<foreign-iceberg-table-full-name>",
          "data_object_type": "TABLE",
          "comment": "<comment>"
        }
      }
    ]
  }'

Paylaşıma görünüm ekleme

Görünümler, bir veya daha fazla tablodan veya diğer görünümlerden oluşturulan salt okunur nesnelerdir. Görünüm, Unity Kataloğu meta veri deposundaki birden çok şema ve katalogda yer alan tablolardan ve diğer görünümlerden oluşturulabilir. Bkz. Görünüm oluşturma ve yönetme.

Görünümler paylaşılırken veriler sorgulanır ve geçici olarak oluşturulur. Gerçekleştirilmiş veriler, görünümün ana şeması veya kataloğunun depolama konumunda veya meta veri deposu kök konumunda depolanır.

Paylaşıma görünüm eklemeden önce gereksinimleri karşıladığınızdan denetleyin.

Ek gereksinimler

• Paylaşılabilir görünümler Delta tablolarında, diğer paylaşılabilir görünümlerde veya yerel gerçekleştirilmiş görünümlerde ve akış tablolarında tanımlanmalıdır. Paylaşılabilir görünümler yabancı tablolarda tanımlanamaz.
• Bir paylaşıma görünüm eklerken Databricks Runtime 13.3 LTS veya üzeri bir sql ambarı veya işlem kullanmanız gerekir.
• Çalışma alanınızda çalışma alanı kataloğu bağlamaları etkinleştirildiyse, çalışma alanının kataloğa okuma ve yazma erişimi olup olmadığını denetleyin. Daha fazla bilgi için bkz. Katalog erişiminibelirli çalışma alanlarıyla sınırlama.
• Görünümleri paylaşırken, veriler alıcının işlem türüne ve hesap ilişkisine bağlı olarak sağlayıcı tarafında sorgulanabilir ve geçici olarak gerçekleştirilebilir. Gerçekleştirilmiş veriler, görünümün ana şeması veya kataloğunun depolama konumunda veya meta veri deposu kök konumunda depolanır. Gerçekleştirmenin ne zaman gerçekleştiği ve bunun için kimin ödeme yaptığı hakkında ayrıntılı bilgi için bkz. Alıcıların paylaşılan görünümlerdeki, gerçekleştirilmiş görünümlerdeki ve akış tablolarındaki temel verilere doğrudan erişimi var mı? ve Delta Sharing maliyetlerini nasıl karşılayıp denetleyebilirim?.
• Depolama konumu güvenlik duvarı veya özel bağlantı gibi özel ağ yapılandırmalarına sahipse, alıcılarınızın depolama konumuna bağlanmasına izin verilenler listesine eklendiğini doğrulamanız gerekir. Sunucusuz işlem için güvenlik duvarı kurallarını yapılandırma yönergeleri için bkz. Sunucusuz işlem erişimi (eski) için güvenlik duvarı yapılandırma.

Sınırlama

• Paylaşılan tablolara veya paylaşılan görünümlere referans veren görünümleri paylaşamazsınız.
• Yabancı tabloları referans alan görünümleri, yabancı Iceberg tabloları da dahil, paylaşamazsınız.
• Alıcının temel alınan verilere doğrudan erişimi yoksa LIMIT kural tümceleri ve koşul itelemesi desteklenmez. Sistem, sorgu filtrelerinden bağımsız bir şekilde tüm sorgu sonuçlarını alıcıya teslim etmeden önce tamamen oluşturur. Bkz. Alıcıların paylaşılan görünümlerdeki, gerçekleştirilmiş görünümlerdeki ve akış tablolarındaki temel verilere doğrudan erişimi var mı?.

Görünümleri alıcıyla paylaşma

Bu bölümde, bir Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini, Databricks CLI veya SQL komutlarını kullanarak bir paylaşıma nasıl görünüm ekleneceği açıklanmaktadır. Unity Kataloğu REST API'sini kullanmayı tercih ediyorsanız REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ bölümüne bakın.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, görünüm eklemek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları yönet > Veri varlıklarını ekle'ye tıklayın.

5. Tablo ekle sayfasında, paylaşmak istediğiniz görünümü arayın veya bu görünüme göz atın ve seçin.

6. (İsteğe bağlı) Alternatif bir görünüm adı belirtmek için Diğer Ad sütununun altında veya görünüm adını daha okunabilir hale getirmek için Diğer Ad'a tıklayın. Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır. Takma ad belirtilirse alıcılar gerçek görünüm adını kullanamaz.

7. Kaydet'e tıklayın.

SQL

Not defterinde veya Databricks SQL sorgu düzenleyicisinde aşağıdaki komutu çalıştırın:

ALTER SHARE <share-name> ADD VIEW <catalog-name>.<schema-name>.<view-name>
   [COMMENT "<comment>"]
   [AS <alias>];

Seçenekler şunlardır:

• AS <alias>: Görünüm adını daha okunabilir hale getirmek için alternatif bir görünüm adı veya diğer ad. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken görünüm adıdır. Takma ad belirtilirse alıcılar gerçek görünüm adını kullanamaz. <schema-name>.<view-name> biçimini kullanın.
• COMMENT "<comment>": Açıklamalar Katalog Gezgini kullanıcı arabiriminde ve SQL deyimlerini kullanarak görünüm ayrıntılarını listeleyip görüntülediğinizde görüntülenir.

ALTER SHARE seçenekleri hakkında daha fazla bilgi için bkz. ALTER SHARE.

CLI

Aşağıdaki Databricks CLI komutunu çalıştırın:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<view-full-name>",
          "data_object_type": "VIEW",
          "shared_as": "<view-alias>"
        }
      }
    ]
  }'

"shared_as": "<view-alias>" isteğe bağlıdır ve görünüm adını daha okunabilir hale getirmek için alternatif bir görünüm adı veya diğer ad sağlar. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken görünüm adıdır. Takma ad belirtilirse alıcılar gerçek görünüm adını kullanamaz. <schema-name>.<view-name> biçimini kullanın.

Ek parametreler hakkında bilgi edinmek için databricks shares update --help komutunu çalıştırın veya REST API başvurusundaki PATCH /api/2.1/unity-catalog/shares/ kısmına bakın.

Bir paylaşımdan görünümleri kaldırma hakkında bilgi için Paylaşımları güncelleştirme sayfasına bakın.

Satır ve sütunları filtrelemek için paylaşıma dinamik görünümler ekleme

Aşağıdakiler dahil olmak üzere tablo verilerine ayrıntılı erişim denetimi yapılandırmak için dinamik görünümleri kullanabilirsiniz:

• Sütun veya satır düzeyinde güvenlik.
• Veri maskeleme.

CURRENT_RECIPIENT() işlevini kullanan dinamik bir görünüm oluşturduğunuzda, alıcı erişimini alıcı tanımında belirttiğiniz özelliklere göre sınırlayabilirsiniz.

Bu bölümde, dinamik görünüm kullanarak hem satır hem de sütun düzeyinde tablo verilerine alıcı erişimini kısıtlama örnekleri sağlanır.

Requirements

• Paylaşıma görünüm ekleme gereksinimlerini karşıladığınızdan denetleyin.
• Databricks Runtime sürümü: CURRENT_RECIPIENT İşlev Databricks Runtime 14.2 ve üzeri sürümlerde desteklenir.

Sınırlamalar

• Görüntüleme paylaşımıyla ilgili tüm sınırlamalar geçerlidir.
• Sağlayıcı, CURRENT_RECIPIENT işlevini kullanan bir görünümü paylaştığında, paylaşım bağlamı nedeniyle sağlayıcı bu görünümü doğrudan sorgulayamaz. Böyle bir dinamik görünümü test etmek için sağlayıcının görünümü kendileriyle paylaşması ve görünümü alıcı olarak sorgulaması gerekir.
• Sağlayıcılar dinamik görünüme başvuran bir görünüm oluşturamaz.

Alıcı özelliğini ayarlama

Bu örneklerde, paylaşılacak tablonun adlı countrybir sütunu vardır ve yalnızca eşleşen country özelliği olan alıcılar belirli satırları veya sütunları görüntüleyebilir.

Azure Databricks not defterinde veya SQL sorgu düzenleyicisinde Katalog Gezgini veya SQL komutlarını kullanarak alıcı özelliklerini ayarlayabilirsiniz.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Alıcılar sekmesinde, özellikleri eklemek istediğiniz alıcıyı bulun ve adına tıklayın.

4. Sayfanın sağ alt tarafında, Alıcı özellikleri altında, Azure Databricks alıcısı için Pencil icon.databricks.metastoreID yanındaki veya açık bir alıcı için databricks.name yanındaki ne tıklayın.

5. Alıcı özelliklerini düzenle iletişim kutusunda, sütun adını anahtar olarak (bu örnektecountry) ve değer olarak filtrelemek istediğiniz değeri (örneğin, CA) girin.

6. Kaydet'e tıklayın.

SQL

Alıcının özelliğini ayarlamak için ALTER RECIPIENT kullanın. Bu örnekte özelliği country olarak CAayarlanmıştır.

ALTER RECIPIENT recipient1 SET PROPERTIES ('country' = 'CA');

Alıcılar için satır düzeyi izne sahip dinamik bir görünüm oluşturun

Bu örnekte, yalnızca eşleşen country özelliği olan alıcılar belirli satırları görüntüleyebilir.

CREATE VIEW my_catalog.default.view1 AS
  SELECT * FROM my_catalog.default.my_table
  WHERE country = CURRENT_RECIPIENT('country');

Bir diğer seçenek de veri sağlayıcısının olgu tablosu alanlarını alıcı özelliklerine eşleyen ayrı bir eşleme tablosu bulundurmasıdır. Bu, daha fazla esneklik için alıcı özelliklerinin ve olgu tablosu alanlarının ayrıştırılmasına olanak tanır.

Alıcılar için sütun düzeyinde izinle dinamik görünüm oluşturma

Bu örnekte, yalnızca özelliğiyle country eşleşen alıcılar belirli sütunları görüntüleyebilir. Diğerleri döndürülen verileri olarak REDACTEDgörür:

CREATE VIEW my_catalog.default.view2 AS
  SELECT
  CASE
    WHEN CURRENT_RECIPIENT('country') = 'US' THEN pii
    ELSE 'REDACTED'
  END AS pii
  FROM my_catalog.default.my_table;

Dinamik görünümü alıcıyla paylaşma

Dinamik görünümü bir alıcıyla paylaşmak için, standart görünümde kullandığınız SQL komutlarını veya kullanıcı arabirimi yordamını kullanın. Bkz. Paylaşıma görünüm ekleme.

Paylaşıma materyalize görünümler ekleyin

Gerçekleştirilmiş görünümler de görünümler gibi bir sorgunun sonuçlarıdır ve onlara tablo gibi erişebilirsiniz. Normal görünümlerden farklı olarak, gerçekleştirilmiş görünümün sonuçları, gerçekleştirilmiş görünümün en son yenilendiği verilerin durumunu yansıtır. Gerçekleştirilmiş görünümler hakkında daha fazla bilgi için bkz. Databricks SQL'de gerçekleştirilmiş görünümleri kullanma.

Paylaşıma maddi görünümler eklemeden önce gereksinimleri karşıladığınızdan emin olun.

Ek gereksinimler

• Çalışma alanınızda çalışma alanı kataloğu bağlamaları etkinleştirildiyse, çalışma alanının gerçekleştirilmiş görünümü içeren kataloğa okuma ve yazma erişimi olup olmadığını denetleyin. Daha fazla bilgi için bkz. Katalog erişiminibelirli çalışma alanlarıyla sınırlama.
• Paylaşılabilir gerçekleştirilmiş görünümler Delta tablolarında veya diğer paylaşılabilir akış tablolarında, görünümlerde veya gerçekleştirilmiş görünümlerde tanımlanmalıdır.
• Bir paylaşıma maddileştirilmiş görünüm eklerken Databricks Runtime 13.3 LTS veya üzeri bir SQL deposu veya hesaplama birimi kullanmanız gerekir.

Sınırlamalar

• Gerçekleştirilmiş görünümde satır filtreleri olamaz, ancak gerçekleştirilmiş görünümün temel tablosunda satır filtreleri ve sütun maskeleri olabilir.
• Gerçekleştirilmiş görünümde bölüm filtreleri olamaz. Bunun yerine, maddesel görünümün üzerinde bir görünüm oluşturun.
• Açık paylaşım alıcıları yalnızca malzeme edilmiş görünümün mevcut anlık görüntüsünü okuyabilir. Akış okuma işlemleri açık alıcılar için desteklenmez.
• Alıcının alttaki verilere doğrudan erişimi yoksa LIMIT tümceler ve predikat gönderimi desteklenmez. Sistem, sorgu filtrelerinden bağımsız olarak tüm sorgu sonuçlarını alıcıya döndürmeden önce tamamen gerçekleştirir. Bkz. Alıcıların paylaşılan görünümlerdeki, gerçekleştirilmiş görünümlerdeki ve akış tablolarındaki temel verilere doğrudan erişimi var mı?.
• Gerçekleştirilmiş görünümler için genel sınırlamalar da geçerlidir. Bkz . Gerçekleştirilmiş görünüm sınırlamaları.

Gerçekleştirilmiş görünümleri alıcıyla paylaşma

Bu bölümde, bir Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini, Databricks CLI veya SQL komutlarını kullanarak bir paylaşıma gerçekleştirilmiş görünümlerin nasıl ekleneceği açıklanmaktadır. REST API'yi kullanmayı tercih ediyorsanız REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ bölümüne bakın.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benim paylaştıklarım sekmesinde, materyalize görünüm eklemek istediğiniz paylaşımı bulun ve paylaşımın adına tıklayın.

4. Varlıkları Yönet > Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, paylaşmak istediğiniz gerçekleştirilmiş görünümü arayın veya bulun ve seçin.

6. (İsteğe bağlı) Diğer Ad sütununda Gerçekleştirilmiş görünüm adını daha okunabilir hale getirmek için bir diğer ad veya alternatif gerçekleştirilmiş görünüm adı belirtin. Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır. Takma ad belirtildiğinde alıcılar maddileştirilmiş görünüm adını kullanamaz.

7. Kaydet'e tıklayın.

SQL

Aşağıdaki komutu bir not defterinde veya Databricks SQL sorgu düzenleyicisinde çalıştırın.

ALTER SHARE <share_name> ADD MATERIALIZED VIEW <mv_name> [COMMENT <comment>] [AS <shared_mv_name>];

CLI

databricks shares update <share-name> \
  --json '{
    “updates”: [
      {
        “action”: “ADD”,
        “data_object”: {
          “name”: “<mat-view-full-name>”,
          “data_object_type”: “MATERIALIZED_VIEW”,
          “comment”: “<comment>”
        }
      }
    ]
  }'

Bir paylaşımdan maddileştirilmiş görünümlerini kaldırma hakkında bilgi için bkz. Paylaşımları Güncelleştir.

Paylaşıma birim ekleme

Birimler, bulut nesne depolama konumundaki mantıksal depolama birimini temsil eden Unity Kataloğu nesneleridir. Bunlar öncelikli olarak tablosal olmayan veri varlıkları üzerinde idare sağlamak için tasarlanmıştır. Bkz Unity Kataloğu birimleri nelerdir?.

Paylaşıma birim eklemeden önce gereksinimleri karşıladığınızdan emin olmak için kontrol edin.

Ek gereksinimler

• Hacim paylaşımı yalnızca Databricks'ten Databricks'e paylaşımda desteklenir.
• Bir paylaşıma birim eklerken SQL ambarının 2023.50 veya üzeri bir sürümünü veya Databricks Runtime 14.1 ya da üzeri bir sürümde hesaplama kaynağını kullanmanız gerekir.
• Sağlayıcı tarafındaki birim depolama alanı özel ağ yapılandırmalarına (güvenlik duvarı veya özel bağlantı gibi) sahipse, sağlayıcının alıcının veri düzlemi adreslerinin birimin depolama konumuna bağlanabilmesi için düzgün izin verilenler listesine eklendiğini doğrulaması gerekir. Katalog Gezgini, alıcı tarafında birimleri doğru görüntüleyemeyebilir.

Note

Birim açıklamaları, 25 Temmuz 2024 veya sonrasında Databricks-to-Databricks paylaşımı kullanılarak bir alıcıyla paylaşılan paylaşımlara eklenir. Yayın tarihinden önce bir alıcıyla paylaşılan bir paylaşım aracılığıyla açıklama paylaşmaya başlamak istiyorsanız, açıklama paylaşımını tetikleyebilmek için alıcı erişimini iptal edip yeniden vermelisiniz.

Alıcıyla hacimleri paylaş

Bu bölümde, bir Azure Databricks not defterindeki veya SQL sorgu düzenleyicisindeki Katalog Gezgini, Databricks CLI veya SQL komutlarını kullanarak paylaşıma birim ekleme açıklanmaktadır. Unity Kataloğu REST API'sini kullanmayı tercih ediyorsanız REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ bölümüne bakın.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, birim eklemek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları Yönet > Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, paylaşmak istediğiniz hacmi arayın veya gezinerek bulun ve seçin.

   Alternatif olarak, birimi içeren şemanın tamamını seçebilirsiniz. Bkz. Paylaşıma şema ekleme.

6. (İsteğe bağlı) tıklayın. Diğer ad sütununun altında, birim adını daha okunabilir hale getirmek için alternatif bir birim adı veya Diğer Ad belirtin.

   Şemanın tamamını seçerseniz takma adlar kullanılamaz.

   Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır. Diğer ad belirtilirse, alıcılar gerçek birim adını kullanamaz.

7. Kaydet'e tıklayın.

SQL

Not defterinde veya Databricks SQL sorgu düzenleyicisinde aşağıdaki komutu çalıştırın:

ALTER SHARE <share-name> ADD VOLUME <catalog-name>.<schema-name>.<volume-name>
   [COMMENT "<comment>"]
   [AS <alias>];

Seçenekler şunlardır:

• AS <alias>: Birim adını daha okunabilir hale getirmek için alternatif bir ad veya takma ad. Takma ad, alıcının gördüğü ve sorgularda kullanması gereken cilt adıdır. Başka bir ad belirtilirse, alıcılar gerçek birim adını kullanamaz. <schema-name>.<volume-name> biçimini kullanın.
• COMMENT "<comment>": Açıklamalar Katalog Gezgini kullanıcı arabiriminde ve SQL deyimlerini kullanarak birim ayrıntılarını listeleyip görüntülediğinizde görüntülenir.

ALTER SHARE seçenekleri hakkında daha fazla bilgi için bkz. ALTER SHARE.

CLI

Databricks CLI 0.210 veya üzerini kullanarak aşağıdaki komutu çalıştırın:

 databricks shares update <share-name> \
   --json '{
     "updates": [
       {
         "action": "ADD",
         "data_object": {
           "name": "<volume-full-name>",
           "data_object_type": "VOLUME",
           "string_shared_as": "<volume-alias>"
         }
       }
     ]
   }'

"string_shared_as": "<volume-alias>" isteğe bağlıdır ve birim adını daha okunabilir hale getirmek için alternatif bir birim adı veya diğer ad sağlar. Takma ad, alıcının gördüğü ve sorgularda kullanması gereken cilt adıdır. Başka bir ad belirtilirse, alıcılar gerçek birim adını kullanamaz. <schema-name>.<volume-name> biçimini kullanın.

Ek parametreler hakkında bilgi edinmek için databricks shares update --help komutunu çalıştırın veya REST API başvurusundaki PATCH /api/2.1/unity-catalog/shares/ kısmına bakın.

Paylaşımdan birimleri kaldırma hakkında bilgi için bkz: Paylaşımları güncelleştirme.

Bir paylaşıma Python UDF'leri ekleme

Kullanıcı tanımlı işlevler (UDF) Azure Databricks yerleşik işlevselliğini genişleten kodu yeniden kullanmanıza ve paylaşmanıza olanak tanır. Python UDF'leri oluşturmayı öğrenmek için bkz. User tanımlı skaler işlevler - Python.

Paylaşıma Python UDF'leri eklemeden önce gereksinimleri karşıladığınızı kontrol edin.

Ek sınırlamalar

• Python UDF'leri açık bir alıcıyla paylaşamazsınız.

Python UDF'leri alıcıyla paylaşma

Bu bölümde, Azure Databricks not defteri veya SQL sorgu düzenleyicisinde Katalog Gezgini, Databricks CLI veya SQL komutlarını kullanarak paylaşıma Python UDF'lerinin nasıl ekleneceği açıklanmaktadır. Unity Kataloğu REST API'sini kullanmayı tercih ediyorsanız REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ bölümüne bakın.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Shared by me sekmesinde, Python UDF eklemek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları Yönet > Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, paylaşmak istediğiniz Python UDF'yi arayıp seçin.

   Alternatif olarak, Python UDF'yi içeren tüm şemayı seçebilirsiniz. Bkz. Paylaşıma şema ekleme.

6. (İsteğe bağlı) alternatif bir Python UDF adı belirtmek için Speech bubble plus icon. öğesine veya Alias sütununun altında Alias tıklayın. Python UDF adını daha okunabilir hale getirmek için alternatif bir ad olarak Alias seçin.

   Şemanın tamamını seçerseniz takma adlar kullanılamaz.

   Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır. Diğer ad belirtilirse, alıcılar gerçek Python UDF adını kullanamaz.

7. Kaydet'e tıklayın.

SQL

Bir not defterinde veya Databricks SQL sorgu düzenleyicisinde kullanan ADD MODELaşağıdaki komutu çalıştırın:

ALTER SHARE <share-name> ADD MODEL <catalog-name>.<schema-name>.<python-udf-name>
   [AS <alias>];

Seçenekler şunlardır:

• AS <alias>: Python UDF adını daha okunabilir hale getirmek için alternatif bir Python UDF adı veya takma ad. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken Python UDF adıdır. Diğer ad belirtilirse alıcılar gerçek Python UDF adını kullanamaz. <schema-name>.<python-udf-name> biçimini kullanın.

ALTER SHARE seçenekleri hakkında daha fazla bilgi için bkz. ALTER SHARE.

CLI

Databricks CLI 0.210 veya üzerini kullanarak nesne türünü model olarak belirten aşağıdaki komutu çalıştırın:

 databricks shares update <share-name> \
   --json '{
     "updates": [
       {
         "action": "ADD",
         "data_object": {
           "name": "<python-udf-full-name>",
           "data_object_type": "MODEL",
           "string_shared_as": "<python-udf-alias>"
         }
       }
     ]
   }'

"string_shared_as": "<python-udf-alias>" isteğe bağlıdır ve Python UDF adını daha okunabilir hale getirmek için alternatif bir ad veya takma ad sağlar. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken Python UDF adıdır. Diğer ad belirtilirse alıcılar gerçek Python UDF adını kullanamaz. <schema-name>.<python-udf-name> biçimini kullanın.

Ek parametreler hakkında bilgi edinmek için databricks shares update --help komutunu çalıştırın veya REST API başvurusundaki PATCH /api/2.1/unity-catalog/shares/ kısmına bakın.

Paylaşıma ekleme FeatureSpecs

FeatureSpec, kullanıcı tanımlı bir özellik ve işlev kümesidir. Alıcılar, paylaşılan FeatureSpeciçinden Özellik Sunma Uç Noktası oluşturabilir. FeatureSpecs oluşturmayı öğrenmek için, Bir FeatureSpec Oluşturma bölümüne bakın.

Gereksinimleri karşıladığınızdan emin olun, sonra FeatureSpecs paylaşıma ekleyin.

Ek gereksinimler

• Tüm bağımlılıklar paylaşıma eklenmelidir. Kullanıcı arabirimini kullanarak FeatureSpec bir paylaşıma eklediğinizde, tüm bağımlılıkların paylaşıma otomatik olarak eklenmelidir.
• Modele bir bağımlılık eklenirse, bu bağımlılığın paylaşıma da eklenmesi gerekir.

Ek sınırlamalar

• Bu varlık başka bir modelin bağımlılığıysa, takma ad belirleyemezsiniz.
• Açık bir alıcıyla paylaşamazsınız FeatureSpecs .

Alıcıyla paylaşma FeatureSpecs

Bu bölümde, Azure Databricks not defteri veya SQL sorgu düzenleyicisinde Katalog Gezgini, Databricks CLI veya SQL komutlarını kullanarak paylaşıma FeatureSpecs nasıl ekleneceği açıklanmaktadır. Unity Kataloğu REST API'sini kullanmayı tercih ediyorsanız REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ bölümüne bakın.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benim paylaştıklarım sekmesinde FeatureSpec eklemek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları Yönet > Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, paylaşmak istediğiniz öğeyiFeatureSpec arayın veya göz atın ve seçin.

   Alternatif olarak, öğesini içeren FeatureSpecşemanın tamamını seçebilirsiniz. Bkz. Paylaşıma şema ekleme.

6. (İsteğe bağlı) Alternatif bir ad belirtmek için Diğer Ad sütunundaki FeatureSpec tıklayın veya adın daha okunabilir olmasını sağlamak amacıyla Diğer AdFeatureSpec belirleyin.

   Şemanın tamamını seçerseniz takma adlar kullanılamaz.

   Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır. Diğer ad belirtilirse, alıcılar gerçek FeatureSpec adı kullanamaz.

7. Herhangi bir bağımlılık varsa , Tüm bağımlılıkları ekle iletişim kutusu bunların otomatik olarak eklendiğini bildirir. Tüm bağımlılıkları ekle'ye tıklayın.

8. Kaydet'e tıklayın.

SQL

Bir not defterinde veya Databricks SQL sorgu düzenleyicisinde kullanan ADD MODELaşağıdaki komutu çalıştırın:

ALTER SHARE <share-name> ADD MODEL <catalog-name>.<schema-name>.<featurespec-name>
   [AS <alias>];

--Seçenekler şunlardır:

• AS <alias>: Adını daha okunabilir hale getirmek amacıyla FeatureSpec için alternatif bir ad veya takma ad. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken addır FeatureSpec . Diğer ad belirtilirse alıcılar gerçek FeatureSpec adı kullanamaz. <schema-name>.<featurespec-name> biçimini kullanın.

ALTER SHARE seçenekleri hakkında daha fazla bilgi için bkz. ALTER SHARE.

CLI

Databricks CLI 0.210 veya üzerini kullanarak nesne türünü model olarak belirten aşağıdaki komutu çalıştırın:

 databricks shares update <share-name> \
   --json '{
     "updates": [
       {
         "action": "ADD",
         "data_object": {
           "name": "<featurespec-full-name>",
           "data_object_type": "MODEL",
           "string_shared_as": "<featurespec-alias>"
         }
       }
     ]
   }'

"string_shared_as": "<volume-alias>" isteğe bağlıdır ve FeatureSpec adını daha okunabilir hale getirmek için FeatureSpec alternatif bir ad veya takma ad sağlar. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken addır FeatureSpec . Diğer ad belirtilirse alıcılar gerçek FeatureSpec adı kullanamaz. <schema-name>.<featurespec-name> biçimini kullanın.

Ek parametreler hakkında bilgi edinmek için databricks shares update --help komutunu çalıştırın veya REST API başvurusundaki PATCH /api/2.1/unity-catalog/shares/ kısmına bakın.

Paylaşıma model ekleme

Bir paylaşıma model eklemeden önce gereksinimleri karşıladığınızdan denetleyin.

Note

"Model açıklamaları ve model sürümü açıklamaları, Databricks-to-Databricks paylaşım yöntemi kullanılarak yapılan paylaşımlara dahil edilir."

Ek gereksinimler

• Model paylaşımı sadece Databricks'ten Databricks'e yapılan paylaşımlarda desteklenir.
• Bir modeli bir paylaşıma eklerken SQL ambarı versiyon 2023.50 veya üstü ya da Databricks Runtime 14.0 veya üstünde bir işlem kaynağı kullanmanız gerekmektedir.

Modelleri alıcıyla paylaşma

Bu bölümde, bir Azure Databricks not defterindeki veya SQL sorgu düzenleyicisindeki Katalog Gezgini, Databricks CLI veya SQL komutlarını kullanarak bir paylaşıma modellerin nasıl ekleneceği açıklanmaktadır. Unity Kataloğu REST API'sini kullanmayı tercih ediyorsanız REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ bölümüne bakın.

Bir paylaşıma model eklemek için:

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, model eklemek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Varlıkları Yönet > Varlıkları Düzenle'ye tıklayın.

5. Varlıkları düzenle sayfasında, paylaşmak istediğiniz modeli arayın veya bulun ve seçin.

   Alternatif olarak, modeli içeren şemanın tamamını seçebilirsiniz. Bkz. Paylaşıma şema ekleme.

6. (İsteğe bağlı) tıklayın. Diğer ad sütununun altında, model adını daha okunabilir hale getirmek için alternatif bir model adı veya Diğer Ad belirtin.

   Şemanın tamamını seçerseniz takma adlar kullanılamaz.

   Diğer ad, alıcının sorgularda gördüğü ve kullanması gereken addır. Eğer bir diğer ad belirtilirse, alıcılar gerçek model adını kullanamaz.

7. Kaydet'e tıklayın.

SQL

Not defterinde veya Databricks SQL sorgu düzenleyicisinde aşağıdaki komutu çalıştırın:

ALTER SHARE <share-name> ADD MODEL <catalog-name>.<schema-name>.<model-name>
   [COMMENT "<comment>"]
   [AS <alias>];

Seçenekler şunlardır:

• AS <alias>: Model adını daha okunabilir kılmak için alternatif bir model adı ya da takma ad. Diğer ad, alıcının gördüğü ve sorgularda kullanmak zorunda olduğu model adıdır. Eğer bir diğer ad belirtilirse, alıcılar gerçek model adını kullanamaz. <schema-name>.<model-name> biçimini kullanın.
• COMMENT "<comment>": Açıklamalar Katalog Gezgini kullanıcı arabiriminde ve SQL deyimlerini kullanarak model ayrıntılarını listeleyip görüntülediğinizde görüntülenir.

ALTER SHARE seçenekleri hakkında daha fazla bilgi için bkz. ALTER SHARE.

CLI

Databricks CLI 0.210 veya üzerini kullanarak aşağıdaki komutu çalıştırın:

 databricks shares update <share-name> \
   --json '{
     "updates": [
       {
         "action": "ADD",
         "data_object": {
           "name": "<model-full-name>",
           "data_object_type": "MODEL",
           "string_shared_as": "<model-alias>"
         }
       }
     ]
   }'

"string_shared_as": "<model-alias>" isteğe bağlıdır ve model adını daha okunabilir hale getirmek için alternatif bir model adı veya diğer ad sağlar. Diğer ad, alıcının gördüğü ve sorgularda kullanmak zorunda olduğu model adıdır. Eğer bir diğer ad belirtilirse, alıcılar gerçek model adını kullanamaz. <schema-name>.<model-name> biçimini kullanın.

Ek parametreler hakkında bilgi edinmek için databricks shares update --help komutunu çalıştırın veya REST API başvurusundaki PATCH /api/2.1/unity-catalog/shares/ kısmına bakın.

Bir paylaşımdan modelleri kaldırma hakkında bilgi için bkz Paylaşımları güncelleştirme.

Paylaşıma not defteri dosyaları ekleme

Bir paylaşıma not defteri dosyaları eklemeden önce gereksinimleri karşıladığınızdan denetleyin.

Paylaşıma not defteri dosyası eklemek için Katalog Gezgini'ni kullanın.

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.
2. Delta Paylaşımı > düğmesine tıklayın.
3. Benimle paylaşılan sekmesinde, not defteri eklemek istediğiniz paylaşımı bulun ve adına tıklayın.
4. Varlıkları yönet'e tıklayın ve Not defteri dosyası ekle'yi seçin.
5. Not defteri dosyası ekle sayfasında, paylaşmak istediğiniz not defterine göz atmak için dosya simgesine tıklayın.
   • Paylaşmak istediğiniz dosyaya tıklayın ve Seç'e tıklayın.
   • (İsteğe bağlı olarak) "Olarak paylaş" alanında dosya için kullanıcı dostu bir ad belirtin. Bu, alıcıların gördüğü tanımlayıcıdır.
   • Depolama konumualtında, not defterini depolamak istediğiniz bulut depolama alanında dış konum girin. Tanımlanan dış konumun altında bir alt yol belirtebilirsiniz. Dış konum belirtmezseniz, not defteri meta veri deposu düzeyinde depolama konumunda ("meta veri deposu kök konumu") depolanır. Meta veri deposu için hiçbir kök konum tanımlanmamışsa, buraya bir dış konum girmeniz gerekir. Var olan bir meta veritabanına yönetilen depolama ekleme özelliğini inceleyin .
6. Kaydet'e tıklayın.

Paylaşılan not defteri dosyası artık Varlıklar sekmesindeki Not Defteri dosyaları listesinde görünür.

Paylaşımlardan not defteri dosyalarını kaldırma

Not defteri dosyasını bir paylaşımdan kaldırmak için:

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, not defterini içeren paylaşımı bulun ve paylaşım adına tıklayın.

4. Varlıklar sekmesinde, paylaşımdan kaldırmak istediğiniz not defteri dosyasını bulun.

5. Satırın sağındaki kebap menüsüne tıklayın ve Not defteri dosyasını sil'i seçin.

6. Onay iletişim kutusunda Sil'e tıklayın.

Paylaşımlardaki not defteri dosyalarını güncelleştirme

Önceden paylaştığınız bir not defterini güncellemek için, not defterini yeniden ekleyerek Olarak Paylaş alanında yeni bir takma ad vermelisiniz. Databricks, not defterinin düzeltilmiş durumunu gösteren bir ad kullanmanızı önerir. Örneğin <old-name>-update-1, . Değişikliği alıcıya bildirmeniz gerekebilir. Alıcının güncelleştirmenizden yararlanmak için yeni not defterini seçip kopyalaması gerekir.

Dış Iceberg istemcilerine paylaşımı etkinleştirme

Important

Bu özellik Genel Önizlemededir.

Delta tablolarını, yabancı Iceberg tablolarını, görünümleri, gerçekleştirilmiş görünümleri ve akış tablolarını Apache Iceberg REST Katalog API'sini kullanan dış Iceberg istemcileriyle paylaşabilirsiniz.

Paylaşmadan önce, veri varlığınızı bir paylaşıma eklemek için gereken Delta Sharing gereksinimlerini karşıladığınızdan emin olun.

Note

Bu özellik , yönetilen Iceberg tablolarını paylaşmaktan farklıdır.

Ek sınırlamalar

• Silme vektörleri etkinleştirilmiş tablolar desteklenmez.
• Yönetilen Iceberg tabloları desteklenmez.
• Varsayılan depolamayı kullanan varlıklar dış Iceberg istemcileriyle paylaşılamaz. Bkz. Databricks'te varsayılan depolama.

Dış Iceberg istemcileriyle paylaşma

Veri varlıklarını dış Iceberg istemcileriyle paylaşmak için:

1. Delta tablosunu paylaşıyorsanız, her Delta tablosunu IcebergCompatV3 ile yapılandırarak bu tabloyu Iceberg uyumlu hale getirin. Bu, standart Delta işlemleriyle birlikte zaman uyumsuz Buzdağı meta verilerinin oluşturulmasını sağlar. Delta tablolarını Iceberg istemcileri ile paylaşma gereksinimlerini karşılayıp karşılamadığınıza bakın ve sınırlamaları gözlemleyin. Iceberg okumalarını etkinleştirmeyi öğrenmek için bkz. Iceberg okumalarını etkinleştirme (UniForm).

   Snowflake ile paylaşıyorsanız, alıcı için yalnızca tekdüzen etkin tablolar görüntülenir. Diğer tablolar filtrelenir.

   Note

   • Iceberg istemcilerinden tablo sorgulanmadan önce Iceberg meta veri oluşturma işleminin tamamlandığını onaylamak için kullanın DESCRIBE HISTORY .
   • OIDC kimlik doğrulama türü desteklenmiyor.

2. Veri varlığını bir paylaşıma ekleyin. Ayrıntılı yönergeler için bkz:

   • Paylaşıma tablo ekleme
   • Paylaşıma görünüm ekleme
   • Paylaşıma gerçekleştirilmiş görünümler ekleyin
   • Paylaşıma akış tabloları ekleme
   • Paylaşıma dış Iceberg tabloları ekleme

   Important

   Sağlayıcı tarafında veri gerçekleştirme, görünümler, gerçekleştirilmiş görünümler veya akış tabloları paylaştığınızda tetiklenir ve bu da işlem maliyetlerinin artmasına yol açabilir. Daha fazla bilgi için bkz. Delta Sharing maliyetlerini nasıl karşılayıp denetleyebilirim?.

3. Açık alıcınızla paylaşın. Alıcı oluşturma ve paylaşıma erişim verme yönergeleri için bkz. Taşıyıcı belirteçleri (açık paylaşım) kullanarak Databricks kullanıcısı olmayan kullanıcılar için alıcı nesnesi oluşturma.

Alıcılara paylaşıma erişim izni verme

Alıcılara bir paylaşıma erişim vermeden önce gereksinimleri karşıladığınızdan denetleyin.

Yönergeler için bkz. Delta Sharing veri paylaşımlarına erişimi yönetme (sağlayıcılar için). Bu sayfada ayrıca bir alıcının paylaşıma erişimini iptal etme açıklanmaktadır.

Paylaşımları ve paylaşım ayrıntılarını görüntüleme

Paylaşımları ve paylaşım ayrıntılarını görüntülemeden önce gereksinimleri karşıladığınızdan emin olun.

Paylaşımların listesini veya paylaşımla ilgili ayrıntıları görüntülemek için, Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini' ni, Databricks Unity Kataloğu CLI'sini veya SQL komutlarını kullanın.

Paylaşım ayrıntıları şunları içerir:

• Paylaşımın sahibi, oluşturucusu, oluşturma zaman damgası, güncelleştirici, güncelleştirilmiş zaman damgası, açıklamalar.
• Ortak kullanımdaki veri varlıkları.
• Paylaşıma erişimi olan alıcılar.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Paylaşımların listesini görüntülemek için Paylaşımlar sekmesini açın.

4. Ayrıntılar sekmesinde paylaşım ayrıntılarını görüntüleyin.

SQL

Paylaşım listesini görüntülemek için bir not defterinde veya Databricks SQL sorgu düzenleyicisinde aşağıdaki komutu çalıştırın. İsteğe bağlı olarak <pattern> öğesini bir LIKE önermesi ile değiştirin.

SHOW SHARES [LIKE <pattern>];

Belirli bir paylaşımla ilgili ayrıntıları görüntülemek için aşağıdaki komutu çalıştırın.

DESCRIBE SHARE <share-name>;

Bir paylaşımdaki tüm tablolar, görünümler ve birimler hakkındaki ayrıntıları görüntülemek için aşağıdaki komutu çalıştırın.

SHOW ALL IN SHARE <share-name>;

CLI

Paylaşım listesini görüntülemek için Databricks CLI kullanarak aşağıdaki komutu çalıştırın.

databricks shares list

Belirli bir paylaşımla ilgili ayrıntıları görüntülemek için aşağıdaki komutu çalıştırın.

databricks shares get <share-name>

Paylaşım üzerinde izinleri olan alıcıları görüntüleme

Alıcıları görüntülemeden önce gereksinimleri karşıladığınızdan denetleyin.

Bir alıcıya erişim izni verilen paylaşımların listesini görüntülemek için, Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini'ni, Databricks Unity Kataloğu CLI'sını veya SHOW GRANTS TO RECIPIENT SQL komutunu kullanın.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, alıcıyı bulun ve seçin.

4. Paylaşıma erişebilen alıcıların listesini görüntülemek için Alıcılar sekmesine gidin.

SQL

Aşağıdaki komutu bir not defterinde veya Databricks SQL sorgu düzenleyicisinde çalıştırın.

SHOW GRANTS ON SHARE <share-name>;

CLI

Databricks CLI kullanarak aşağıdaki komutu çalıştırın.

databricks shares share-permissions <share-name>

Paylaşımları güncelleştirme

Bir paylaşımda güncelleştirme yapmadan önce gereksinimleri karşıladığınızdan denetleyin.

Bir paylaşımı aşağıdaki yollarla güncelleştirebilirsiniz:

• Paylaşımı yeniden adlandırın.
• Bir paylaşımdan tabloları, görünümleri, birimleri ve şemaları kaldırın.
• Paylaşıma açıklama ekleyin veya bu paylaşıma açıklamayı güncelleştirin.
• Tablonun diğer adını (alıcıya görüntülenen tablo adı) yeniden adlandırın.
• Bir tablonun geçmiş verilerine erişimi etkinleştirebilir veya devre dışı bırakabilir, böylece alıcıların tablonun zaman yolculuğu sorgularını veya akış okumalarını gerçekleştirmesini sağlayabilirsiniz.
• Bölüm tanımlarını ekleyin, güncelleştirin veya kaldırın.
• Paylaşım sahibini değiştirin.

Paylaşımlarda bu güncelleştirmeleri yapmak için, Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini, Databricks Unity Kataloğu CLI veya SQL komutlarını kullanın. Ancak, paylaşımı yeniden adlandırmak için Katalog Gezgini'ni kullanamazsınız.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, güncelleştirmek istediğiniz paylaşımı bulun ve adına tıklayın.

Ayrıntıları paylaş sayfasında aşağıdakileri yapın:

• Bu değerleri güncelleştirmek için Sahip veya Açıklama alanının yanındaki düzenle simgesine tıklayın.
• Kaldırmak için bir varlık satırındaki tıklayın.
• Varlıkları yönet > Varlıkları düzenle'ye tıklayarak diğer tüm özellikleri güncelleştirin:
  • Bir varlığı kaldırmak için varlığın yanındaki onay kutusunun işaretini kaldırın.
  • Bölüm tanımlarını eklemek, güncelleştirmek veya kaldırmak için Gelişmiş seçenekler'e tıklayın.

SQL

Aşağıdaki komutları bir not defterinde veya Databricks SQL düzenleyicisinde çalıştırın.

Paylaşımı yeniden adlandırma:

ALTER SHARE <share-name> RENAME TO <new-share-name>;

Bir paylaşımdan tabloları kaldırma:

ALTER SHARE share_name REMOVE TABLE <table-name>;

Paylaşımdan hacimleri kaldırın:

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

Paylaşıma açıklama ekleme veya paylaşıma açıklama güncelleştirme:

COMMENT ON SHARE <share-name> IS '<comment>';

Paylaşımdaki bir tablo için bölüm ekleme veya değiştirme:

ALTER SHARE <share-name> ADD TABLE <table-name> PARTITION(<clause>);

Paylaşım sahibini değiştir:

ALTER SHARE <share-name> OWNER TO  '<principal>'

-- Principal must be an account-level user email address or group name.

Tablo için geçmiş paylaşımını etkinleştirme:

ALTER SHARE <share-name> ADD TABLE <table-name> WITH HISTORY;

ALTER SHARE parametreleri hakkında ayrıntılı bilgi için bkz. ALTER SHARE.

CLI

Databricks CLI kullanarak aşağıdaki komutları çalıştırın.

Paylaşımı yeniden adlandırma:

databricks shares update <share-name> --name <new-share-name>

Bir paylaşımdan tabloları kaldırma:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

Bir paylaşımdan birimleri kaldırma (Databricks CLI 0.210 veya üzerini kullanarak):

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<volume-full-name>",
          "data_object_type": "VOLUME",
          "string_shared_as": "<volume-alias>"
        }
      }
    ]
  }'

Note

Birim için diğer ad yoksa name özelliğini kullanın. Diğer ad varsa string_shared_as kullanın.

Paylaşıma açıklama ekleme veya paylaşıma açıklama güncelleştirme:

databricks shares update <share-name> --comment '<comment>'

Paylaşım sahibini değiştir:

databricks  shares update <share-name> --owner '<principal>'

Sorumlu, hesap düzeyinde bir kullanıcı e-posta adresi veya grup adı olmalıdır.

Paylaşım sahibini güncelleştirirken dikkat edilmesi gerekenler

Paylaşım sahibinin kim olduğu, ABAC ilkeleri gibi yetkilendirme ve güvenlik özelliklerinin değerlendirilme şeklini etkiler. Paylaşım sahipliğini fazla ayrıcalıklı bir kullanıcıya aktarmak, ABAC ilkeleriyle güvenliği sağlanan bir tablonuz veya şemanız varsa alıcıların aşırı ayrıcalıklı erişime sahip olmasını sağlar.

Paylaşımları silme

Bir paylaşımı sildiğinizde, alıcılar artık paylaşılan verilere erişemez. Bir paylaşım nesnesini silmeden önce gereksinimleri karşıladığınızdan denetleyin.

Bir paylaşımı silmek için, bir Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini'ni, Databricks Unity Kataloğu CLI'sini veya DELETE SHARE SQL komutunu kullanın. Paylaşımın sahibi olmanız gerekir.

Katalog Tarayıcısı

1. Azure Databricks çalışma alanınızda Catalog öğesine tıklayın.

2. Katalog bölmesinin üst kısmında Dişli simgesine tıklayın ve Delta Sharing'i seçin.

   Alternatif olarak, sağ üst köşede Delta Paylaşımını Paylaş'a >tıklayın.

3. Benimle paylaşılan sekmesinde, silmek istediğiniz paylaşımı bulun ve adına tıklayın.

4. Kebap menüsü ve Sil'i seçin.

5. Onay iletişim kutusunda Sil'e tıklayın.

SQL

Aşağıdaki komutu bir not defterinde veya Databricks SQL sorgu düzenleyicisinde çalıştırın.

DROP SHARE [IF EXISTS] <share-name>;

CLI

Databricks CLI kullanarak aşağıdaki komutu çalıştırın.

databricks shares delete <share-name>