Share via

Unity Kataloğu CLI (eski)

  • Makale

Önemli

Bu belge kullanımdan kaldırılmıştır ve güncelleştirilmeyebilir.

Bu bilgiler eski Databricks CLI 0.18 ve altındaki sürümler için geçerlidir. Databricks, bunun yerine daha yeni Databricks CLI sürüm 0.205 veya üzerini kullanmanızı önerir. Bkz . Databricks CLI nedir?. Databricks CLI sürümünüzü bulmak için komutunu çalıştırın databricks -v.

Databricks CLI sürüm 0.18 veya altından Databricks CLI sürüm 0.205 veya üzeri sürüme geçiş yapmak için bkz . Databricks CLI geçişi.

Not

Unity Kataloğu CLI'sı Deneyseldir.

Unity Kataloğu CLI'sı, kimlik doğrulamasıyla yapılandırılmış Databricks CLI (eski) 0.17.0 veya üzerini gerektirir. Databricks CLI'yı güncelleştirmek veya yüklü sürümü listelemek için bkz . CLI'yi güncelleştirme.

Aşağıdaki örneklerde yer alan seçenek ve alan örnek değerleri yalnızca açıklayıcı amaçlarla verilmiştir.

Unity Kataloğu CLI'sini kullanarak aşağıdakilerle çalışın:

Unity Kataloğu CLI alt komutlarını öğesine ekleyerek databricks unity-catalogçalıştırırsınız. Bu alt komutlar, Delta Sharing API'sini de içeren Unity Katalog API'sini çağırır.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog --help.

Çıktı:

Usage: databricks unity-catalog [OPTIONS] COMMAND [ARGS]...

  Utility to interact with Databricks Unity Catalog.

Options:
  -v, --version  0.17.1
  -h, --help     Show this message and exit.

Commands:
  catalogs
  external-locations
  lineage
  metastores
  permissions
  providers
  recipients
  schemas
  shares
  storage-credentials
  tables

Meta veri depoları

unity-catalog metastores Meta veri depolarıyla çalışmak için alt komutu kullanın.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores --help.

Meta veri deposu oluşturma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores create --help. Ayrıca bkz. Unity Kataloğu meta veri deposu oluşturma.

Not

Meta veri deposu oluşturma işlemi meta veri depoyu otomatik olarak bir çalışma alanı veya depolama kimlik bilgileriyle ilişkilendirmez. Bu görevleri tamamlamak için bkz . Meta veri depolarını çalışma alanına bağlama, Depolama kimlik bilgisi oluşturma ve Meta veri deposu ayarlarını güncelleştirme.

Bu komutu zaten atanmış bir meta veri deposu olan bir çalışma alanında çalıştırırsanız, bu çalışma alanının atanmış meta veri deposunu güncelleştirirsiniz.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores assign --help.

databricks unity-catalog metastores assign --workspace-id 1234567890123456 \
                                           --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --default-catalog-name main

Çalışma alanı kimliğini almak için bkz . Çalışma alanı örneği adları, URL'ler ve kimlikler.

Meta veri deposu kimliğini almak için komutunu çalıştırın databricks unity-catalog metastores get-summary. Bir örnek için bkz . Geçerli meta veri deposu hakkında özetlenmiş bilgileri alma.

Çıktı:

{}

Ayrıca bkz. Unity Kataloğu meta veri deposu oluşturma.

Meta veri deposu ayarlarını güncelleştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores update --help.

databricks unity-catalog metastores update --id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --json-file update-metastore.json

Meta veri deposu kimliğini almak için komutunu çalıştırın databricks unity-catalog metastores get-summary. Bir örnek için bkz . Geçerli meta veri deposu hakkında özetlenmiş bilgileri alma.

update-metastore.json:

{
  "storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
}

Depolama kök kimlik bilgisi kimliğini almak için bkz . Depolama kimlik bilgileri hakkında bilgi alma.

Kullanılabilir meta veri depolarını listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores list --help.

databricks unity-catalog metastores list

Meta veri deposu hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores get --help.

databricks unity-catalog metastores get --id 12a345b6-7890-1cd2-3456-e789f0a12b34

Meta veri deposu kimliğini almak için komutunu çalıştırın databricks unity-catalog metastores get-summary. Bir örnek için bkz . Geçerli meta veri deposu hakkında özetlenmiş bilgileri alma.

