Unity Kataloğu CLI (eski)
Ö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:
- Meta veri depoları, depolama kimlik bilgileri, dış konumlar, kataloglar, şemalar, tablolar ve bunların izinleri gibi Unity Kataloğu kaynakları.
- Paylaşımlar, alıcılar ve sağlayıcılar gibi Delta Sharing kaynakları.
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
- Meta veri depolarını çalışma alanına bağlama
- Meta veri deposu ayarlarını güncelleştirme
- Kullanılabilir meta veri depolarını listeleme
- Meta veri deposu hakkında bilgi alma
- Geçerli meta veri deposu hakkında özetlenmiş bilgileri alma
- Çalışma alanı için geçerli meta veri deposu atamasını alma
- Bir meta veri deposuyla çalışma alanının bağlantısını kaldırma
- Meta veri depolarını silme
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.
Meta veri depolarını çalışma alanına bağlama
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"
}
Bir meta veri deposuyla çalışma alanının bağlantısını kaldırma
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.
Depolama kimlik bilgileri
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
- Depolama kimlik bilgilerinin ayarlarını güncelleştirme
- Kullanılabilir depolama kimlik bilgilerini listeleme
- Depolama kimlik bilgileri hakkında bilgi alma
- Depolama kimlik bilgilerini silme
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
- Dış konumu ve kimlik bilgisi çifti doğrulama
- Dış konumun ayarlarını güncelleştirme
- Kullanılabilir dış konumları listeleme
- Dış konum hakkında bilgi alma
- Dış konumu silme
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
- Kataloğun ayarlarını güncelleştirme
- Kullanılabilir katalogları listeleme
- Katalog hakkında bilgi alma
- Kataloğu silme
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
- Şema ayarlarını değiştirme
- Kullanılabilir şemaları listeleme
- Şema hakkında bilgi alma
- Şema silme
Ş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 . Tablo nedir? 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ılabilir tabloların özetlerini listeleme
- Tablo hakkında bilgi alma
- Tablo silme
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
- Güvenli hale getirilebilir bir nesnenin izinlerini güncelleştirme
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
- Paylaşımın ayarlarını güncelleştirme
- Paylaşımın izinlerini güncelleştirme
- Kullanılabilir paylaşımları listeleme
- Paylaşım hakkında bilgi alma
- Paylaşımın izinlerini listeleme
- Paylaşımı silme
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
- Alıcının ayarlarını değiştirme
- Alıcının belirtecini döndürme
- Kullanılabilir alıcıları listeleme
- Alıcının paylaşım izinlerini listeleme
- Alıcı hakkında bilgi alma
- Alıcı silme
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
- Sağlayıcı ayarlarını güncelleştirme
- Kullanılabilir sağlayıcıları listeleme
- Sağlayıcı hakkında bilgi alma
- Sağlayıcının kullanılabilir paylaşımlarını listeleme
- Sağlayıcıyı silme
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.