Mengelola penyedia Berbagi Delta (untuk penerima data)
Artikel ini menjelaskan cara menggunakan Katalog Unity untuk mendapatkan informasi tentang penyedia data yang berbagi data dengan Anda menggunakan Berbagi Delta. Ini juga menjelaskan apa itu objek penyedia dan kapan Anda mungkin perlu membuat objek penyedia di metastore Katalog Unity Anda, tugas yang tidak perlu dilakukan oleh sebagian besar penerima.
Penting
Penerima data harus memiliki akses ke ruang kerja Databricks yang diaktifkan bagi Unity Catalog untuk menggunakan fungsionalitas yang dijelaskan dalam artikel ini. Artikel ini tidak berlaku untuk penerima yang tidak memiliki ruang kerja berkemampuan Katalog Unity.
Apakah penerima perlu membuat objek penyedia?
Dalam Berbagi Delta di Databricks, istilah "penyedia" dapat berarti organisasi yang berbagi data dengan Anda dan objek yang dapat diamankan dalam metastore Unity Catalog penerima yang mewakili organisasi tersebut. Keberadaan objek yang dapat diamankan dalam metastore Unity Catalog penerima memungkinkan penerima untuk mengelola akses tim mereka ke data bersama menggunakan Unity Catalog.
Sebagai penerima dengan akses ke metastore Unity Catalog, Anda biasanya tidak perlu membuat objek penyedia. Ini karena data harus dibagikan dengan Anda menggunakan berbagi Databricks-ke-Databricks, dan objek penyedia dibuat secara otomatis di metastore Unity Catalog Anda.
Catatan
Jika Anda adalah penerima langka di Unity Catalog yang menerima data dari penyedia yang tidak berbagi dari ruang kerja Databricks yang didukung Katalog Unity, Anda mungkin ingin membuat objek penyedia di Unity Catalog sehingga Anda dapat mengelola data bersama tersebut menggunakan Katalog Unity. Jika Anda berada dalam kategori tersebut , Anda dapat menggunakan panggilan REST API POST /api/2.1/unity-catalog/providers atau Databricks CLI untuk membuat objek penyedia Katalog Unity. Anda harus menjadi admin metastore atau pengguna dengan CREATE_PROVIDER
hak istimewa untuk metastore.
Sebelum Anda mulai
Untuk mengelola penyedia di ruang kerja Azure Databricks Anda:
- Ruang kerja Anda harus diaktifkan untuk Katalog Unity.
- Untuk melihat penyedia, Anda harus menjadi admin metastore, atau admin metastore harus memberi Anda
USE PROVIDER
hak istimewa. - Untuk membuat penyedia, Anda harus menjadi admin metastore, atau admin metastore harus memberi Anda
CREATE PROVIDER
hak istimewa. - Untuk memperbarui penyedia, Anda harus menjadi pemilik objek penyedia dan memiliki
CREATE PROVIDER
hak istimewa. Untuk detailnya, lihat Memperbarui penyedia (mengganti nama, mengubah pemilik, komentar).
Untuk alasan ini, jika ruang kerja Anda dibuat tanpa admin metastore, admin akun Azure Databricks harus memberi pengguna atau mengelompokkan peran admin metastore sebelum Anda dapat bekerja dengan objek penyedia di Azure Databricks. Lihat Pengaktifan Otomatis Katalog Unity dan (Opsional) Menetapkan peran admin metastore.
Lihat penyedia
Untuk melihat daftar penyedia data yang tersedia, Anda bisa menggunakan Catalog Explorer, Databricks Unity Catalog CLI, atau SHOW PROVIDERS
perintah SQL di notebook Azure Databricks atau editor kueri Databricks SQL.
Izin yang diperlukan: Anda harus menjadi admin metastore atau memiliki USE PROVIDER
hak istimewa untuk melihat semua penyedia di metastore. Pengguna lain hanya memiliki akses ke penyedia yang mereka miliki.
Penjelajah Katalog
Di ruang kerja Azure Databricks Anda, klik Katalog.
Di bagian atas panel Katalog , klik ikon gerigi dan pilih Berbagi Delta.
Atau, dari halaman Akses cepat, klik tombol Berbagi > Delta.
Pada tab Dibagikan dengan saya , lihat semua penyedia yang tersedia.
SQL
Jalankan perintah berikut ini di buku catatan atau editor kueri Databricks SQL. Secara opsional, ganti <pattern>
dengan LIKE
predikat.
SHOW PROVIDERS [LIKE <pattern>];
CLI
Jalankan perintah berikut menggunakan Databricks CLI.
databricks providers list
Lihat detail penyedia
Untuk melihat detail tentang penyedia, Anda bisa menggunakan Catalog Explorer, Databricks Unity Catalog CLI, atau DESCRIBE PROVIDER
perintah SQL di buku catatan Azure Databricks atau editor kueri Databricks SQL.
Izin diperlukan: Admin metastore, pengguna dengan USE PROVIDER
hak istimewa, atau pemilik objek penyedia.
Detailnya mencakup:
- Berbagi yang dibagikan oleh penyedia (lihat Menampilkan berbagi yang telah dibagikan penyedia kepada Anda).
- Pembuat penyedia, tanda waktu pembuatan, komentar, dan jenis autentikasi (
TOKEN
atauDATABRICKS
).TOKEN
mewakili penyedia yang telah berbagi data dengan Anda menggunakan protokol berbagi terbuka Berbagi Delta.DATABRICKS
mewakili penyedia yang telah berbagi data dengan Anda menggunakan protokol berbagi Databricks-to-Databricks. - Jika penyedia menggunakan berbagi Databricks-to-Databricks: cloud, wilayah, dan ID metastore metastore Dari metastore Unity Catalog penyedia.
- Jika penyedia menggunakan berbagi terbuka: titik akhir profil penerima Anda, yang merupakan tempat server berbagi Berbagi Delta dihosting.
Penjelajah Katalog
Di ruang kerja Azure Databricks Anda, klik Katalog.
Di bagian atas panel Katalog , klik ikon gerigi dan pilih Berbagi Delta.
Atau, dari halaman Akses cepat, klik tombol Berbagi > Delta.
Pada tab Dibagikan dengan saya , temukan dan pilih penyedia.
SQL
Jalankan perintah berikut ini di buku catatan atau editor kueri Databricks SQL.
DESC PROVIDER <provider-name>;
CLI
Jalankan perintah berikut menggunakan Databricks CLI.
databricks providers get <provider-name>
Melihat berbagi yang telah dibagikan penyedia dengan Anda
Untuk melihat berbagi yang telah dibagikan penyedia dengan Anda, Anda bisa menggunakan Catalog Explorer, Databricks Unity Catalog CLI, atau SHOW SHARES IN PROVIDER
perintah SQL di buku catatan Azure Databricks atau editor kueri Databricks SQL.
Izin diperlukan: Admin metastore, pengguna dengan USE PROVIDER
hak istimewa, atau pemilik objek penyedia.
Penjelajah Katalog
Di ruang kerja Azure Databricks Anda, klik Katalog.
Di bagian atas panel Katalog , klik ikon gerigi dan pilih Berbagi Delta.
Atau, dari halaman Akses cepat, klik tombol Berbagi > Delta.
Pada tab Dibagikan dengan saya , temukan dan pilih penyedia.
SQL
Jalankan perintah berikut ini di buku catatan atau editor kueri Databricks SQL. Secara opsional, ganti <pattern>
dengan LIKE
predikat.
SHOW SHARES IN PROVIDER [LIKE <pattern>];
CLI
Jalankan perintah berikut menggunakan Databricks CLI.
databricks providers list-shares <provider-name>
Memperbarui penyedia (mengganti nama, mengubah pemilik, komentar)
Anda dapat menggunakan Catalog Explorer, Databricks Unity Catalog CLI, atau ALTER PROVIDER
perintah SQL di buku catatan Azure Databricks atau editor kueri Databricks SQL untuk memodifikasi objek penyedia di metastore Unity Catalog Anda:
- Ganti nama penyedia untuk mengubah cara pengguna melihat objek penyedia di antarmuka Databricks mereka.
- Ubah pemilik objek penyedia.
- Menambahkan atau mengubah komentar.
Izin yang diperlukan: Anda harus menjadi pemilik objek penyedia untuk memperbarui pemilik. Anda harus menjadi admin metastore (atau pengguna dengan CREATE_PROVIDER
hak istimewa) dan pemilik penyedia untuk memperbarui nama penyedia. Anda harus menjadi pemilik untuk memperbarui komentar. Pemilik awal adalah admin metastore.
Penjelajah Katalog
Di ruang kerja Azure Databricks Anda, klik Katalog.
Di bagian atas panel Katalog , klik ikon gerigi dan pilih Berbagi Delta.
Atau, dari halaman Akses cepat, klik tombol Berbagi > Delta.
Pada tab Dibagikan dengan saya , temukan dan pilih penyedia.
Pada halaman detail, perbarui pemilik, komentar, atau nama penyedia.
Untuk mengganti nama penyedia, klik menu kebab dan pilih Ganti Nama.
SQL
Jalankan perintah berikut ini di buku catatan atau editor kueri Databricks SQL.
ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";
CLI
Jalankan perintah berikut menggunakan Databricks CLI. Ganti <provider-name>
dengan nama penyedia saat ini dan <new-provider-name>
dengan nama baru.
databricks providers update <provider-name> /
--new-name <new-provider-name> /
--comment "<new comment>" /
--owner <new-owner-name>
Menghapus penyedia
Untuk menghapus penyedia, Anda dapat menggunakan Catalog Explorer, Databricks Unity Catalog CLI, atau DROP PROVIDER
perintah SQL di buku catatan Azure Databricks atau editor kueri Databricks SQL. Anda harus menjadi pemilik objek penyedia untuk menghapus penyedia.
Saat menghapus penyedia, Anda dan pengguna di organisasi Anda (penerima) tidak dapat lagi mengakses data yang dibagikan oleh penyedia.
Izin diperlukan: Pemilik objek penyedia.
Penjelajah Katalog
Di ruang kerja Azure Databricks Anda, klik Katalog.
Di bagian atas panel Katalog , klik ikon gerigi dan pilih Berbagi Delta.
Atau, dari halaman Akses cepat, klik tombol Berbagi > Delta.
Pada tab Dibagikan dengan saya , temukan dan pilih penyedia.
Klik menu kebab dan pilih Hapus.
Pada dialog konfirmasi, klik Hapus.
SQL
Jalankan perintah berikut ini di buku catatan atau editor kueri Databricks SQL.
DROP PROVIDER [IF EXISTS] <provider-name>;
CLI
Jalankan perintah berikut menggunakan Databricks CLI.
databricks providers delete <provider-name>
Jika operasi berhasil, tidak ada hasil yang dikembalikan.