Unity Catalog CLI (warisan)
Penting
Dokumentasi ini telah dihentikan dan mungkin tidak diperbarui.
Informasi ini berlaku untuk CLI Databricks warisan versi 0.18 ke bawah. Databricks merekomendasikan agar Anda menggunakan Databricks CLI versi 0.205 atau lebih baru. Lihat Apa itu Databricks CLI?. Untuk menemukan versi Databricks CLI Anda, jalankan databricks -v
.
Untuk bermigrasi dari Databricks CLI versi 0.18 atau di bawahnya ke Databricks CLI versi 0.205 atau lebih tinggi, lihat migrasi CLI Databricks.
Catatan
Unity Catalog CLI bersifat Eksperimental.
Unity Catalog CLI memerlukan Databricks CLI (warisan) 0.17.0 atau lebih tinggi, dikonfigurasi dengan autentikasi. Untuk memperbarui Databricks CLI atau untuk mencantumkan versi yang diinstal, lihat Memperbarui CLI.
Opsi dan nilai sampel bidang dalam contoh berikut hanya untuk tujuan ilustrasi.
Gunakan Unity Catalog CLI untuk bekerja dengan:
- Sumber daya Unity Catalog seperti metastores, kredensial penyimpanan, lokasi eksternal, katalog, skema, tabel, dan izinnya.
- Sumber daya Berbagi Delta seperti berbagi, penerima, dan penyedia.
Anda menjalankan sub-perintah Unity Catalog CLI dengan menambahkannya ke databricks unity-catalog
. Sub-perintah ini memanggil UNITY Catalog API, yang juga menyertakan API Berbagi Delta.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog --help
.
Output:
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
Metastore
unity-catalog metastores
Gunakan sub perintah untuk bekerja dengan metastores.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog metastores --help
.
- Membuat metastore
- Menautkan metastore dengan ruang kerja
- Memperbarui pengaturan metastore
- Mencantumkan metastores yang tersedia
- Mendapatkan informasi tentang metastore
- Dapatkan informasi ringkasan tentang metastore saat ini
- Mendapatkan penetapan metastore saat ini untuk ruang kerja
- Membatalkan tautan metastore dari ruang kerja
- Menghapus metastore
Buat metastore
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog metastores create --help
. Lihat juga Membuat metastore Unity Catalog.
Catatan
Membuat metastore tidak secara otomatis mengaitkan metastore dengan ruang kerja atau kredensial penyimpanan. Untuk menyelesaikan tugas ini, lihat Menautkan metastore dengan ruang kerja, Membuat kredensial penyimpanan, dan Memperbarui pengaturan metastore.
Menautkan metastore dengan ruang kerja
Jika Anda menjalankan perintah ini pada ruang kerja yang sudah memiliki metastore yang ditetapkan, Anda akan memperbarui metastore yang ditetapkan ruang kerja tersebut.
Untuk menampilkan dokumentasi penggunaan, jalankan 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
Untuk mendapatkan ID ruang kerja, lihat Nama instans ruang kerja, URL, dan ID.
Untuk mendapatkan ID metastore, jalankan databricks unity-catalog metastores get-summary
. Misalnya, lihat Mendapatkan informasi ringkasan tentang metastore saat ini.
Output:
{}
Lihat juga Membuat metastore Unity Catalog.
Memperbarui pengaturan metastore
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog metastores update --help
.
databricks unity-catalog metastores update --id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
--json-file update-metastore.json
Untuk mendapatkan ID metastore, jalankan databricks unity-catalog metastores get-summary
. Misalnya, lihat Mendapatkan informasi ringkasan tentang metastore saat ini.
update-metastore.json
:
{
"storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
}
Untuk mendapatkan ID kredensial akar penyimpanan, lihat Mendapatkan informasi tentang kredensial penyimpanan.
Mencantumkan metastores yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog metastores list --help
.
databricks unity-catalog metastores list
Mendapatkan informasi tentang metastore
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog metastores get --help
.
databricks unity-catalog metastores get --id 12a345b6-7890-1cd2-3456-e789f0a12b34
Untuk mendapatkan ID metastore, jalankan databricks unity-catalog metastores get-summary
. Misalnya, lihat Mendapatkan informasi ringkasan tentang metastore saat ini.
Dapatkan informasi ringkasan tentang metastore saat ini
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog metastores get-summary --help
.
databricks unity-catalog metastores get-summary
Mendapatkan penetapan metastore saat ini untuk ruang kerja
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog metastores get-assignment --help
.
databricks unity-catalog metastores get-assignment
Output:
{
"workspace_id": 1234567890123456,
"metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
"default_catalog_name": "main"
}
Membatalkan tautan metastore dari ruang kerja
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog metastores unassign --help
.
databricks unity-catalog metastores unassign --workspace-id 1234567890123456 \
--metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34
Untuk mendapatkan ID ruang kerja, lihat Nama instans ruang kerja, URL, dan ID.
Untuk mendapatkan ID metastore, jalankan databricks unity-catalog metastores get-summary
. Misalnya, lihat Mendapatkan informasi ringkasan tentang metastore saat ini.
Output:
{}
Menghapus metastore
Peringatan
Sebelum menghapus metastore, Anda harus menghapus ruang kerja apa pun yang menggunakan metastore atau menghapus tautan metastore ke ruang kerja tersebut. Hubungi dukungan Azure Databricks untuk bantuan dalam menghapus tautan metastore dari ruang kerja.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog metastores delete --help
.
Untuk menghapus metastore secara paksa, gunakan --force
opsi .
databricks unity-catalog metastores delete --id 12a345b6-7890-1cd2-3456-e789f0a12b34
Untuk mendapatkan ID metastore, jalankan databricks unity-catalog metastores get-summary
. Misalnya, lihat Mendapatkan informasi ringkasan tentang metastore saat ini.
Jika operasi berhasil, tidak ada hasil yang dikembalikan.
Info masuk penyimpanan
unity-catalog storage-credentials
Gunakan sub perintah untuk bekerja dengan kredensial penyimpanan. Lihat Membuat kredensial penyimpanan untuk menyambungkan ke Azure Data Lake Storage Gen2.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog storage-credentials --help
.
- Membuat kredensial penyimpanan
- Memperbarui pengaturan kredensial penyimpanan
- Mencantumkan kredensial penyimpanan yang tersedia
- Mendapatkan informasi tentang kredensial penyimpanan
- Menghapus kredensial penyimpanan
Membuat info masuk penyimpanan
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog storage-credentials create --help
.
Lihat juga Membuat kredensial penyimpanan untuk menyambungkan ke Azure Data Lake Storage Gen2.
Memperbarui pengaturan kredensial penyimpanan
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog storage-credentials update --help
.
Mencantumkan kredensial penyimpanan yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog storage-credentials list --help
.
databricks unity-catalog storage-credentials list
Mendapatkan informasi tentang kredensial penyimpanan
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog storage-credentials get --help
.
databricks unity-catalog storage-credentials get --name my-storage-root-credential
Menghapus info masuk penyimpanan
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog storage-credentials delete --help
.
Untuk menghapus kredensial penyimpanan secara paksa, gunakan --force
opsi .
databricks unity-catalog storage-credentials delete --name my-storage-root-credential
Jika operasi berhasil, tidak ada hasil yang dikembalikan.
Lokasi eksternal
unity-catalog external-locations
Gunakan sub perintah untuk bekerja dengan lokasi eksternal. Lihat Membuat lokasi eksternal untuk menyambungkan penyimpanan cloud ke Azure Databricks.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog external-locations --help
.
- Membuat lokasi eksternal
- Memvalidasi lokasi eksternal dan pasangan kredensial
- Memperbarui pengaturan lokasi eksternal
- Mencantumkan lokasi eksternal yang tersedia
- Mendapatkan informasi tentang lokasi eksternal
- Menghapus lokasi eksternal
Membuat lokasi eksternal
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog external-locations create --help
. Lihat juga Membuat lokasi eksternal untuk menyambungkan penyimpanan cloud ke Azure Databricks.
Memvalidasi lokasi eksternal dan pasangan kredensial
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog external-locations validate --help
.
Memvalidasi nama lokasi eksternal dan pasangan kredensial setelah Anda membuatnya
databricks unity-catalog external-locations validate --name my-external-location \
--cred-name my-storage-root-credential
Output:
{
"isDir": true,
"results": [
{
"operation": "READ",
"result": "PASS"
},
{
"operation": "LIST",
"result": "PASS"
},
{
"operation": "WRITE",
"result": "PASS"
},
{
"operation": "DELETE",
"result": "PASS"
}
]
}
Memperbarui pengaturan lokasi eksternal
Untuk menampilkan dokumentasi penggunaan, jalankan 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"
}
Mencantumkan lokasi eksternal yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog external-locations list --help
.
databricks unity-catalog external-locations list
Mendapatkan informasi tentang lokasi eksternal
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog external-locations get --help
.
databricks unity-catalog external-locations get --name my-external-location
Menghapus lokasi eksternal
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog external-locations delete --help
.
Untuk menghapus lokasi eksternal secara paksa, gunakan --force
opsi .
databricks unity-catalog external-locations delete --name my-external-location
Jika operasi berhasil, tidak ada hasil yang dikembalikan.
Katalog
unity-catalog catalogs
Gunakan sub perintah untuk bekerja dengan katalog.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog catalogs --help
.
- Membuat katalog
- Memperbarui pengaturan katalog
- Mencantumkan katalog yang tersedia
- Mendapatkan informasi tentang katalog
- Menghapus katalog
Membuat katalog
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog catalogs create --help
. Lihat juga Membuat katalog.
databricks unity-catalog catalogs create --name my-catalog
Output:
{
"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"
}
Memperbarui pengaturan katalog
Untuk menampilkan dokumentasi penggunaan, jalankan 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"
}
Output:
{
"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"
}
Mencantumkan katalog yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog catalogs list --help
.
databricks unity-catalog catalogs list
Output:
{
"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"
},
{
"...": "..."
}
]
}
Mendapatkan informasi tentang katalog
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog catalogs get --help
.
databricks unity-catalog catalogs get --name my-catalog
Output:
{
"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"
}
Menghapus katalog
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog catalogs delete --help
. Lihat juga Menghapus katalog.
Untuk menghapus katalog secara paksa, gunakan --purge
opsi .
databricks unity-catalog catalogs delete --name my-catalog
Jika operasi berhasil, tidak ada hasil yang dikembalikan.
Skema
unity-catalog schemas
Gunakan sub perintah untuk bekerja dengan skema.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog schemas --help
.
- Membuat skema
- Mengubah pengaturan skema
- Mencantumkan skema yang tersedia
- Mendapatkan informasi tentang skema
- Menghapus skema
Buat grup skema
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog schemas create --help
. Lihat juga Membuat skema.
databricks unity-catalog schemas create --catalog-name my-catalog \
--name my-schema
Output:
{
"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"
}
Mengubah pengaturan skema
Untuk menampilkan dokumentasi penggunaan, jalankan 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"
}
Output:
{
"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"
}
Mencantumkan skema yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog schemas list --help
.
databricks unity-catalog schemas list --catalog-name my-catalog
Output:
{
"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"
},
{
"...": "..."
}
]
}
Mendapatkan informasi tentang skema
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog schemas get --help
.
databricks unity-catalog schemas get --full-name my-catalog.my-schema
Output:
{
"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"
}
Menghapus skema
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog schemas delete --help
. Lihat juga Menghapus skema.
Untuk menghapus skema secara paksa, gunakan --purge
opsi .
databricks unity-catalog schemas delete --full-name my-catalog.my-schema
Jika operasi berhasil, tidak ada hasil yang dikembalikan.
Tabel
unity-catalog tables
Gunakan sub perintah untuk bekerja dengan tabel.
Catatan
Membuat tabel dengan Unity Catalog CLI tidak didukung. Untuk membuat tabel, lihat Apa itu tabel? dan Tutorial: Membuat tabel pertama Anda dan memberikan hak istimewa.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog tables --help
.
- Mencantumkan tabel yang tersedia
- Mencantumkan ringkasan tabel yang tersedia
- Mendapatkan informasi tentang tabel
- Menghapus tabel
Mencantumkan tabel yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog tables list --help
.
databricks unity-catalog tables list --catalog-name main \
--schema-name default
Mencantumkan ringkasan tabel yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog tables list-summaries --help
.
databricks unity-catalog tables list-summaries --catalog-name main
Output:
{
"tables": [
{
"full_name": "main.default.mytable",
"table_type": "MANAGED"
},
{
"...": "..."
}
]
}
Mendapatkan informasi tentang tabel
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog tables get --help
.
databricks unity-catalog tables get --full-name main.default.mytable
Menghapus tabel
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog tables delete --help
.
databricks unity-catalog tables delete --full-name main.default.mytable
Jika operasi berhasil, tidak ada hasil yang dikembalikan.
Garis keturunan
unity-catalog lineage
Gunakan sub perintah untuk bekerja dengan silsilah tabel dan kolom.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog lineage --help
.
Mencantumkan silsilah tabel
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog lineage table --help
.
databricks unity-catalog lineage table --table-name main.default.mytable \
--level 1
Mencantumkan silsilah kolom
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog lineage column --help
.
databricks unity-catalog lineage column --table-name main.default.mytable \
--column-name id
Izin
unity-catalog permissions
Gunakan sub-perintah untuk bekerja dengan izin untuk objek yang dapat diamankan. Lihat juga Mengelola hak istimewa di Katalog Unity.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog permissions --help
.
- Mendapatkan informasi tentang izin untuk objek yang dapat diamankan
- Memperbarui izin objek yang dapat diamankan
Mendapatkan informasi tentang izin untuk objek yang dapat diamankan
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog permissions get --help
. Lihat juga hak istimewa Unity Catalog dan objek yang dapat diamankan.
Katalog
databricks unity-catalog permissions get --catalog main
Output:
{
"privilege_assignments": [
{
"principal": "account users",
"privileges": [
"USE CATALOG"
]
}
]
}
Skema
databricks unity-catalog permissions get --schema main.default
Output:
{
"privilege_assignments": [
{
"principal": "account users",
"privileges": [
"USE SCHEMA"
]
}
]
}
Tabel
databricks unity-catalog permissions get --table main.default.mytable
Output:
{
"privilege_assignments": [
{
"principal": "account users",
"privileges": [
"SELECT"
]
}
]
}
Kredensial penyimpanan
databricks unity-catalog permissions get --storage-credential my-storage-root-credential
Output:
{
"privilege_assignments": [
{
"principal": "account users",
"privileges": [
"READ_FILES"
]
}
]
}
Lokasi eksternal
databricks unity-catalog permissions get --external-location my-external-location
Output:
{
"privilege_assignments": [
{
"principal": "account users",
"privileges": [
"READ_FILES"
]
}
]
}
Memperbarui izin objek yang dapat diamankan
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog permissions update --help
. Lihat juga hak istimewa Unity Catalog dan objek yang dapat diamankan.
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" ]
}
]
}
Skema
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" ]
}
]
}
Tabel
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" ]
}
]
}
Kredensial penyimpanan
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" ]
}
]
}
Lokasi eksternal
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" ]
}
]
}
Berbagi
unity-catalog shares
Gunakan sub perintah untuk bekerja dengan berbagi, yang merupakan objek yang berisi kumpulan tabel dalam metastore Unity Catalog berkemampuan Berbagi Delta yang ingin Anda bagikan sebagai grup dengan penerima Berbagi Delta. Berbagi dapat berisi tabel hanya dari satu metastore. Lihat Membuat dan mengelola berbagi untuk Berbagi Delta.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog shares --help
.
- Membuat berbagi
- Memperbarui pengaturan berbagi
- Memperbarui izin berbagi
- Mencantumkan berbagi yang tersedia
- Mendapatkan informasi tentang berbagi
- Mencantumkan izin berbagi
- Menghapus berbagi
Membuat berbagi
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog shares create --help
. Lihat juga Membuat dan mengelola berbagi untuk Berbagi Delta.
databricks unity-catalog shares create --name my-share
Output:
{
"name": "my-share",
"created_at": 1656433327533,
"created_by": "someone@example.com",
"owner": "someone@example.com"
}
Memperbarui pengaturan berbagi
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog shares update --help
. Lihat juga Memperbarui berbagi.
Menambahkan tabel ke berbagi
databricks unity-catalog shares update --name my-share \
--add-table main.default.mytable
Output:
{
"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"
}
Lihat juga Menambahkan tabel ke berbagi.
Menghapus tabel dari berbagi
databricks unity-catalog shares update --name my-share \
--remove-table main.default.mytable
Output:
{
"name": "my-share",
"created_at": 1656433327533,
"created_by": "someone@example.com",
"owner": "someone@example.com"
}
Lihat juga Menambahkan tabel ke berbagi.
Memperbarui izin berbagi
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog shares update-permissions --help
. Lihat juga Mengelola akses ke berbagi data Berbagi Delta (untuk penyedia).
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"
]
}
]
}
Mencantumkan berbagi yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog shares list --help
. Lihat juga Menampilkan berbagi dan berbagi detail.
databricks unity-catalog shares list
Output:
{
"shares": [
{
"name": "my-share",
"created_at": 1656433327533,
"created_by": "someone@example.com",
"owner": "someone@example.com"
},
{
"...": "..."
}
]
}
Mendapatkan informasi tentang berbagi
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog shares get --help
. Lihat juga Menampilkan berbagi dan berbagi detail.
databricks unity-catalog shares get --name my-share
Output:
{
"name": "my-share",
"created_at": 1656433327533,
"created_by": "someone@example.com",
"owner": "someone@example.com"
}
Mencantumkan izin berbagi
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog shares list-permissions --help
. Lihat juga Menampilkan penerima yang memiliki izin pada berbagi.
databricks unity-catalog shares list-permissions --name my-share
Output:
{
"privilege_assignments": [
{
"principal": "my-recipient",
"privileges": [
"SELECT"
]
}
]
}
Menghapus berbagi
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog shares delete --help
. Lihat juga Menghapus berbagi.
databricks unity-catalog shares delete --name my-share
Jika operasi berhasil, tidak ada hasil yang dikembalikan.
Penerima
unity-catalog recipients
Gunakan sub-perintah untuk bekerja dengan penerima data untuk metodori Unity Catalog yang diaktifkan Berbagi Delta. Penerima data adalah orang atau grup yang berbagi data dengan pengguna Azure Databricks di luar organisasi pengguna Azure Databricks. Lihat Membuat dan mengelola penerima data untuk Berbagi Delta.
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog recipients --help
.
- Membuat penerima
- Mengubah pengaturan penerima
- Memutar token penerima
- Mencantumkan penerima yang tersedia
- Mencantumkan izin berbagi penerima
- Mendapatkan informasi tentang penerima
- Menghapus penerima
Membuat penerima
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog recipients create --help
. Lihat juga Membuat dan mengelola penerima data untuk Berbagi Delta.
Untuk menghasilkan URL aktivasi baru untuk penerima, jalankan databricks unity-catalog recipients rotate-token
. Misalnya, lihat Memutar token penerima.
databricks unity-catalog recipients create --name my-recipient
Output:
{
"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"
}
Mengubah pengaturan penerima
Untuk menampilkan dokumentasi penggunaan, jalankan 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"
}
Output:
{
"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"
}
Memutar token penerima
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog recipients rotate-token --help
. Lihat juga Mengelola token penerima (berbagi terbuka).
databricks unity-catalog recipients rotate-token --name my-recipient \
--existing-token-expire-in-seconds 900
Output:
{
"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"
}
Mencantumkan penerima yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog recipients list --help
. Lihat juga Menampilkan penerima.
databricks unity-catalog recipients list
Output:
{
"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"
}
]
}
Mencantumkan izin berbagi penerima
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog recipients list-permissions --help
. Lihat juga Menampilkan izin berbagi penerima.
databricks unity-catalog recipients list-permissions --name my-recipient
Output:
{
"permissions_out": [
{
"share_name": "my-share",
"privilege_assignments": [
{
"privileges": [
"SELECT"
]
}
]
}
]
}
Mendapatkan informasi tentang penerima
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog recipients get --help
. Lihat juga Menampilkan detail penerima.
databricks unity-catalog recipients get --name my-recipient
Output:
{
"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"
}
Menghapus penerima
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog recipients delete --help
. Lihat juga Menghapus penerima.
databricks unity-catalog recipients delete --name my-recipient
Jika operasi berhasil, tidak ada hasil yang dikembalikan.
Penyedia
Jika Anda adalah penerima data bersama Berbagi Delta, gunakan unity-catalog providers
sub-perintah untuk bekerja dengan penyedia data Berbagi Delta. Lihat Mengelola penyedia Berbagi Delta (untuk penerima data).
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog providers --help
.
- Membuat penyedia
- Memperbarui pengaturan penyedia
- Mencantumkan penyedia yang tersedia
- Mendapatkan informasi tentang penyedia
- Mencantumkan berbagi penyedia yang tersedia
- Menghapus penyedia
Membuat penyedia
Jika Anda adalah penerima data yang dibagikan menggunakan protokol berbagi terbuka dan Anda menggunakan ruang kerja Databricks yang dilampirkan ke metastore Katalog Unity, Anda dapat membuat objek penyedia di metastore Unity Catalog Anda. Anda kemudian dapat mengelola akses ke data bersama menggunakan Unity Catalog.
Penting
Skenario ini jarang terjadi. Jika Anda menggunakan ruang kerja Databricks yang diaktifkan untuk Unity Catalog, dan pelanggan Databricks lain berbagi data dengan Anda, mereka harus menggunakan berbagi Databricks-ke-Databricks. Dengan berbagi Databricks-ke-Databricks, objek penyedia dibuat untuk Anda di Unity Catalog.
Untuk membuat penyedia, Anda harus:
- Jadilah admin metastore atau pengguna dengan
CREATE_PROVIDER
hak istimewa untuk metastore. - Memiliki akses ke file kredensial yang diunduh. Lihat Mendapatkan akses dalam model berbagi terbuka.
Jalankan perintah berikut, ganti my-provider
dengan nama yang ingin Anda berikan ke penyedia dan config.share
dengan jalur ke file kredensial yang diunduh, yang diberi nama config.share secara default.
databricks unity-catalog providers create --name my-provider \
--recipient-profile-json-file config.share
Memperbarui pengaturan penyedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog providers update --help
.
databricks unity-catalog providers update --name my-provider \
--new-name my-provider-2
Mencantumkan penyedia yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog providers list --help
.
databricks unity-catalog providers list
Mendapatkan informasi tentang penyedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog providers get --help
.
databricks unity-catalog providers get --name my-provider
Mencantumkan berbagi penyedia yang tersedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog providers list-shares --help
.
databricks unity-catalog providers list-shares --name my-provider
Menghapus penyedia
Untuk menampilkan dokumentasi penggunaan, jalankan databricks unity-catalog providers delete --help
.
databricks unity-catalog providers delete --name my-provider
Jika operasi berhasil, tidak ada hasil yang dikembalikan.