Memecahkan masalah error impor glosarium bisnis dan link entri

Panduan ini membantu Anda memecahkan masalah Knowledge Catalog saat mengimpor dan mengekspor glosarium serta link entri, termasuk link entri yang tidak ada, error URL glosarium yang tidak valid, atau saat tugas impor gagal.

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

Memperbaiki link entri yang tidak ada di Knowledge Catalog

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:

  • 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 log terminal atau skrip untuk melihat 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.

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 atau URL resource 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 sama persis dengan nama resource di Knowledge Catalog. Perbaiki resource yang tidak ada atau kesalahan ketik, lalu jalankan skrip impor lagi.

Memecahkan masalah tugas impor Knowledge Catalog yang gagal

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.

Error SSL atau waktu tunggu skrip 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 firewall atau proxy perusahaan: Proxy keamanan atau firewall mengintersepsi dan memeriksa traffic HTTPS, yang membuat sertifikat SSL tidak valid.
  • Pembatasan VPN aktif: Konfigurasi VPN Anda membatasi traffic keluar ke endpoint Google Sheets atau API Google Cloud tertentu.
  • Ketidakstabilan jaringan lokal: Penurunan sementara konektivitas internet mengganggu sesi.

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

  • Pastikan koneksi jaringan Anda 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 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 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.

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 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 wilayah, 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. Jika tugas impor Anda gagal, periksa log untuk melihat 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 eksekusi tertentu.