Geçerli meta veri deposu hakkında özetlenmiş bilgileri alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores get-summary --help.

databricks unity-catalog metastores get-summary

Çalışma alanı için geçerli meta veri deposu atamasını alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores get-assignment --help.

databricks unity-catalog metastores get-assignment

Çıktı:

{
  "workspace_id": 1234567890123456,
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "default_catalog_name": "main"
}

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores unassign --help.

databricks unity-catalog metastores unassign --workspace-id 1234567890123456 \
                                             --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34

Çalışma alanı kimliğini almak için bkz . Çalışma alanı örneği adları, URL'ler ve kimlikler.

Meta veri deposu kimliğini almak için komutunu çalıştırın databricks unity-catalog metastores get-summary. Bir örnek için bkz . Geçerli meta veri deposu hakkında özetlenmiş bilgileri alma.

Çıktı:

{}

Meta veri depolarını silme

Uyarı

Meta veri depolarını silmeden önce, meta veri depolarını kullanan tüm çalışma alanlarını silmeniz veya bu çalışma alanlarına yönelik meta veri deposu bağlantısını kaldırmanız gerekir. Çalışma alanlarından meta veri deposu bağlantılarını kaldırma konusunda yardım için Azure Databricks desteğine başvurun.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog metastores delete --help.

Meta depoyu zorla silmek için seçeneğini kullanın --force .

databricks unity-catalog metastores delete --id 12a345b6-7890-1cd2-3456-e789f0a12b34

Meta veri deposu kimliğini almak için komutunu çalıştırın databricks unity-catalog metastores get-summary. Bir örnek için bkz . Geçerli meta veri deposu hakkında özetlenmiş bilgileri alma.

İşlem başarılı olursa hiçbir sonuç döndürülür.

kimlik bilgilerini Depolama

unity-catalog storage-credentials Depolama kimlik bilgileriyle çalışmak için alt komutu kullanın. bkz. Azure Data Lake Storage 2. Nesil bağlanmak için depolama kimlik bilgisi oluşturma.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog storage-credentials --help.

Depolama kimlik bilgisi oluşturma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog storage-credentials create --help.

Ayrıca bkz. Azure Data Lake Storage 2. Nesil bağlanmak için depolama kimlik bilgisi oluşturma.

Depolama kimlik bilgilerinin ayarlarını güncelleştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog storage-credentials update --help.

Kullanılabilir depolama kimlik bilgilerini listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog storage-credentials list --help.

databricks unity-catalog storage-credentials list

Depolama kimlik bilgileri hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog storage-credentials get --help.

databricks unity-catalog storage-credentials get --name my-storage-root-credential

Depolama kimlik bilgilerini silme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog storage-credentials delete --help.

Depolama kimlik bilgilerini zorla silmek için seçeneğini kullanın --force .

databricks unity-catalog storage-credentials delete --name my-storage-root-credential

İşlem başarılı olursa hiçbir sonuç döndürülür.

Dış konumlar

unity-catalog external-locations Dış konumlarla çalışmak için alt komutu kullanın. Bkz. Bulut depolamayı Azure Databricks'e bağlamak için dış konum oluşturma.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog external-locations --help.

Dış konum oluşturma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog external-locations create --help. Ayrıca bkz. Bulut depolamayı Azure Databricks'e bağlamak için dış konum oluşturma.

Dış konumu ve kimlik bilgisi çifti doğrulama

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog external-locations validate --help.

Bir dış konum adını ve kimlik bilgisi çiftini oluşturduktan sonra doğrulama

databricks unity-catalog external-locations validate --name my-external-location \
                                                     --cred-name my-storage-root-credential

Çıktı:

{
  "isDir": true,
  "results": [
    {
      "operation": "READ",
      "result": "PASS"
    },
    {
      "operation": "LIST",
      "result": "PASS"
    },
    {
      "operation": "WRITE",
      "result": "PASS"
    },
    {
      "operation": "DELETE",
      "result": "PASS"
    }
  ]
}

Dış konumun ayarlarını güncelleştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog external-locations update --help.

databricks unity-catalog external-locations update --name my-external-location \
                                                   --json-file update-external-location.json

udpate-external-location.json:

{
  "name": "my-external-location-2"
}

