Buat penerima data untuk OpenSharing (berbagi data Databricks-ke-Databricks)

Halaman ini menjelaskan cara membuat penerima di OpenSharing, ketika penerima berada di ruang kerja Databricks yang diaktifkan untuk Unity Catalog. Untuk melihat, memperbarui, menghapus, memberikan akses berbagi, mengelola properti, atau membatasi akses dengan daftar IP untuk penerima yang sudah ada, lihat Mengelola penerima data untuk OpenSharing.

Penerima adalah objek bernama yang mewakili identitas pengguna atau grup pengguna yang menggunakan data bersama. Cara Anda membuat penerima berbeda tergantung pada apakah penerima Anda memiliki akses ke ruang kerja Databricks yang diaktifkan untuk Katalog Unity atau tidak:

• Penerima dengan akses ke ruang kerja Databricks dengan fitur Unity Catalog:

  Anda dapat membuat objek penerima dengan koneksi aman yang dikelola oleh Databricks. Mode berbagi ini disebut berbagi Databricks-ke-Databricks, dan didokumenkan di halaman ini.

• Penerima tanpa akses ke ruang kerja Databricks yang mendukung Unity Catalog:

  Anda harus menggunakan berbagi terbuka, dengan koneksi aman yang Anda kelola menggunakan autentikasi berbasis token (baik token pembawa atau federasi OAuth). Untuk informasi tentang membuat penerima berbagi Databricks-to-Open, lihat Mengaktifkan federasi Open ID Connect (OIDC) untuk penerima OpenSharing dan Membuat objek penerima untuk pengguna non-Databricks menggunakan token pembawa (berbagi Databricks-to-Open).

Untuk informasi selengkapnya tentang kedua mode berbagi ini dan kapan harus memilih yang mana, lihat Berbagi Databricks-to-Open versus berbagi Databricks-ke-Databricks.

Requirements

Untuk membuat penerima:

• Anda harus memiliki CREATE RECIPIENT hak istimewa untuk metastore Unity Catalog tempat data yang ingin Anda bagikan terdaftar.
• Anda harus membuat penerima menggunakan ruang kerja Azure Databricks yang memiliki metastore Unity Catalog yang terlampir padanya.
• Jika Anda menggunakan buku catatan Databricks untuk membuat penerima, komputasi Anda harus menggunakan Databricks Runtime 11.3 LTS atau lebih tinggi dan mode akses standar atau khusus (sebelumnya mode akses pengguna bersama dan tunggal).

Untuk izin yang diperlukan untuk operasi penerima lain (menampilkan, memperbarui, menghapus, memberikan akses berbagi, mengelola properti), lihat Mengelola penerima data untuk OpenSharing.

Buat objek penerima untuk pengguna yang mempunyai akses ke Databricks dalam konteks berbagi Databricks-ke-Databricks.

Jika penerima data Anda memiliki akses ke ruang kerja Databricks yang telah diaktifkan untuk Unity Catalog, Anda dapat membuat objek penerima dengan jenis DATABRICKSautentikasi.

Objek penerima dengan jenis DATABRICKS autentikasi mewakili penerima data pada metastore Katalog Unity tertentu, yang diidentifikasi dalam definisi objek penerima dengan string pengidentifikasi berbagi yang terdiri dari cloud, region, dan UUID metastore. Data yang dibagikan dengan penerima ini hanya dapat diakses di metastore tersebut.

Langkah 1: Minta ID berbagi penerima

Minta pengguna penerima untuk mengirimi Anda identitas berbagi untuk metastore Unity Catalog yang dilampirkan pada ruang kerja tempat pengguna penerima atau grup pengguna akan bekerja dengan data yang dibagikan.

Pengidentifikasi berbagi adalah string yang terdiri dari cloud, wilayah, dan UUID metastore (pengidentifikasi unik untuk metastore), dengan format <cloud>:<region>:<uuid>.

Misalnya, dalam cuplikan layar berikut, string pengidentifikasi berbagi lengkap adalah aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

Penerima dapat menemukan pengidentifikasi menggunakan Catalog Explorer, Databricks Unity Catalog CLI, atau fungsi CURRENT_METASTORE SQL default dalam buku catatan Databricks atau kueri Databricks SQL yang berjalan pada komputasi berkemampuan Unity-Catalog di ruang kerja yang ingin mereka gunakan.

