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

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

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

• Tablolar ve tablo bölümleri
• 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
• Birimler
• Notebooks
• Yapay zeka modelleri

Bir şemanın (veritabanının) tamamını paylaşırsanız, alıcı şemayı paylaştığınız anda şemadaki tüm tablolara, görünümlere, modellere ve birimlere ve gelecekte şemaya eklenen tüm veri 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.

Daha fazla bilgi için bkz . Paylaşımlar, sağlayıcılar ve alıcılar.

Gereksinimler

Paylaşım oluşturmak için şunları kullanmanız gerekir:

• Meta veri deposu yöneticisi olun veya paylaşmak istediğiniz verilerin kayıtlı olduğu Unity Kataloğu meta veri deposu ayrıcalığına sahip CREATE SHARE olun.
• Unity Kataloğu meta veri deposunun eklendiği bir Azure Databricks çalışma alanını kullanarak paylaşımı oluşturun.

Bir paylaşıma tablo veya görünüm eklemek için şunlar gerekir:

• Paylaşım sahibi olun.
• USE CATALOG Tablo veya görünümü içeren katalog ve şemada ve USE SCHEMA ayrıcalığına ya da kataloğun veya şemanın sahipliğine sahip olun.
• SELECT Tablo veya görünümde ayrıcalığına sahip olun. Tablo veya görünümün paylaşılmaya devam edebilmesi için bu ayrıcalığı korumanız gerekir. Kaybederseniz, alıcı tabloya erişemez veya paylaşım üzerinden görüntüleyemez. Bu nedenle Databricks, paylaşım sahibi olarak bir grup kullanmanızı önerir.

Bir paylaşıma birim eklemek için şunları kullanmanız gerekir:

• Paylaşım sahibi olun.
• Katalog ve USE CATALOG şemada, kataloğun veya şemanın birimini veya sahipliğini içeren ve USE SCHEMA ayrıcalığına sahip olun.
• READ VOLUME Birimde ayrıcalığına sahip olun. Birimin paylaşılmaya devam edebilmesi için bu ayrıcalığı korumanız gerekir. Kaybederseniz, alıcı paylaşım aracılığıyla birime erişemez. Bu nedenle Databricks, paylaşım sahibi olarak bir grup kullanmanızı önerir.

Bir paylaşıma model eklemek için şunları kullanmanız gerekir:

• Paylaşım sahibi olun.
• Modeli veya kataloğun USE CATALOG veya şemanın sahipliğini içeren katalog ve şemada ve USE SCHEMA ayrıcalığına sahip olun.
• Modelde EXECUTE ayrıcalığına sahip olun. Modelin paylaşılmaya devam edebilmesi için bu ayrıcalığı korumanız gerekir. Kaybederseniz, alıcı paylaşım aracılığıyla modele erişemez. Bu nedenle Databricks, paylaşım sahibi olarak bir grup kullanmanızı önerir.

Şemanın tamamını paylaşmak için şunları kullanmanız gerekir:

• Paylaşım sahibi ve şema sahibi olun veya USE SCHEMA.
• Tabloları paylaşmak için şemaya sahip olun SELECT .
• Birimleri paylaşmak için şemaya sahip olun READ VOLUME .

Bir paylaşıma not defteri dosyaları eklemek için şu şekilde olmanız gerekir:

• Paylaşım sahibi ve not defteri üzerinde OKUYABILIR iznine sahiptir.

Alıcıya bir paylaşıma erişim vermek için şunlardan biri olmanız gerekir:

• Meta veri deposu yöneticisi.
• Hem paylaşımda hem de alıcı nesnelerinde ((USE SHARE + SET SHARE PERMISSION) veya paylaşım sahibinde) VE (USE RECIPIENT veya alıcı sahibi) temsilci izinlerine veya sahipliğine sahip olan kullanıcı.

Paylaşımları görüntülemek için şunlardan biri olmanız gerekir:

• Meta veri deposu yöneticisi (tümünü görüntüleyebilir)
• Ayrıcalığı olan USE SHARE bir kullanıcı (tümünü görüntüleyebilir)
• Nesne sahibini paylaşma

İşlem gereksinimleri:

