Memecahkan masalah impor dan ekspor glosarium

Dokumen ini menjelaskan cara mengatasi masalah dan error umum yang mungkin Anda temui saat mengimpor dan mengekspor glosarium dan link entri di Knowledge Catalog (sebelumnya Dataplex Universal Catalog).

Jika Anda memerlukan bantuan untuk mengatasi masalah yang tidak dibahas di halaman ini, hubungi Dukungan Google Cloud.

Link entri tidak ada di Google Spreadsheet yang diekspor

Setelah Anda mengekspor link entri dari Knowledge Catalog ke Google Spreadsheet dengan menjalankan utilitas ekspor link entri, Anda akan melihat bahwa beberapa link entri (asosiasi) tidak ada di Google Spreadsheet 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 terbatas pada definition, related, dan synonym.

  • Referensi entri tidak lengkap: Metadata entri tidak memiliki kolom skema yang diperlukan, sehingga pemeriksaan validasi akan melewati resource.

Untuk mengatasi masalah ini, lakukan pemeriksaan berikut:

Error tidak ada istilah yang ditemukan dalam glosarium

Saat Anda mengekspor glosarium ke Google Spreadsheet, 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 ketik.
  • Izin IAM tidak memadai: Akun layanan yang diautentikasi atau kredensial pengguna 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 sebenarnya di Knowledge Catalog.

Untuk mengatasi masalah ini, verifikasi konfigurasi dan izin Anda:

  • Periksa ID glosarium: Di Google Cloud konsol, buka halaman Glosarium Knowledge Catalog, pilih glosarium Anda, dan pastikan ID resource cocok dengan ID yang Anda teruskan ke skrip utilitas.

  • Verifikasi izin IAM: Pastikan kredensial yang diautentikasi (akun layanan atau akun pengguna yang Anda tiru) telah diberi peran yang diperlukan.

  • Validasi struktur URL glosarium: Jika Anda meneruskan jalur resource atau URL langsung ke skrip, pastikan jalur atau URL 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 Google Spreadsheet Anda berisi link entri yang mereferensikan aset data atau istilah glosarium yang tidak ada di Knowledge Catalog.

Untuk mengatasi masalah ini, pilih salah satu opsi berikut:

  • Untuk melanjutkan impor sebagian, ketik y pada perintah. Utilitas akan 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 n untuk membatalkan eksekusi. Pastikan ID entri dalam dokumen sumber Anda cocok persis dengan nama resource di Knowledge Catalog. Perbaiki resource yang tidak ada atau error ketik, lalu jalankan skrip impor lagi.

Tugas impor gagal atau terganggu di tengah jalan

Jika tugas impor terganggu atau gagal di tengah eksekusi, Anda tidak perlu memulai ulang seluruh proses atau mengubah Google Spreadsheet sumber.

Utilitas melacak batch yang berhasil diimpor menggunakan folder arsip di bucket Cloud Storage staging Anda.

Untuk melanjutkan tugas, ikuti langkah-langkah berikut:

  1. Jalankan kembali utilitas impor. Utilitas akan mendeteksi status eksekusi sebelumnya dan menampilkan perintah berikut:

    Found X existing file(s) in archive folder from a previous incomplete import
Continue using existing files? [y/N]:

  2. Ketik y. Utilitas akan melewati batch yang sudah 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 akan berhenti, waktu tunggu 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 mencegat dan memeriksa traffic HTTPS, yang membuat sertifikat SSL tidak valid.
  • Pembatasan VPN aktif: Konfigurasi VPN Anda membatasi traffic keluar ke endpoint API atau Google Spreadsheet Google Cloud tertentu.
  • Ketidakstabilan jaringan lokal: Penurunan sementara konektivitas internet mengganggu sesi.

Untuk mengatasi masalah jaringan ini, coba langkah-langkah berikut:

  • Pastikan Anda memiliki koneksi jaringan yang stabil.

  • Periksa setelan proxy dan firewall

  • Periksa konfigurasi VPN Anda.

  • Andalkan percobaan ulang bawaan: Skrip utilitas memiliki logika percobaan ulang bawaan untuk gangguan jaringan sementara. Jika penurunan jaringan bersifat sementara, tunggu 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 Google Spreadsheet 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 spreadsheet tertentu.
  • Pembatasan akses: Akun layanan yang diautentikasi tidak memiliki izin untuk melihat atau mengedit spreadsheet, 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 dimulai dengan jalur Google Spreadsheet standar berikut: https://docs.google.com/spreadsheets/

  • Verifikasi ID spreadsheet: Pastikan URL menyertakan ID unik spreadsheet Anda. URL yang valid harus mengikuti struktur ini: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

  • Periksa izin akses: Buka Google Spreadsheet di browser, klik Bagikan, dan pastikan Anda telah menambahkan email akun layanan sebagai Editor.

Error URL glosarium tidak valid

Saat Anda mencoba menjalankan utilitas impor atau ekspor untuk glosarium, antarmuka command line akan menampilkan error Invalid glossary URL dan menghentikan eksekusi.

Masalah ini terjadi jika skrip tidak dapat mengurai jalur resource glosarium Knowledge Catalog yang diberikan atau tidak memiliki otorisasi untuk melihat resource. Penyebab umumnya mencakup:

  • Jalur resource salah format: Jalur resource tidak cocok 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_ID

  • Verifikasi ID dalam 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 yang diautentikasi telah diberi peran IAM yang diperlukan.

Melihat log eksekusi

Utilitas impor dan ekspor menghasilkan log eksekusi mendetail saat dijalankan. 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 eksekusi tertentu.