Eksplorer Katalog

Untuk mendapatkan pengidentifikasi pembagian menggunakan Catalog Explorer:

1. Di ruang kerja Azure Databricks Anda, klik Catalog.

2. Di bagian atas panel Katalog , klik ikon gerigi dan pilih OpenSharing.

   Atau, di sudut kanan atas, klik Bagikan > OpenSharing.

3. Pada tab Dibagikan dengan saya, klik nama organisasi berbagi Databricks Anda di sudut kanan atas, lalu pilih Salin pengidentifikasi berbagi.

SQL

Jalankan perintah berikut ini di buku catatan atau editor kueri Databricks SQL:

SELECT CURRENT_METASTORE();

CLI

Jalankan perintah berikut menggunakan Databricks CLI. Pengidentifikasi berbagi data dikembalikan sebagai global_metastore_id.

databricks metastores summary

Anda dapat mengirimi penerima informasi yang terkandung dalam langkah ini, atau Anda dapat mengarahkannya ke Mendapatkan akses dalam model Databricks-ke-Databricks.

Langkah 2: Buat penerima

Untuk membuat penerima untuk berbagi Databricks-ke-Databricks, Anda dapat menggunakan Catalog Explorer, Databricks Unity Catalog CLI, atau CREATE RECIPIENT perintah SQL di buku catatan Azure Databricks atau editor kueri Databricks SQL.

Izin diperlukan: Admin atau pengguna Metastore dengan CREATE RECIPIENT hak istimewa untuk metastore Unity Catalog tempat data yang ingin Anda bagikan terdaftar.

Eksplorer Katalog

1. Di ruang kerja Azure Databricks Anda, klik Catalog.

2. Di bagian atas panel Katalog , klik ikon gerigi dan pilih OpenSharing.

   Atau, di sudut kanan atas, klik Bagikan > OpenSharing.

3. Pada tab Dibagikan oleh saya , klik Penerima baru.

4. Masukkan Nama penerima.

5. Untuk Jenis penerima, pilih Databricks.

6. Masukkan pengidentifikasi Berbagi penerima.

   Gunakan seluruh string pengidentifikasi berbagi dalam format <cloud>:<region>:<uuid>. Contohnya, aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.

7. (Opsional) Masukkan komentar.

8. Klik Buat.

9. (Opsional) Buat properti Penerima kustom.

   Klik ikon di tab Edit iconGambaran Umum penerima di samping Properti Penerima. Kemudian tambahkan nama properti (Kunci) dan Nilai. Untuk detailnya, lihat Mengelola properti penerima.

SQL

Jalankan perintah berikut ini di buku catatan atau editor kueri Databricks SQL:

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];

Gunakan seluruh string pengidentifikasi berbagi dalam format <cloud>:<region>:<uuid>. Contohnya, aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.

Anda juga dapat menambahkan properti kustom untuk penerima. Untuk detailnya, lihat Mengelola properti penerima.

CLI

Jalankan perintah berikut menggunakan Databricks CLI. Ganti nilai placeholder ini:

• <recipient-name>: Nama penerima.
• <sharing-identifier>: Seluruh string pengidentifikasi berbagi dalam format <cloud>:<region>:<uuid>. Contohnya, aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef.
• <authentication-type>: Atur ke DATABRICKS saat string pengidentifikasi berbagi dalam format <cloud>:<region>:<uuid> disediakan untuk <sharing-identifier>.

databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

Anda juga dapat menambahkan properti kustom untuk penerima. Untuk detailnya, lihat Mengelola properti penerima.

Penerima dibuat dengan menggunakan authentication_type dari DATABRICKS.

Sumber daya tambahan

• Kelola akses ke berbagi data OpenSharing (untuk penyedia) — Berikan akses penerima ke satu atau beberapa berbagi.
• Mengelola penerima data untuk OpenSharing — Menampilkan, memperbarui, menghapus, mengelola properti, atau membatasi akses untuk penerima yang sudah ada.
• Buat pembagian untuk OpenSharing — Buat pembagian yang ingin Anda berikan akses kepada penerima.