• Paylaşımı oluşturmak için Databricks not defteri kullanıyorsanız, kümenizin Databricks Runtime 11.3 LTS veya üzerini ve paylaşılan veya tek kullanıcılı küme erişim modunu kullanması 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.

Share nesnesi oluşturma

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

Gerekli izinler: Meta veri deposu yöneticisi veya meta veri deposu ayrıcalığına sahip CREATE SHARE kullanıcı.

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine 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 tabloları, birimleri, görünümleri ve modelleri seçin.

   Ayrıntılı yönergeler için bkz:

   • Paylaşıma tablo ekleme
   • Paylaşıma birim ekleme
   • Paylaşıma görünüm ekleme
   • 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, birimler, görünümler ve modeller ekleyebilirsiniz.

Ayrıntılı yönergeler için bkz:

• Paylaşıma tablo ekleme
• Paylaşıma birim ekleme
• Paylaşıma görünüm ekleme
• Paylaşıma model ekleme

CLI

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

databricks shares create <share-name>

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

Artık paylaşıma tablolar, birimler, görünümler ve modeller ekleyebilirsiniz.

Ayrıntılı yönergeler için bkz:

• Paylaşıma tablo ekleme
• Paylaşıma birim ekleme
• Paylaşıma görünüm ekleme
• Paylaşıma model ekleme

Paylaşıma tablo ekleme

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

Not

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.

gerekli izinler: Paylaşım nesnesinin sahibi, USE CATALOG USE SCHEMA tabloyu içeren katalog ve şemada ve SELECT tablodaki ayrıcalığı. Tabloyu paylaşmak istediğiniz sürece ayrıcalığı korumanız SELECT gerekir. Daha fazla bilgi için bkz . Gereksinimler.

Not

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

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine tıklayın.

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

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

5. Tablo ekle sayfasında, şemanın tamamını (veritabanı) veya tek tek tabloları ve görünümleri seçin.

   • Tablo veya görünüm seçmek için önce kataloğu, ardından tabloyu veya görünümü içeren şemayı, ardından tabloyu veya görünümü 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. (İsteğe bağlı) Aşağıdaki seçenekleri belirtmek için Gelişmiş tablo seçenekleri'ne tıklayın. Şemanın tamamını seçerseniz diğer ad 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 okunabilir hale getirmek için alternatif bir tablo adı. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken tablo 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.

   • Geçmiş Paylaşımı: Alıcıların zaman yolculuğu sorguları gerçekleştirmesine veya Spark Yapılandırılmış Akış ile tabloyu okumasına izin vermek için tablo geçmişini paylaşın. Databricks Runtime 12.2 LTS veya üzerini gerektirir.

     Not

     Zaman yolculuğu sorguları ve akış okumalarına ek olarak, müşterilerinizin table_changes() işlevini kullanarak tablonun değişiklik veri akışını (CDF) sorgulayabilmesini istiyorsanız, paylaşmadan WITH HISTORYönce tabloda CDF'yi etkinleştirmeniz gerekir.

7. 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. WITH HISTORY bir şemanın tamamını seçerseniz tüm tablolar için varsayılan olarak seçilir.

• 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 tablo adı veya Diğer Ad . Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken tablo 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: Belirtildiğinde WITH HISTORY , alıcıların zaman yolculuğu sorguları ve akış okumaları gerçekleştirmesine olanak tanıyarak tabloyu tam geçmişle paylaşın. Tablo paylaşımı için varsayılan davranış ve WITHOUT HISTORY şema paylaşımı için şeklindedir WITH HISTORY. Databricks Runtime 12.2 LTS veya üzerini gerektirir.

  Not

  Zaman yolculuğu sorguları ve akış okumalarına ek olarak, müşterilerinizin table_changes() işlevini kullanarak tablonun değişiklik veri akışını (CDF) sorgulayabilmesini istiyorsanız, paylaşmadan WITH HISTORYönce tabloda CDF'yi etkinleştirmeniz gerekir.

Seçenekler hakkında ALTER SHARE 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"
        }
      }
    ]
  }'

Not