Kullanılabilir dış konumları listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog external-locations list --help.

databricks unity-catalog external-locations list

Dış konum hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog external-locations get --help.

databricks unity-catalog external-locations get --name my-external-location

Dış konumu silme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog external-locations delete --help.

Dış konumu zorla silmek için seçeneğini kullanın --force .

databricks unity-catalog external-locations delete --name my-external-location

İşlem başarılı olursa hiçbir sonuç döndürülür.

Kataloglar

unity-catalog catalogs Kataloglarla çalışmak için alt komutu kullanın.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog catalogs --help.

Katalog oluşturma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog catalogs create --help. Ayrıca bkz. Katalog oluşturma.

databricks unity-catalog catalogs create --name my-catalog

Çıktı:

{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

Kataloğun ayarlarını güncelleştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog catalogs update --help.

databricks unity-catalog catalogs update --name my-catalog \
                                         --json-file update-catalog.json

update-catalog.json:

{
  "name": "my-catalog-2",
  "owner": "someone@example.com"
}

Çıktı:

{
  "name": "my-catalog-2",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656355967835,
  "created_by": "someone@example.com",
  "updated_at": 1656356095989,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

Kullanılabilir katalogları listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog catalogs list --help.

databricks unity-catalog catalogs list

Çıktı:

{
  "catalogs": [
    {
      "name": "main",
      "owner": "someone@example.com",
      "comment": "Main catalog (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656112029355,
      "created_by": "someone@example.com",
      "updated_at": 1656112029355,
      "updated_by": "someone@example.com",
      "catalog_type": "MANAGED_CATALOG"
    },
    {
      "...": "..."
    }
  ]
}

Katalog hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog catalogs get --help.

databricks unity-catalog catalogs get --name my-catalog

Çıktı:

{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

Kataloğu silme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog catalogs delete --help. Ayrıca bkz. Katalog silme.

Kataloğu zorla silmek için seçeneğini kullanın --purge .

databricks unity-catalog catalogs delete --name my-catalog

İşlem başarılı olursa hiçbir sonuç döndürülür.

Şemalar

unity-catalog schemas Şemalarla çalışmak için alt komutu kullanın.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog schemas --help.

Şema oluşturma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog schemas create --help. Ayrıca bkz. Şema oluşturma.

databricks unity-catalog schemas create --catalog-name my-catalog \
                                        --name my-schema

Çıktı:

{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

Şema ayarlarını değiştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog schemas update --help.

databricks unity-catalog schemas update --full-name my-catalog.my-schema \
                                        --json-file update-schema.json

update-schema.json:

{
  "name": "my-schema-2",
  "owner": "someone@example.com"
}

Çıktı:

{
  "name": "my-schema-2",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "comment": "Default schema (auto-created)",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema-2",
  "created_at": 1656355967837,
  "created_by": "someone@example.com",
  "updated_at": 1656356592786,
  "updated_by": "someone@example.com"
}

Kullanılabilir şemaları listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog schemas list --help.

databricks unity-catalog schemas list --catalog-name my-catalog

Çıktı:

{
  "schemas": [
    {
      "name": "default",
      "catalog_name": "my-catalog",
      "owner": "someone@example.com",
      "comment": "Default schema (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "full_name": "my-catalog.default",
      "created_at": 1656113178996,
      "created_by": "someone@example.com",
      "updated_at": 1656113178996,
      "updated_by": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

Şema hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog schemas get --help.

databricks unity-catalog schemas get --full-name my-catalog.my-schema

Çıktı:

{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

Şema silme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog schemas delete --help. Ayrıca bkz. Şema silme.

Bir şemayı zorla silmek için seçeneğini kullanın --purge .

databricks unity-catalog schemas delete --full-name my-catalog.my-schema

İşlem başarılı olursa hiçbir sonuç döndürülür.

Tablolar

unity-catalog tables Tablolarla çalışmak için alt komutu kullanın.

Not

Unity Kataloğu CLI ile tablo oluşturma desteklenmez. Tablo oluşturmak için bkz . Unity Kataloğu'nda tablo oluşturma ve Öğretici: İlk tablonuzu oluşturma ve ayrıcalıklar verme.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog tables --help.

Kullanılabilir tabloları listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog tables list --help.

databricks unity-catalog tables list --catalog-name main \
                                     --schema-name default

Kullanılabilir tabloların özetlerini listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog tables list-summaries --help.

databricks unity-catalog tables list-summaries --catalog-name main

Çıktı:

{
  "tables": [
    {
      "full_name": "main.default.mytable",
      "table_type": "MANAGED"
    },
    {
      "...": "..."
    }
  ]
}

Tablo hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog tables get --help.

databricks unity-catalog tables get --full-name main.default.mytable

Tablo silme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog tables delete --help.

databricks unity-catalog tables delete --full-name main.default.mytable

İşlem başarılı olursa hiçbir sonuç döndürülür.

Soy

Tablo ve sütun kökenleriyle unity-catalog lineage çalışmak için alt komutu kullanın.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog lineage --help.

Tablonun kökenini listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog lineage table --help.

databricks unity-catalog lineage table --table-name main.default.mytable \
                                       --level 1

Sütunun kökenini listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog lineage column --help.

databricks unity-catalog lineage column --table-name main.default.mytable \
                                        --column-name id

İzinler

unity-catalog permissions Güvenliği sağlanabilir nesnelere yönelik izinlerle çalışmak için alt komutu kullanın. Ayrıca bkz. Unity Kataloğu'nda ayrıcalıkları yönetme.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog permissions --help.

Güvenli hale getirilebilir bir nesnenin izinleri hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog permissions get --help. Ayrıca bkz. Unity Kataloğu ayrıcalıkları ve güvenliği sağlanabilir nesneler.

Katalog

databricks unity-catalog permissions get --catalog main

Çıktı:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "USE CATALOG"
      ]
    }
  ]
}

Şema

databricks unity-catalog permissions get --schema main.default

Çıktı:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "USE SCHEMA"
      ]
    }
  ]
}

