Knowledge Catalog (sebelumnya Dataplex Universal Catalog) memungkinkan Anda mengimpor dan mengekspor glosarium bisnis dan link entri secara massal untuk mengelola kosakata bisnis dalam skala besar. Saat menjalankan skrip utilitas impor atau ekspor, Anda dapat mendiagnosis dan menyelesaikan masalah umum seperti link entri yang tidak ada, ekspor glosarium kosong, URL glosarium atau spreadsheet yang tidak valid, tugas impor yang terganggu, dan waktu tunggu jaringan skrip. Untuk mengetahui informasi selengkapnya, lihat Tentang mengimpor dan mengekspor glosarium dan link entri.
Jika Anda memerlukan bantuan untuk menyelesaikan masalah yang tidak dibahas dalam dokumen ini, lihat Cloud Customer Care.
Memperbaiki link entri yang tidak ada di Knowledge Catalog
Setelah mengekspor link entri dari Knowledge Catalog ke Spreadsheet Google dengan menjalankan utilitas link entri ekspor, Anda akan melihat bahwa beberapa link entri (pengaitan) tidak ada dalam Spreadsheet Google yang dihasilkan.
Masalah ini terjadi jika utilitas ekspor otomatis melewati link entri karena kondisi berikut:
Izin tidak memadai (resource yang disamarkan): Anda tidak memiliki izin IAM yang diperlukan untuk melihat entri sumber atau entri target yang terkait dengan link.
Jenis link entri tidak valid: Link entri menggunakan jenis hubungan yang tidak didukung atau tidak dikenali. Jenis yang valid dibatasi untuk
definition,related, dansynonym.Referensi entri tidak lengkap: Metadata entri tidak memiliki kolom skema yang diperlukan, sehingga pemeriksaan validasi melewati resource.
Untuk mengatasi masalah ini, lakukan pemeriksaan berikut:
Verifikasi izin: Pastikan Anda memiliki izin untuk melihat link entri yang tidak ada. Pastikan akun utama yang menjalankan skrip telah diberi peran yang diperlukan.
Periksa log eksekusi: Periksa terminal atau log skrip untuk menemukan peringatan yang berisi
Skipping redacted entrylink. Log akan menampilkan ID resource tertentu dari link entri yang dilewati dan alasan link tersebut dihilangkan.Periksa validitas skema link: Jika sebelumnya Anda mengubah link ini secara terprogram, pastikan propertinya sesuai dengan persyaratan skema.
No terms found in the glossary error
Saat Anda
mengekspor glosarium ke Spreadsheet Google,
eksekusi akan gagal atau menampilkan hasil kosong dengan pesan
No terms found in the glossary, meskipun glosarium bisnis berisi
istilah aktif.
Masalah ini terjadi jika skrip tidak dapat menemukan glosarium yang ditentukan atau tidak memiliki izin akses yang diperlukan untuk mengambil kontennya. Penyebab umumnya mencakup:
- URL glosarium salah: URL glosarium yang dikonfigurasi dalam parameter eksekusi Anda salah atau salah eja.
- Izin IAM tidak memadai: Akun layanan atau kredensial pengguna yang diautentikasi yang menjalankan skrip tidak memiliki izin untuk melihat atau mencantumkan istilah dalam glosarium target.
- ID glosarium tidak cocok: ID glosarium yang ditentukan dalam perintah skrip Anda tidak cocok dengan ID resource glosarium yang sebenarnya di Knowledge Catalog.
Untuk menyelesaikan masalah ini, verifikasi konfigurasi dan izin Anda:
Periksa ID glosarium: Di konsol Google Cloud , buka halaman Knowledge Catalog Glossaries, pilih glosarium Anda, dan pastikan ID resource cocok dengan ID yang Anda teruskan ke skrip utilitas.
Verifikasi izin IAM: Pastikan kredensial Anda yang diautentikasi (akun layanan atau akun pengguna yang ditiru identitasnya) telah diberi peran yang diperlukan.
Validasi struktur URL glosarium: Jika Anda meneruskan jalur resource atau URL langsung ke skrip, pastikan skrip tersebut mengikuti format resource Knowledge Catalog yang benar:
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID
Peringatan entri tidak ditemukan di Knowledge Catalog
Selama operasi impor link entri, skrip akan dijeda dan menampilkan peringatan yang mirip dengan berikut ini:
Found X entries not found in Knowledge Catalog. EntryLinks associated with
these entries will be skipped. Continue with import? [y/N]:
Masalah ini terjadi jika Spreadsheet Google Anda berisi link entri yang merujuk ke aset data atau istilah glosarium yang tidak ada di Knowledge Catalog.
Untuk mengatasi masalah ini, pilih salah satu opsi berikut:
Untuk melanjutkan impor parsial, ketik
ypada perintah. Utilitas ini mengimpor semua link entri yang valid dan hanya melewati link yang mereferensikan resource yang tidak ada.Untuk membatalkan dan memperbaiki resource yang tidak ada, ketik
nuntuk membatalkan eksekusi. Pastikan ID entri dalam dokumen sumber sama persis dengan nama resource di Knowledge Catalog Anda. Perbaiki resource yang tidak ada atau kesalahan ketik, lalu jalankan kembali skrip impor.
Memecahkan masalah kegagalan tugas impor Knowledge Catalog
Jika tugas impor terganggu atau gagal di tengah eksekusi, Anda tidak perlu memulai ulang seluruh proses atau mengubah Spreadsheet Google sumber.
Utilitas ini melacak batch yang berhasil diimpor menggunakan folder arsip di bucket staging Cloud Storage Anda.
Untuk melanjutkan tugas, ikuti langkah-langkah berikut:
Jalankan kembali utilitas impor. Utilitas mendeteksi status operasi Anda sebelumnya, dan menampilkan perintah berikut:
Found X existing file(s) in archive folder from a previous incomplete import Continue using existing files? [y/N]:Ketik
y. Utilitas akan melewati batch yang telah berhasil diimpor dan hanya memproses file yang tersisa.
Waktu tunggu skrip habis atau error SSL selama eksekusi
Saat menjalankan skrip utilitas impor atau ekspor, eksekusi berhenti, waktu habis, atau menampilkan error SSL di terminal Anda.
Masalah ini terjadi karena error tingkat jaringan berikut:
- Intersepsi proxy atau firewall perusahaan: Proxy atau firewall keamanan mengintersepsi dan memeriksa traffic HTTPS, yang membatalkan sertifikat SSL.
- Pembatasan VPN aktif: Konfigurasi VPN Anda membatasi traffic keluar ke endpoint API atau Google Spreadsheet tertentu. Google Cloud
- Ketidakstabilan jaringan lokal: Penurunan konektivitas internet sementara mengganggu sesi.
Untuk mengatasi masalah jaringan ini, coba langkah-langkah berikut:
Pastikan Anda memiliki koneksi jaringan yang stabil.
Memeriksa setelan proxy dan firewall
Periksa konfigurasi VPN Anda.
Mengandalkan percobaan ulang bawaan: Skrip utilitas memiliki logika percobaan ulang bawaan untuk gangguan jaringan sementara. Jika penurunan jaringan bersifat sementara, tunggu hingga skrip menyelesaikan upaya percobaan ulangnya sebelum memulai ulang eksekusi.
Error URL spreadsheet tidak valid
Saat Anda mencoba menjalankan utilitas impor atau ekspor, antarmuka command line
akan menampilkan error Invalid spreadsheet URL dan menghentikan eksekusi.
Masalah ini terjadi jika skrip tidak dapat mengurai link Spreadsheet Google yang diberikan atau tidak memiliki otorisasi untuk melihat file. Penyebab umumnya mencakup:
- URL salah format: URL tidak cocok dengan format jalur Google Spreadsheet standar.
- ID spreadsheet tidak ada: Jalur tidak memiliki ID alfanumerik unik yang mengarah ke sheet tertentu.
- Batasan akses: Akun layanan Anda yang diautentikasi tidak memiliki izin untuk melihat atau mengedit sheet, sehingga utilitas tidak dapat memvalidasi link.
Untuk mengatasi masalah ini, verifikasi link spreadsheet dan setelan akses Anda:
Validasi awalan URL: Pastikan URL spreadsheet yang Anda teruskan ke utilitas diawali dengan jalur Google Spreadsheet standar berikut:
https://docs.google.com/spreadsheets/Verifikasi ID spreadsheet: Pastikan URL menyertakan ID unik sheet Anda. URL yang valid harus mengikuti struktur ini:
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/editPeriksa izin akses: Buka Spreadsheet Google di browser, klik Bagikan, dan pastikan Anda telah menambahkan email akun layanan sebagai Editor.
Mengatasi error URL glosarium yang tidak valid
Saat Anda mencoba menjalankan utilitas impor atau ekspor untuk glosarium, antarmuka command line akan menampilkan error Invalid glossary URL dan menghentikan eksekusi. Pastikan tidak ada URL glosarium yang tidak valid dalam parameter Anda.
Masalah ini terjadi jika skrip tidak dapat mengurai jalur resource glosarium Knowledge Catalog yang disediakan atau tidak memiliki otorisasi untuk melihat resource. Penyebab umumnya mencakup:
- Jalur resource salah format: Jalur resource tidak sesuai dengan format jalur glosarium Knowledge Catalog standar.
- ID salah: Jalur berisi project ID, lokasi region, atau ID glosarium yang salah.
- Pembatasan akses atau resource tidak ada: Glosarium tidak ada, atau akun layanan yang diautentikasi tidak memiliki izin IAM yang diperlukan untuk mengaksesnya.
Untuk mengatasi masalah ini, verifikasi jalur resource glosarium dan kredensial Anda:
Validasi struktur jalur resource: Pastikan jalur glosarium yang Anda teruskan ke utilitas cocok dengan format Knowledge Catalog standar berikut:
projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_IDVerifikasi ID di jalur: Gunakan project ID, lokasi, dan ID glosarium yang benar.
Konfirmasi keberadaan dan akses resource: Pastikan glosarium ada dengan ID yang ditentukan dan akun layanan Anda yang diautentikasi telah diberi peran IAM yang diperlukan.
Melihat log eksekusi
Utilitas impor dan ekspor menghasilkan log eksekusi mendetail saat dijalankan. Jika tugas impor Anda gagal, periksa log untuk menemukan error tertentu. Log ini membantu Anda mengaudit proses transfer dan mengidentifikasi entri yang dilewati atau peringatan pemformatan.
- Lokasi log: Utilitas impor dan ekspor menulis file log ke direktori
logs/di jalur eksekusi lokal Anda. - Format log: Setiap file log ditambahkan dengan stempel waktu sehingga Anda dapat menemukan log untuk operasi tertentu.