Tablolar ve yalnızca tablolar için atlayabilirsiniz "data_object_type".

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 REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ komutunu çalıştırın databricks shares update --help veya bakın.

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

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 bölüm belirtimi sağlayabilirsiniz. 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 belirtebilirsiniz. Bkz. Paylaşıma tablo ekleme ve Paylaşımları güncelleştirme.

Temel örnek

Aşağıdaki SQL örneği, tablodaki inventory verilerin , monthve date sütunları tarafından yearbö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 Kataloğu meta deposu (yalnızca Databricks-Databricks paylaşımı).
• databricks.name: Veri alıcısının adı.

Alıcı oluştururken veya güncelleştirirken istediğiniz 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, Katalog Gezgini'ni veya CURRENT_RECIPIENT Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde SQL işlevini kullanabilirsiniz:

Not

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

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine 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ı 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 belirtimleri eklemek için Gelişmiş tablo seçenekleri'ne tıklayın.

   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

Önemli

Bu özellik Genel Önizlemededir.

Silme vektörleri, Delta tablolarında etkinleştirebileceğiniz bir depolama iyileştirme özelliğidir. Bkz . Silme vektörleri nedir?.

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ını, Databricks Runtime 14.1 veya üzerini çalıştıran bir kümeyi veya 3.1 veya üzeri açık kaynak delta-sharing-spark çalıştıran bir işlemi 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 görünüm ekleme

Önemli

Bu özellik Genel Önizlemededir.

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.

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.

gerekli izinler: Paylaşım nesnesinin sahibi, USE CATALOG USE SCHEMA görünümü içeren katalog ve şemada ve SELECT görünümde. Görünümü paylaşmak istediğiniz sürece ayrıcalığı korumanız SELECT gerekir. Daha fazla bilgi için bkz . Gereksinimler.

Ek gereksinimler:

• Görüntüleme paylaşımı yalnızca Databricks'ten Databricks'e paylaşımında desteklenir.
• Paylaşılabilir görünümler Delta tablolarında veya diğer paylaşılabilir görünümlerde tanımlanmalıdır.
• Paylaşılan tablolara veya paylaşılan görünümlere başvuran görünümleri paylaşamazsınız.
• Bir paylaşıma görünüm eklerken Databricks Runtime 13.3 LTS veya üzeri bir sql ambarı veya küme kullanmanız gerekir.
• Görünümlerin alıcı kullanımıyla ilgili gereksinimler ve sınırlamalar için bkz . Paylaşılan görünümleri okuma.

Paylaşıma görünüm eklemek için:

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine 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ı 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ı) Görünüm adını daha okunabilir hale getirmek için Diğer Ad veya alternatif görünüm adı belirtmek için Gelişmiş tablo seçenekleri'ne tıklayın. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken addır. Diğer 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 arasında bulunanlar:

• 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. Diğer 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.

Seçenekler hakkında ALTER SHARE 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. Diğer 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 REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ komutunu çalıştırın databricks shares update --help veya bakın.

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

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

Önemli

Bu özellik Genel Önizlemededir.

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.

Gereksinimler

• Databricks Runtime sürümü: CURRENT_RECIPIENT İşlev Databricks Runtime 14.2 ve üzeri sürümlerde desteklenir.
• İzinler:
  • Görünüm oluşturmak için, görünümü içeren katalogda ve USE SCHEMA şemada ve görünümde SELECT bulunan paylaşım nesnesinin USE CATALOG sahibi olmanız gerekir. Görünümü paylaşmak istediğiniz sürece ayrıcalığı korumanız SELECT gerekir.
  • Bir alıcıda özellikleri ayarlamak için, alıcı nesnesinin sahibi olmanız gerekir.
• Sınırlamalar: Databricks'i Databricks'e paylaşma kısıtlaması dahil olmak üzere görüntüleme paylaşımıyla ilgili tüm sınırlamalar ve aşağıdakiler:
  • Sağlayıcı işlevi kullanan bir görünümü paylaştığında CURRENT_RECIPIENT , sağlayıcı paylaşım bağlamı nedeniyle 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 Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine tıklayın.

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

4. Özellikleri düzenle'ye 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ıda özelliğini ayarlamak için kullanın ALTER RECIPIENT. 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 izniyle dinamik görünüm oluşturma

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ı ve daha fazla esneklik için alıcı özelliklerinin ve olgu tablosu alanlarının ayrılmasına olanak sağlamasıdı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 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 nedir?.