Tablo

databricks unity-catalog permissions get --table main.default.mytable

Çıktı:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "SELECT"
      ]
    }
  ]
}

Depolama kimlik bilgisi

databricks unity-catalog permissions get --storage-credential my-storage-root-credential

Çıktı:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "READ_FILES"
      ]
    }
  ]
}

Dış konum

databricks unity-catalog permissions get --external-location my-external-location

Çıktı:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": [
        "READ_FILES"
      ]
    }
  ]
}

Güvenli hale getirilebilir bir nesnenin izinlerini güncelleştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog permissions update --help. Ayrıca bkz. Unity Kataloğu ayrıcalıkları ve güvenliği sağlanabilir nesneler.

Katalog

databricks unity-catalog permissions update --catalog \
                                            --json-file update-catalog-permissions.json

update-catalog-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": [ "USE CATALOG" ],
      "remove": [ "CREATE SCHEMA" ]
    }
  ]
}

Şema

databricks unity-catalog permissions update --schema \
                                            --json-file update-schema-permissions.json

update-schema-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": [ "USE SCHEMA" ],
      "remove": [ "CREATE TABLE" ]
    },
    {
      "principal": "admin team",
      "add": [ "CREATE TABLE" ]
    }
  ]
}

Tablo

databricks unity-catalog permissions update --table \
                                            --json-file update-table-permissions.json

update-table-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": [ "SELECT" ],
      "remove": [ "MODIFY" ]
    },
    {
      "principal": "admin team",
      "add": [ "ALL" ]
    }
  ]
}

Depolama kimlik bilgisi

databricks unity-catalog permissions update --storage-credential \
                                            --json-file update-storage-credential-permissions.json

update-storage-credential-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "remove": [ "READ FILES" ]
    },
    {
      "principal": "storage team",
      "add": [ "READ FILES",
               "WRITE FILES",
               "CREATE EXTERNAL TABLE"
             ]
    },
    {
      "principal": "admin team",
      "add": [ "ALL" ]
    }
  ]
}

Dış konum

databricks unity-catalog permissions update --external-location \
                                            --json-file update-external-location-permissions.json

update-external-location-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "remove": [ "READ FILES" ]
    },
    {
      "principal": "storage team",
      "add": [ "READ FILES",
               "WRITE FILES",
               "CREATE EXTERNAL TABLE"
             ]
    },
    {
      "principal": "admin team",
      "add": [ "ALL" ]
    }
  ]
}

Paylaşımlar

