OpenSharing paylaşımlarını yönetme

Bu sayfada, Azure Databricks'da mevcut OpenSharing paylaşımlarının nasıl görüntülenip güncelleştirileceği ve silineceği açıklanır. Paylaşım, Unity Kataloğu'nda bir veya daha fazla alıcıyla paylaşmak üzere tabloları, görünümleri, birimleri, not defterlerini, yapay zeka modellerini ve diğer veri varlıklarını paketleyen güvenli hale getirilebilir bir nesnedir.

Yeni bir paylaşım oluşturmak veya var olan bir paylaşıma veri varlıkları eklemek için bkz. OpenSharing için paylaşım oluşturma. Alıcıya bir paylaşıma erişim vermek için bkz. OpenSharing veri paylaşımlarına erişimi yönetme (sağlayıcılar için). Paylaştığınız veri alıcılarını yönetmek için bkz. OpenSharing için veri alıcılarını yönetme.

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.

Görev	Requirements
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.

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 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ı 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 Katalog'a gidin.

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

   Alternatif olarak, Hızlı erişim sayfasından OpenSharing > 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, <pattern>'yi bir LIKE öznitelik 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 Katalog'a gidin.

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

   Alternatif olarak, Hızlı erişim sayfasından OpenSharing > 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

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 Katalog'a gidin.

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

   Alternatif olarak, Hızlı erişim sayfasından OpenSharing > 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.
• 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 Katalog'a gidin.

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

   Alternatif olarak, Hızlı erişim sayfasından OpenSharing > 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ü 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>