Bu bölümde, Bir Azure Databricks not defterinde veya SQL sorgu düzenleyicisinde Katalog Gezgini, Databricks CLI veya SQL komutlarını kullanarak bir paylaşıma birimlerin 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.

Not

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.

gerekli izinler: Paylaşım nesnesinin sahibi, USE CATALOG USE SCHEMA birimi içeren katalog ve şemada ve READ VOLUME birimde. Birimi paylaşmak istediğiniz sürece ayrıcalığı korumanız READ VOLUME gerekir. Daha fazla bilgi için bkz . Gereksinimler.

Ek gereksinimler:

• Birim paylaşımı yalnızca Databricks'ten Databricks'e paylaşımında desteklenir.
• Bir paylaşıma birim eklerken 2023.50 veya üzeri bir sürümde sql ambarı ya da Databricks Runtime 14.1 veya üzeri bir küme 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 birimin depolama konumuna bağlanabilmesi için alıcının denetim düzleminin ve veri düzlemi adreslerinin düzgün izin verilenler listesine dahil olduğundan emin olması gerekir.

Bir paylaşıma birim eklemek için:

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine 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 birimi arayın veya 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ı) Birim adını daha okunabilir hale getirmek için alternatif bir birim adı veya Diğer Ad belirtmek için Gelişmiş seçenekler'e tıklayın.

   Şemanın tamamını seçerseniz diğer adlar kullanılamaz.

   Diğer ad, alıcının gördüğü ve sorgularda 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 arasında bulunanlar:

• AS <alias>: Birim adını daha okunabilir hale getirmek için alternatif bir birim adı veya diğer ad. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken birim adıdır. Diğer 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.

Seçenekler hakkında ALTER SHARE 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. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken birim adıdır. Diğer 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 REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ komutunu çalıştırın databricks shares update --help veya bakın.

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

Paylaşıma model ekleme

Bu bölümde, Azure Databricks not defterinde veya SQL sorgu düzenleyicisinde Katalog Gezgini, Databricks CLI veya SQL komutlarını kullanarak bir paylaşıma model 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.

Not

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

gerekli izinler: Share nesnesinin sahibi, USE CATALOG USE SCHEMA modeli içeren katalog ve şemada ve EXECUTE modelde. Modeli paylaşmak istediğiniz sürece ayrıcalığı korumanız EXECUTE gerekir. Daha fazla bilgi için bkz . Gereksinimler.

Ek gereksinimler:

• Model paylaşımı yalnızca Databricks'ten Databricks'e paylaşımında desteklenir.
• Bir paylaşıma model eklerken 2023.50 veya üzeri bir sürümde SQL ambarı ya da Databricks Runtime 14.0 veya üzeri sürümlerde bir küme kullanmanız gerekir.

Bir paylaşıma model eklemek için:

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine 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ı) Model adını daha okunabilir hale getirmek için alternatif bir model adı veya Diğer Ad belirtmek için Gelişmiş seçenekler'e tıklayın.

   Şemanın tamamını seçerseniz diğer adlar kullanılamaz.

   Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken addır. 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 arasında bulunanlar:

• AS <alias>: Model adını daha okunabilir hale getirmek için alternatif bir model adı veya diğer ad. Diğer ad, alıcının gördüğü ve sorgularda kullanması gereken model adıdır. 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.

Seçenekler hakkında ALTER SHARE 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 kullanması gereken model adıdır. 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 REST API başvurusunda PATCH /api/2.1/unity-catalog/shares/ komutunu çalıştırın databricks shares update --help veya bakın.

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

Paylaşıma şema ekleme

Bir paylaşıma şemanın tamamını eklediğinizde, alıcılarınız yalnızca paylaşımı oluşturduğunuz sırada şemadaki tüm veri varlıklarına değil, zamanla şemaya eklenen tüm varlıklara da erişebilir. 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.

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.

gerekli izinler: Paylaşım nesnesinin sahibi ve şemanın sahibi (veya şemada ve SELECT ayrıcalıklarına sahip USE SCHEMA bir kullanıcı).

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.