unity-catalog shares Delta Sharing özellikli Unity Kataloğu meta veri deposunda Delta Sharing alıcılarıyla grup olarak paylaşmak istediğiniz tablo koleksiyonlarını içeren nesneler olan paylaşımlarla çalışmak için alt komutu kullanın. Paylaşım yalnızca tek bir meta veri deposundan tablolar içerebilir. Bkz . Delta Sharing için paylaşım oluşturma ve yönetme.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog shares --help.

Paylaşım oluşturma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog shares create --help. Ayrıca bkz. Delta Sharing için paylaşım oluşturma ve yönetme.

databricks unity-catalog shares create --name my-share

Çıktı:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Paylaşımın ayarlarını güncelleştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog shares update --help. Ayrıca bkz. Paylaşımları güncelleştirme.

Paylaşıma tablo ekleme

databricks unity-catalog shares update --name my-share \
                                       --add-table main.default.mytable

Çıktı:

{
  "name": "my-share",
  "objects": [
    {
      "name": "main.default.mytable",
      "data_object_type": "TABLE",
      "added_at": 1656434168847,
      "added_by": "someone@example.com",
      "shared_as": "default.mytable",
      "cdf_enabled": false
    }
  ],
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Ayrıca bkz. Paylaşıma tablo ekleme.

Paylaşımdan tablo kaldırma

databricks unity-catalog shares update --name my-share \
                                       --remove-table main.default.mytable

Çıktı:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Ayrıca bkz. Paylaşıma tablo ekleme.

Paylaşımın izinlerini güncelleştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog shares update-permissions --help. Ayrıca bkz. Delta Sharing veri paylaşımlarına erişimi yönetme (sağlayıcılar için).

databricks unity-catalog shares update-permissions --name my-share \
                                                   --json-file update-share-permissions.json

update-share-permissions.json:

{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": [
        "SELECT"
      ]
    }
  ]
}

Kullanılabilir paylaşımları listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog shares list --help. Ayrıca bkz. Paylaşımları ve paylaşım ayrıntılarını görüntüleme.

databricks unity-catalog shares list

Çıktı:

{
  "shares": [
    {
      "name": "my-share",
      "created_at": 1656433327533,
      "created_by": "someone@example.com",
      "owner": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

Paylaşım hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog shares get --help. Ayrıca bkz. Paylaşımları ve paylaşım ayrıntılarını görüntüleme.

databricks unity-catalog shares get --name my-share

Çıktı:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Paylaşımın izinlerini listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog shares list-permissions --help. Ayrıca bkz. Paylaşım üzerinde izinleri olan alıcıları görüntüleme.

databricks unity-catalog shares list-permissions --name my-share

Çıktı:

{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": [
        "SELECT"
      ]
    }
  ]
}

Paylaşımı silme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog shares delete --help. Ayrıca bkz. Paylaşımı silme.

databricks unity-catalog shares delete --name my-share

İşlem başarılı olursa hiçbir sonuç döndürülür.

Alıcı

unity-catalog recipients Delta Sharing özellikli Unity Kataloğu meta veri depoları için veri alıcılarıyla çalışmak için alt komutu kullanın. Veri alıcıları, Bir Azure Databricks kullanıcısının Azure Databricks kullanıcısının kuruluşunun dışından veri paylaştığı kişiler veya gruplardır. Bkz . Delta Sharing için veri alıcıları oluşturma ve yönetme.

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog recipients --help.

Alıcı oluşturma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog recipients create --help. Ayrıca bkz. Delta Sharing için veri alıcıları oluşturma ve yönetme.

Alıcı için yeni bir etkinleştirme URL'si oluşturmak için komutunu çalıştırın databricks unity-catalog recipients rotate-token. Örnek için bkz . Alıcının belirtecini döndürme.

databricks unity-catalog recipients create --name my-recipient

Çıktı:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Alıcının ayarlarını değiştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog recipients update --help.

databricks unity-catalog recipients update --name my-recipient \
                                           --json-file update-recipient-settings.json

update-recipient-settings.json:

{
  "name": "my-recipient-2"
}

Çıktı:

