Membuat domain data

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Domain dan subdomain data di Knowledge Catalog (sebelumnya Dataplex Universal Catalog) memungkinkan Anda mengatur aset dan produk data ke dalam hierarki logis yang mencerminkan struktur bisnis Anda. Setelah membuat domain, Anda dapat memberikan peran dan izin Identity and Access Management untuk mengontrol cara pengguna berinteraksi dengan domain dan resource-nya.

Sebelum memulai

Sebelum membuat domain data dan menetapkan pemilik domain, pastikan Anda memiliki peran dan API yang diperlukan.

• Kedalaman bertingkat maksimum untuk domain dan subdomain adalah lima tingkat.
• Anda dapat membuat hingga 50 subdomain langsung dalam satu domain data.
• Dalam sebuah project, Anda dapat memiliki hingga 1.000 domain per region.

Mengaktifkan API

Aktifkan Dataplex API, jika belum diaktifkan.

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Mengaktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna membuat domain data dan menetapkan pemilik domain, minta administrator untuk memberi Anda peran IAM berikut pada project:

• Memungkinkan pengelolaan penuh domain data, binding-nya, dan kebijakan IAM: Dataplex Data Domain Admin (roles/dataplex.dataDomainAdmin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat domain data

Buat domain data menggunakan konsol Google Cloud atau REST API untuk berfungsi sebagai pengelompokan logis untuk aset dan produk data dalam project dan lokasi.

Konsol

1. Di konsol Google Cloud , buka halaman Data domains.

   Buka Domain data

2. Klik Create Data Domain dan berikan informasi berikut:

   • Di kolom Display name, berikan nama tampilan yang mudah digunakan untuk domain. Contoh, Finance.
   • Di kolom ID Domain Data, berikan ID unik untuk domain. Anda tidak dapat mengubah nilai ini setelah sistem membuat domain.
   • Di kolom Location, pilih region tempat Anda ingin membuat domain data.
   • Di kolom Project ID, pilih project tempat Anda ingin membuat domain data.
   • Opsional: Di kolom Description, berikan deskripsi singkat tentang domain.
   • Di kolom Pemilik, tambahkan pemilik domain. Anda dapat memasukkan beberapa alamat email sekaligus.

3. Opsional: Di kolom Labels, masukkan label untuk mengelompokkan objek terkait secara bersamaan atau dengan resource Google Cloud lainnya.

4. Klik Create. Mungkin perlu waktu beberapa menit sebelum Anda dapat mengakses atau menelusuri domain data.

REST

Untuk membuat domain data, gunakan metode projects.locations.dataDomains.create.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID project Google Cloud Anda.
• LOCATION_ID: region tempat Anda ingin membuat domain data. Contoh, us-central1.
• DATA_DOMAIN_ID: ID unik untuk domain data Anda.

Metode HTTP dan URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=DATA_DOMAIN_ID

Meminta isi JSON:

{
  "display_name": "Finance Domain",
  "description": "Domain for finance datasets and reports.",
  "contacts": {
    "identities": [
      {
        "contact_name": "Alice Wonderland",
        "contact_role": "owner",
        "contact_id": "[e-mail]"
      }
    ]
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=DATA_DOMAIN_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=DATA_DOMAIN_ID" | Select-Object -Expand Content

Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Membuat subdomain data

Buat subdomain menggunakan konsol Google Cloud atau REST API untuk memperluas hierarki domain data.

Konsol

1. Di konsol Google Cloud , buka halaman Data domains.

   Buka Domain data

2. Pilih domain yang ingin Anda buat subdomainnya.

3. Klik Create Data Subdomain dan berikan informasi berikut:

   • Di kolom Display name, berikan nama tampilan yang mudah digunakan untuk domain. Contoh, Finance.
   • Di kolom ID Domain Data, berikan ID unik untuk domain. Anda tidak dapat mengubah nilai ini setelah sistem membuat domain.
   • Opsional: Di kolom Description, berikan deskripsi singkat tentang domain.
   • Di kolom Pemilik, tambahkan alamat email pemilik domain. Anda dapat memasukkan beberapa alamat email sekaligus.

4. Opsional: Di kolom Labels, masukkan label untuk mengelompokkan objek terkait secara bersamaan atau dengan resource Google Cloud lainnya.

5. Klik Create. Mungkin perlu waktu beberapa menit sebelum Anda dapat mengakses atau menelusuri subdomain data.

REST

Untuk membuat subdomain data, gunakan metode projects.locations.dataDomains.create dan tentukan parent_data_domain dalam isi permintaan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID project Google Cloud Anda.
• LOCATION_ID: region tempat domain data induk berada. Contoh, us-central1.
• SUBDOMAIN_ID: ID unik untuk subdomain data Anda.
• PARENT_DATA_DOMAIN_ID: ID unik domain data induk tempat subdomain ini dibuat.

Metode HTTP dan URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=SUBDOMAIN_ID

Meminta isi JSON:

{
  "display_name": "Finance Subdomain",
  "description": "A subdomain within the Finance domain.",
  "contacts": {
    "identities": [
      {
        "contact_name": "Alice Wonderland",
        "contact_role": "owner",
        "contact_id": "[e-mail]"
      }
    ]
  },
  "parent_data_domain": "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DATA_DOMAIN_ID"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=SUBDOMAIN_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=SUBDOMAIN_ID" | Select-Object -Expand Content

Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Peran dan izin domain data

Tabel berikut mencantumkan peran IAM yang telah ditetapkan yang dapat Anda berikan kepada pemilik dan pengguna domain data.

Nama peran	Peran IAM	Deskripsi
Dataplex Data Domain Admin	roles/dataplex.dataDomainAdmin	Memungkinkan Anda membuat dan mengelola domain dan subdomain data beserta binding-nya. Peran Admin juga memungkinkan Anda mengelola semua peran dan izin IAM untuk domain.
Dataplex Data Domain Configuration Viewer	roles/dataplex.dataDomainViewer	Memungkinkan Anda melihat konfigurasi domain data dan binding domain resource.
Dataplex Data Domain Configuration Editor	roles/dataplex.dataDomainEditor	Memungkinkan Anda mengedit domain yang ada serta membuat dan mengelola binding resource-domain. Peran Editor juga memungkinkan Anda mengelola otorisasi metadata yang memungkinkan penemuan resource domain oleh pengguna.
Dataplex Data Domain Entry Reader	roles/dataplex.dataDomainEntryReader	Memungkinkan Anda menemukan dan melihat domain data, subdomainnya, dan metadata semua resource yang disertakan.

Saat Anda memberikan peran kepada pemilik atau pengguna domain, pertimbangkan hal berikut:

• Peran domain data Identity and Access Management diterapkan dari domain induk ke subdomain, tetapi tidak langsung ke resource yang disertakan. Artinya, jika Anda memberikan roles/dataplex.dataDomainEntryReader kepada pengguna domain yang menyertakan set data BigQuery, pengguna tidak akan melihat peran tersebut di antara peran Identity and Access Management set data.

• Peran roles/dataplex.dataDomainEntryReader yang diberikan pada domain memungkinkan Anda melakukan tindakan berikut:

  • Anda dapat menemukan resource, detail, dan metadatanya, tetapi saat Anda melihat resource dalam domain. Untuk mengetahui informasi selengkapnya, lihat Batasan domain data.
  • Anda dapat menggunakan metode API seperti lookupEntry pada resource yang terletak di domain.

Memberikan akses ke domain data

Untuk memberikan peran dan izin IAM kepada pengguna yang berinteraksi dengan domain data dan resource-nya, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Data domains.

   Buka Domain data

2. Klik nama domain untuk membuka halaman detail domain.

3. Di panel atas, klik Izin.

4. Klik Add principal.

5. Di kolom New principals, masukkan alamat email akun utama.

6. Di kolom Select a role, pilih peran domain data. Misalnya, gunakan Dataplex Data Domain Entry Reader untuk mengizinkan pengguna menemukan dan melihat domain data, subdomainnya, dan metadata resource yang disertakan. Jika Anda ingin memberikan peran lainnya, klik Add another role.

7. Klik Simpan.

REST

Untuk menetapkan kebijakan IAM pada domain data, gunakan metode projects.locations.dataDomains.setIamPolicy.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID project Google Cloud Anda.
• LOCATION_ID: region tempat domain data berada. Contoh, us-central1.
• DOMAIN_ID: ID unik domain data.
• ROLE: peran yang ingin Anda berikan kepada pengguna domain.

Metode HTTP dan URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:setIamPolicy

Meminta isi JSON:

{
  "policy": {
    "bindings": [
      {
        "role": "ROLE",
        "members": [
          "user:[e-mail]",
          "group:[e-mail]"
        ]
      }
    ]
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:setIamPolicy"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:setIamPolicy" | Select-Object -Expand Content

Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Mencabut akses ke domain data

Untuk menghapus peran atau izin dari akun utama, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Data domains.

   Buka Domain data

2. Klik nama domain untuk membuka halaman detail domain.

3. Di panel atas, klik Izin.

4. Di panel Permissions, temukan akun utama yang perannya ingin Anda cabut.

5. Klik ikon Hapus di samping peran yang ingin Anda hapus.

6. Klik Simpan.

REST

Untuk mencabut akses ke domain data menggunakan REST API, ambil kebijakan yang ada menggunakan metode projects.locations.dataDomains.getIamPolicy, hapus peran atau akun utama dari daftar bindings, dan tetapkan kebijakan yang diperbarui menggunakan metode projects.locations.dataDomains.setIamPolicy:

1. Dapatkan kebijakan IAM saat ini:

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • PROJECT_ID: ID project Google Cloud Anda.
   • LOCATION_ID: region tempat domain data berada. Contoh, us-central1.
   • DOMAIN_ID: ID unik domain data.

   Metode HTTP dan URL:

   POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:getIamPolicy

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d "" \
        "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:getIamPolicy"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:getIamPolicy" | Select-Object -Expand Content

   Anda akan menerima kode status berhasil (2xx) dan respons kosong.

2. Tetapkan kebijakan yang telah diperbarui:

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • PROJECT_ID: ID project Google Cloud Anda.
   • LOCATION_ID: region tempat domain data berada. Contoh, us-central1.
   • DOMAIN_ID: ID unik domain data.
   • ROLE: peran yang ingin Anda berikan kepada pengguna domain.

   Metode HTTP dan URL:

   POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:setIamPolicy

   Meminta isi JSON:

   {
     "policy": {
       "bindings": [
         {
           "role": "ROLE",
           "members": [
             "user:[e-mail]",
             "group:[e-mail]"
           ]
         }
       ]
     }
   }
   

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:setIamPolicy"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID:setIamPolicy" | Select-Object -Expand Content

   Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Catatan: Jika akses akun utama diwarisi dari kebijakan IAM tingkat lebih tinggi, Anda tidak dapat menghapus atau mengeditnya di tingkat domain.

Langkah berikutnya

• Pelajari domain data lebih lanjut.
• Pelajari lebih lanjut pengikatan dan penyertaan resource.
• Pelajari cara mengelola domain data.
• Pelajari cara menggunakan domain data.