Bagikan melalui

Unity Catalog CLI (warisan)

  • Artikel

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:

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.

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.

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"
}

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 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

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

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.

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

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

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

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

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

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.