{
  "name": "my-recipient-2",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656436740986,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Alıcının belirtecini döndürme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog recipients rotate-token --help. Ayrıca bkz. Alıcı belirteçlerini yönetme (paylaşım açma).

databricks unity-catalog recipients rotate-token --name my-recipient \
                                                 --existing-token-expire-in-seconds 900

Çıktı:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Kullanılabilir alıcıları listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog recipients list --help. Ayrıca bkz. Alıcıları görüntüleme.

databricks unity-catalog recipients list

Çıktı:

{
  "recipients": [
    {
      "name": "my-recipient",
      "created_at": 1656435288003,
      "created_by": "someone@example.com",
      "tokens": [
        {
          "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
          "created_at": 1656435288005,
          "created_by": "someone@example.com",
          "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
          "expiration_time": 1656521688006,
          "updated_at": 1656435288006,
          "updated_by": "someone@example.com"
        }
      ],
      "authentication_type": "TOKEN",
      "updated_at": 1656435288003,
      "updated_by": "someone@example.com",
      "owner": "someone@example.com"
    }
  ]
}

Alıcının paylaşım izinlerini listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog recipients list-permissions --help. Ayrıca bkz. Alıcının paylaşım izinlerini görüntüleme.

databricks unity-catalog recipients list-permissions --name my-recipient

Çıktı:

{
  "permissions_out": [
    {
      "share_name": "my-share",
      "privilege_assignments": [
        {
          "privileges": [
            "SELECT"
          ]
        }
      ]
    }
  ]
}

Alıcı hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog recipients get --help. Ayrıca bkz. Alıcı ayrıntılarını görüntüleme.

databricks unity-catalog recipients get --name my-recipient

Çıktı:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Alıcı silme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog recipients delete --help. Ayrıca bkz. Alıcı silme.

databricks unity-catalog recipients delete --name my-recipient

İşlem başarılı olursa hiçbir sonuç döndürülür.

Sağlayıcılar

Delta Sharing paylaşılan veri alıcısıysanız Delta Sharing veri sağlayıcılarıyla çalışmak için alt komutu kullanın unity-catalog providers . Bkz. Delta Sharing sağlayıcılarını yönetme (veri alıcıları için).

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog providers --help.

Sağlayıcı oluşturma

Açık paylaşım protokolü kullanılarak paylaşılan verilerin alıcısıysanız ve Unity Kataloğu meta veri deposuna eklenmiş bir Databricks çalışma alanı kullanıyorsanız, Unity Kataloğu meta veri deponuzda bir sağlayıcı nesnesi oluşturabilirsiniz. Daha sonra Unity Kataloğu'nu kullanarak paylaşılan verilere erişimi yönetebilirsiniz.

Önemli

Bu senaryo nadirdir. Unity Kataloğu için etkinleştirilmiş bir Databricks çalışma alanı kullanıyorsanız ve başka bir Databricks müşterisi sizinle veri paylaşıyorsa Databricks-Databricks paylaşımını kullanmalıdır. Databricks-Databricks paylaşımıyla, Unity Kataloğu'nda sağlayıcı nesneleri sizin için oluşturulur.

Sağlayıcı oluşturmak için şunları kullanmanız gerekir:

  • Meta veri deposu yöneticisi veya meta veri deposu ayrıcalığına sahip CREATE_PROVIDER bir kullanıcı olun.
  • İndirilen kimlik bilgileri dosyasına erişiminiz vardır. Bkz. Açık paylaşım modelinde erişim alma.

Öğesini sağlayıcıya vermek istediğiniz adla ve config.share varsayılan olarak config.share adlı indirilen kimlik bilgisi dosyanızın yoluyla değiştirerek my-provider aşağıdaki komutu çalıştırın.

databricks unity-catalog providers create --name my-provider  \
                  --recipient-profile-json-file config.share

Sağlayıcı ayarlarını güncelleştirme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog providers update --help.

databricks unity-catalog providers update --name my-provider \
                                          --new-name my-provider-2

Kullanılabilir sağlayıcıları listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog providers list --help.

databricks unity-catalog providers list

Sağlayıcı hakkında bilgi alma

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog providers get --help.

databricks unity-catalog providers get --name my-provider

Sağlayıcının kullanılabilir paylaşımlarını listeleme

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog providers list-shares --help.

databricks unity-catalog providers list-shares --name my-provider

Sağlayıcı sil

Kullanım belgelerini görüntülemek için komutunu çalıştırın databricks unity-catalog providers delete --help.

databricks unity-catalog providers delete --name my-provider

İşlem başarılı olursa hiçbir sonuç döndürülür.