Mengekspor glosarium bisnis ke Spreadsheet Google

Dengan utilitas ekspor glosarium bisnis, Anda dapat mengekstrak glosarium, kategori, dan istilah dari Knowledge Catalog (sebelumnya Dataplex Universal Catalog) ke Spreadsheet Google. Kemudian, Anda dapat mengelola metadata secara massal dan membuat laporan.

Sebelum memulai

Sebelum mengekspor glosarium, selesaikan prasyarat berikut.

Menyiapkan akun layanan

Untuk menjalankan utilitas ekspor, Anda harus menyiapkan akun layanan dengan izin yang diperlukan untuk mengakses Google Sheets API dan meniru kredensial pengguna Anda:

  1. Identifikasi atau buat akun layanan.

    Pilih akun layanan yang ada atau buat akun layanan baru di project tempat Anda menjalankan utilitas impor. Untuk mengetahui informasi selengkapnya, lihat Membuat akun layanan. Catat email akun layanan (misalnya, SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com).

  2. Mengonfigurasi peniruan akun layanan.

    Untuk menjalankan skrip utilitas ekspor secara lokal, akun pengguna Anda harus memiliki izin untuk meniru identitas akun layanan. Berikan peran Service Account Token Creator (roles/iam.serviceAccountTokenCreator) kepada akun pengguna Anda di akun layanan.

    Untuk mengetahui informasi selengkapnya, lihat Mengelola akses ke akun layanan.

  3. Beri akun layanan Editor akses ke Spreadsheet Google.

    Buka Spreadsheet Google yang ingin Anda gunakan untuk proses impor, klik Bagikan, dan tambahkan email akun layanan sebagai Editor. Izin ini memungkinkan akun layanan membaca dari atau menulis data ke sheet Anda.

Peran yang diperlukan

Untuk memastikan bahwa akun layanan memiliki izin yang diperlukan untuk mengekspor glosarium ke Spreadsheet Google, minta administrator untuk memberikan peran IAM berikut ke akun layanan:

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

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan kepada akun layanan melalui peran khusus atau peran bawaan lainnya.

Mengaktifkan API

Untuk mengekspor glosarium, aktifkan API berikut di project Anda:

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.

Aktifkan API

Menyiapkan repositori git

Membuat cloning dataplex-labs repositori:

git clone https://github.com/GoogleCloudPlatform/dataplex-labs.git
cd dataplex-labs/dataplex-quickstart-labs/00-resources/scripts/python/business-glossary-import/dataplex-glossary/export

Menginstal dependensi

Instal dependensi Python yang diperlukan:

pip3 install -r requirements.txt

Jika Anda mengalami masalah dengan penginstalan paket, siapkan lingkungan pengembangan Python baru.

Mengautentikasi dan mengonfigurasi peniruan akun layanan

Lakukan inisialisasi Google Cloud CLI dan autentikasi menggunakan Kredensial Default Aplikasi (ADC) dengan peniruan akun layanan:

# Set your service account email address
SA_EMAIL="SERVICE_ACCOUNT_EMAIL"

# Authenticate ADC using service account impersonation and required scopes
gcloud auth application-default login \
  --impersonate-service-account="${SA_EMAIL}" \
  --scopes="https://www.googleapis.com/auth/spreadsheets"

Ganti SERVICE_ACCOUNT_EMAIL dengan ID email akun layanan. Contoh:

SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

Menyiapkan Spreadsheet Google target untuk ekspor

Buat Spreadsheet Google kosong atau gunakan spreadsheet yang sudah ada. Skrip ekspor akan menulis ke sheet pertama. Pastikan Anda telah memberi akun layanan Editor akses ke Spreadsheet Google.

Mengekspor glosarium ke Spreadsheet Google

Jalankan skrip glossary-export.py. Utilitas akan meminta Anda memasukkan Spreadsheet Google target dan nama glosarium tertentu yang ingin Anda ekspor, selama eksekusi:

python3 glossary-export.py

Anda dapat meninjau log eksekusi di direktori logs/ di jalur eksekusi lokal Anda. Log ini membantu Anda mengaudit proses transfer dan mengidentifikasi entri yang dilewati atau peringatan pemformatan.

Memverifikasi data glosarium yang diekspor

Skrip ekspor mengambil metadata dari glosarium bisnis Knowledge Catalog Anda dan mengisi Spreadsheet Google dengan skema terstruktur, termasuk deskripsi, data steward, dan label. Verifikasi data yang diekspor di kolom berikut:

Kolom Deskripsi
id ID unik untuk istilah atau kategori dalam glosarium.
parent ID kategori induk.
display_name Nama tampilan istilah atau kategori.
description Deskripsi singkat istilah atau kategori.
overview Deskripsi rich text untuk istilah atau kategori (mendukung tag HTML).
type Jenis baris: TERM atau CATEGORY.
contact1_email Alamat email data steward utama untuk istilah atau kategori.
contact1_name Nama data steward utama untuk istilah atau kategori.
contact2_email Alamat email petugas data sekunder untuk istilah atau kategori.
contact2_name Nama data steward sekunder untuk istilah atau kategori.
label1_key Kunci untuk label pertama yang ditetapkan.
label1_value Nilai untuk label pertama yang ditetapkan.
label2_key Kunci untuk label kedua yang ditetapkan.
label2_value Nilai untuk label kedua yang ditetapkan.

Langkah berikutnya