Bir şemanın tamamını seçerseniz tablo diğer adları, bölümler ve birim diğer 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.

Şema paylaşımını kullanarak paylaştığınız bir tablo veya birim için gelişmiş seçenekler belirtmek istiyorsanız, tabloyu veya birimi SQL kullanarak paylaşmanız ve tabloya veya birime farklı bir şema adına sahip bir diğer ad vermeniz gerekir.

Paylaşıma not defteri dosyaları ekleme

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

Not

Not defterlerini paylaşmak için meta veri deponuzun meta veri deposu düzeyinde depolama alanı olmalıdır.

gerekli izinler: Paylaşım nesnesinin sahibi ve paylaşmak istediğiniz not defteri üzerinde OKUMA izni.

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında 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), Farklı paylaş alanında dosya için kolay bir diğer ad belirtin. Bu, alıcıların göreceği tanımlayıcıdır.

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 Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine 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üncelleştirmek için, not defterini yeniden ekleyip Farklı paylaş alanında yeni bir diğer 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.

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

Alıcılara paylaşım erişimi vermek için, Bir Azure Databricks not defterinde veya GRANT ON SHARE Databricks SQL sorgu düzenleyicisinde Katalog Gezgini'ni, Databricks Unity Kataloğu CLI'sini veya SQL komutunu kullanabilirsiniz.

gerekli izinler: Aşağıdakilerden biri:

• Meta veri deposu yöneticisi.
• Hem paylaşımda hem de alıcı nesnelerinde ((USE SHARE + SET SHARE PERMISSION) veya paylaşım sahibinde) VE (USE RECIPIENT veya alıcı sahibi) temsilci izinleri veya sahipliği.

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

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

Paylaşımların listesini veya bir 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ı kullanabilirsiniz.

Gerekli izinler: Döndürülen paylaşımların listesi, rolünüz ve izinlerinize bağlıdır. Meta veri deposu yöneticileri ve ayrıcalığına USE SHARE sahip kullanıcılar tüm paylaşımları görür. Aksi takdirde, yalnızca paylaşım nesnesi sahibi olduğunuz paylaşımları görüntüleyebilirsiniz.

Ayrıntılar şunlardır:

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

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine 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, yerine bir LIKE koşul yazın<pattern>.

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

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

Gerekli izinler: Meta veri deposu yöneticisi, USE SHARE ayrıcalık veya paylaşım nesnesi sahibi.

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine 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

Paylaşıma tablo, görünüm, birim ve not defteri eklemenin yanı sıra şunları da yapabilirsiniz:

• 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.
• 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, Bir Azure Databricks not defterinde veya Databricks SQL sorgu düzenleyicisinde Katalog Gezgini'ni, Databricks Unity Kataloğu CLI'sini veya SQL komutlarını kullanabilirsiniz. Paylaşımı yeniden adlandırmak için Katalog Gezgini'ni kullanamazsınız.

Gerekli izinler: Paylaşım sahibini güncelleştirmek için aşağıdakilerden biri olmanız gerekir: meta veri deposu yöneticisi, paylaşım nesnesinin sahibi veya hem hem SET SHARE PERMISSION de USE SHARE ayrıcalıklarına sahip bir kullanıcı. Paylaşım adını güncelleştirmek için meta veri deposu yöneticisi (veya ayrıcalığı olan CREATE_SHARE kullanıcı) ve paylaşım sahibi olmanız gerekir. Diğer paylaşım özelliklerini güncelleştirmek için sahip olmanız gerekir.

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine 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.
• Bir varlık satırında kebap menü düğmesine tıklayarak kaldırı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 birimleri kaldırma:

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;

Parametreler hakkında ALTER SHARE 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>"
        }
      }
    ]
  }'

Not

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

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ı silme

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

Bir paylaşımı sildiğinizde, alıcılar artık paylaşılan verilere erişemez.

gerekli izinler: Nesne sahibini paylaşma.

Katalog Gezgini

1. Azure Databricks çalışma alanınızda Katalog'a tıklayın .

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

   Alternatif olarak, Hızlı erişim sayfasında Delta Paylaşımı >düğmesine tıklayın.

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

4. Kebap menüsüne tıklayın 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>