Versi 2.0: Panduan pemecahan masalah BigQuery Connector untuk SAP

Anda dapat memecahkan masalah terkait BigQuery Connector for SAP versi 2.0 dan 2.1 dengan menggunakan logging aplikasi Server Replikasi SAP LT dan log Google Cloud untuk meninjau pesan log dan error singkat ini.

BigQuery Connector untuk SAP mengirimkan semua error ke log aplikasi Server Replikasi SAP LT standar.

Anda juga dapat menggunakan proses debug Server Replikasi SAP LT untuk mengisolasi masalah.

Ringkasan pemecahan masalah

Saat memecahkan masalah dengan BigQuery Connector for SAP, ada beberapa area berbeda yang mungkin perlu Anda fokuskan, bergantung pada area atau cakupan masalah yang sedang Anda selidiki:

Infrastruktur, seperti jaringan, hardware, atau sistem operasi.
Software SAP, termasuk server sumber dan Server Replikasi SAP LT.
BigQuery Connector untuk SAP.
BigQuery, termasuk BigQuery API dan tabel target.

Melibatkan tim yang tepat

Hal pertama yang perlu Anda lakukan saat memecahkan masalah adalah menentukan di area mana masalah sebelumnya terjadi dan apa cakupan masalahnya.

Untuk menyelesaikan masalah, Anda mungkin perlu bekerja sama dengan beberapa tim, seperti administrator Basis, administrator Server Replikasi SAP LT, DBA, atau administrator keamanan Google Cloud Anda.

Melibatkan tim dan keterampilan yang tepat dengan lebih awal dapat membantu Anda menyelesaikan masalah lebih cepat.

Menentukan akar masalah

Anda harus menentukan akar masalah dan memastikan bahwa apa yang menurut Anda mungkin menjadi penyebabnya, bukan sekadar gejala dari akar masalah yang ada di tempat lain.

Sistem SAP terintegrasi dengan erat, tetapi dapat menulis log dan rekaman aktivitas ke file di beberapa lokasi yang berbeda. Saat memecahkan masalah, Anda perlu menentukan log dan file trace yang benar untuk dilihat.

Memeriksa persyaratan dan prasyarat software

Pastikan semua software sistem berjalan pada versi minimum yang diperlukan dan semua prasyarat BigQuery Connector untuk SAP telah terpenuhi.

Untuk mengetahui informasi tentang prasyarat penginstalan BigQuery Connector untuk SAP, lihat:

Jika Server Replikasi SAP LT berjalan di VM Compute Engine, lihat Prasyarat.
Jika Server Replikasi SAP LT berjalan di host yang berada di luar Google Cloud, lihat Prasyarat.

Untuk persyaratan BigQuery Connector untuk SAP lihat Persyaratan software.

Jika Anda menggunakan software ECC lama, pastikan versi Server Replikasi SAP LT Anda kompatibel dengan versi ECC. Untuk informasi selengkapnya, lihat SAP Note 2577774 - Kompatibilitas versi untuk sistem sumber dan target - SLT.

Membaca dokumentasi dukungan SAP

Jika Anda memiliki akun pengguna SAP, Anda dapat menemukan solusi untuk banyak masalah software SAP dengan membaca SAP Notes dan SAP Knowledge Base Articles yang tersedia di SAP ONE Support Launchpad.

Logging

BigQuery Connector untuk SAP mengirimkan pesan log-nya ke Server Replikasi SAP LT, yang dapat Anda lihat di log aplikasi Server Replikasi SAP LT.

Pesan ini mencakup pesan yang diterima BigQuery Connector untuk SAP dari BigQuery API.

Pesan log BigQuery umum dapat dilihat di Konsol Google Cloud.

Log aplikasi Server Replikasi SAP LT

Semua pesan error disimpan ke log aplikasi Server Replikasi SAP LT standar. Periksa log aplikasi untuk menganalisis dan memecahkan penyebab utama masalah.

Anda dapat menampilkan log aplikasi yang khusus untuk konfigurasi Server Replikasi SAP LT dengan menjalankan LTRC transaksi, membuka konfigurasi, dan memilih Log Aplikasi.

Saat log ditampilkan, pilih baris tabel, lalu Anda dapat mengeklik tombol untuk menampilkan pesan error. Jika mengeklik tab Application Logs untuk replikasi, Anda dapat memfilter pesan log runtime yang relevan untuk replikasi tersebut.

Pesan yang dibuat oleh BigQuery Connector untuk SAP

Setiap error yang terjadi dalam BigQuery Connector untuk SAP sebelum data dikirim ke BigQuery diawali dengan /GOOG/SLT.

Setiap error yang ditampilkan dari BigQuery API diawali dengan /GOOG/MSG. Hal ini mencakup error HTTP apa pun.

Jika error tidak diawali dengan salah satu nilai ini, berarti error tersebut akan diterbitkan oleh Server Replikasi SAP LT.

Log BigQuery

BigQuery menulis berbagai entri log ke Cloud Logging di Konsol Google Cloud.

Untuk melihat entri log BigQuery:

Di Konsol Google Cloud, buka Logging:

Buka Logs Explorer
Di editor Query, tentukan resource BigQuery. Contoh:
```
resource.type="bigquery_dataset"
```

Untuk mengetahui informasi selengkapnya tentang log BigQuery, lihat Log.

Pelacakan HTTP

Saat memecahkan masalah error, Anda dapat mengaktifkan pelacakan HTTP dalam transaksi SMICM atau ST05.

Untuk membatasi dampak pada performa, nonaktifkan pelacakan HTTP segera setelah Anda selesai.

Proses Debug

Jika memiliki otorisasi yang diperlukan, Anda dapat men-debug kode Add-In Bisnis (BAdI) BigQuery Connector untuk SAP.

Untuk men-debug kode BAdI:

Jika Anda belum memiliki otorisasi SAP yang diperlukan untuk melakukan proses debug kode BAdI, minta otorisasi tersebut dari administrator SAP.
Aktifkan proses debug dengan mengetik /h di kolom entri transaksi pada SAP GUI, lalu menekan Enter.
Di menu Settings, pilih Change Debugger Profile/ Settings.
Pada Debug Modes, pastikan System Debugging dipilih.
Tetapkan titik henti sementara eksternal dalam kode sesuai kebutuhan.

Monitoring

Anda dapat memantau beberapa titik yang berbeda di sepanjang jalur data dari sumber data SAP ke tabel BigQuery target, termasuk:

Infrastruktur - jaringan, hardware, dan sistem operasi
Lapisan database SAP
Lapisan aplikasi SAP
BigQuery Connector untuk SAP
BigQuery

Untuk informasi lebih lanjut tentang pemantauan di setiap titik tersebut, baca panduan BigQuery Connector untuk SAP.

Rekonsiliasi data

Ada tiga titik yang dapat Anda gunakan untuk memeriksa jumlah catatan:

Tabel sumber
Statistik pemuatan atau replikasi Server Replikasi SAP LT dalam transaksi LTRC
Tabel target BigQuery

Anda dapat menggunakan alat Validasi Replikasi untuk memeriksa dan membandingkan jumlah data atau Anda dapat mengambil sendiri data dengan menjalankan kueri SQL.

Untuk mengetahui informasi selengkapnya tentang rekonsiliasi data, baca panduan BigQuery Connector untuk SAP.

Masalah konfigurasi umum

Bagian ini berisi penyelesaian masalah umum yang dapat terjadi selama penyiapan awal dan konfigurasi BigQuery Connector untuk SAP.

Dukungan Server Replikasi SAP LT untuk jenis data database

Bergantung pada versi software SAP Anda, Server Replikasi SAP LT mungkin tidak mendukung beberapa jenis data dalam database sumber. Untuk informasi selengkapnya, lihat bagian Pertimbangan Penting dari SAP Note 1605140 - Server Replikasi Transformasi Lanskap (SLT) SAP.

Masalah: Perintah OS untuk token akses tidak berfungsi di Server Replikasi SAP LT

Masalah: Anda membuat perintah sistem operasi (OS) untuk mencetak token akses, tetapi perintah tersebut tidak berfungsi di Server Replikasi SAP LT.

Penyebab: Masalah ini dapat disebabkan oleh beberapa masalah, tetapi kemungkinan besar disebabkan oleh tidak adanya variabel lingkungan yang diperlukan untuk perintah OS yang dikonfigurasi dengan benar.

Resolusi: Pastikan Perintah OS telah dikonfigurasi dengan benar. Untuk mengetahui langkah-langkah konfigurasi, lihat Membuat perintah OS untuk mencetak token akses.

Coba jalankan perintah printenv dari OS sebagai sidadm dan dari transaksi SAP SM69, lalu bandingkan hasilnya.

Jika variabel yang ditampilkan dalam transaksi SM69 tidak lengkap, coba mulai ulang Server Replikasi SAP LT untuk mendaftarkan variabel.

Masalah: `/GOOG/MSG: 413 - Request Entity Too Large`

Masalah: Transfer data gagal dengan pesan error /GOOG/MSG: 413 - Request Entity Too Large.

Penyebab: Masalah ini dapat terjadi jika ukuran byte dari potongan yang dikirim oleh BigQuery Connector untuk SAP melebihi ukuran byte maksimum untuk permintaan HTTP yang diterima BigQuery. Hal ini dapat terjadi jika ukuran data tabel atau jumlah data dalam data menyebabkan ukuran byte suatu potongan melebihi batas BigQuery.

Penyelesaian: Kurangi ukuran potongan yang dikirim oleh BigQuery Connector for SAP untuk tabel Anda. Anda dapat menyesuaikan ukuran potongan dengan menjalankan transaksi /GOOG/SLT_SETTINGS.

Untuk mengetahui informasi tentang ukuran potongan, lihat Ukuran potongan di BigQuery Connector untuk SAP.

Masalah: `/GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending`

Masalah: Transfer data gagal dengan pesan error /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending.

Penyebab: Masalah ini dapat disebabkan oleh masalah koneksi atau jaringan.

Penyelesaian: Validasi koneksi Anda dan pastikan jaringan disiapkan dengan benar, berjalan tanpa error, dan tidak dalam keadaan padat.

Masalah: `/GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving`

Masalah: Transfer data gagal dengan pesan error /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving.

Masalah ini dapat disebabkan oleh keadaan berikut:

Handshake SSL gagal
Ukuran byte dari potongan melebihi ukuran byte maksimum untuk permintaan HTTP yang diterima BigQuery

Handshake SSL gagal

Penyebab: Saat handshake SSL gagal antara host Server Replikasi SAP LT dan endpoint BigQuery API. Hal ini terjadi saat sertifikat yang ditampilkan oleh server TLS tidak valid untuk nama host target yang disediakan oleh Server Replikasi SAP LT, mungkin karena pengiriman sisi klien ekstensi TLS opsional tidak valid yang diimplementasikan pada kernel NetWeaver.

Penyelesaian: Di transaksi SMICM, cari kode pengembalian, SSLERR_SERVER_CERT_MISMATCH. Jika menemukan kode pengembalian SSLERR_SERVER_CERT_MISMATCH, Anda harus mengaktifkan pengiriman ekstensi TLS SNI. Selain itu, pastikan kernel NetWeaver Anda menerapkan pengiriman sisi klien untuk ekstensi TLS opsional SNI.

Untuk mengaktifkan pengiriman ekstensi TLS SNI, tetapkan parameter profil icm/HTTPS/client_sni_enabled atau ssl/client_sni_enabled ke TRUE, tergantung versi kernel NetWeaver Anda. Untuk mengetahui informasi selengkapnya dari SAP, lihat:

Ukuran byte dari potongan melampaui ukuran byte maksimum untuk permintaan HTTP yang diterima BigQuery

Penyebab: Saat ukuran byte dari potongan yang dikirim oleh BigQuery Connector untuk SAP melebihi ukuran byte maksimum untuk permintaan HTTP yang diterima BigQuery. Hal ini dapat terjadi saat ukuran kumpulan data tabel atau jumlah data dalam kumpulan data menyebabkan ukuran byte suatu potongan meningkat melebihi batas BigQuery.

Penyelesaian: Kurangi ukuran potongan yang dikirim oleh BigQuery Connector untuk SAP untuk tabel ini. Anda dapat menyesuaikan ukuran potongan dengan menjalankan transaksi /GOOG/SLT_SETTINGS. Untuk mengetahui informasi selengkapnya, lihat Ukuran potongan di BigQuery Connector untuk SAP.

Masalah: `/GOOG/MSG: 404 - Not found: Dataset DATASET_NAME`

Masalah: Saat mencoba memvalidasi keamanan Google Cloud atau memuat data ke dalam tabel BigQuery, Anda menerima pesan /GOOG/MSG: 404 - Not found: Dataset DATASET_NAME.

Penyebab: Masalah ini dapat disebabkan oleh keadaan berikut:

Set data BigQuery belum dibuat.
Nama set data tidak ditentukan dengan benar dalam konfigurasi transfer massal.
Konfigurasi replikasi di Server Replikasi SAP LT perlu diaktifkan.

Penyelesaian: Coba penyelesaian berikut:

Pastikan bahwa set data telah dibuat di BigQuery.
Pastikan nama set data dalam konfigurasi transfer massal sama dengan nama set data di BigQuery.
Jalankan transaksi LTRC serta nonaktifkan dan aktifkan kembali konfigurasi replikasi.

Masalah: `Mass Transfer Key can not be found for Mass Transfer ID XXX`

Masalah: Anda menerima error /GOOG/SLT: Mass Transfer Key can not be found for Mass Transfer ID XXX.

Penyebab: Masalah ini dapat disebabkan oleh keadaan berikut:

Konfigurasi transfer massa tidak ada untuk ID transfer massa yang ditentukan.
Konfigurasi replikasi yang terkait tidak aktif.

Penyelesaian: Untuk menyelesaikan masalah, lakukan salah satu tindakan berikut:

Jalankan transaksi /GOOG/SLT_SETTINGS dan konfirmasi bahwa ID transfer massa telah ditentukan dengan benar.
Jalankan transaksi LTRC serta nonaktifkan dan aktifkan kembali konfigurasi replikasi.

Masalah: `/GOOG/SLT : Unable to interpret VALUE as a BOOLEAN`

Masalah: Pemuatan atau replikasi data gagal dengan pesan /GOOG/SLT : Unable to interpret VALUE as a BOOLEAN.

Penyebab: Masalah ini disebabkan oleh pemetaan kolom di tabel sumber ke tipe data BigQuery BOOLEAN, tetapi data di kolom sumber tidak di-resolve menjadi sebuah boolean.

Penyelesaian: Untuk mengatasi masalah ini, gunakan transaksi /GOOG/SLT_Settings untuk mengubah tipe data yang dipetakan kolom sumber atau menghapus pemetaan jenis data dan setujui tipe data default-nya.

Masalah: `/GOOG/SLT: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS`

Masalah: Pemuatan atau replikasi data gagal dengan pesan /GOOG/SLT: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS.

Penyebab: Kolom sumber berisi nilai yang tidak valid atau kolom sumber dipetakan ke tipe data BigQuery yang bukan pemetaan yang valid untuk data yang dimuat kolom sumber.

Penyelesaian: Untuk mengatasi masalah ini, gunakan transaksi /GOOG/SLT_SETTINGS untuk mengubah tipe data yang dipetakan kolom sumber atau hapus pemetaan tipe data dan setujui pemetaan default untuk tipe data tersebut.

Masalah: `/GOOG/MSG : Client key is not found in /GOOG/CLIENT_KEY table`

Masalah: Pemuatan atau replikasi tidak dimulai dengan pesan /GOOG/MSG: Client key is not found in /GOOG/CLIENT_KEY table.

Penyebab: Kunci klien tidak ada atau salah ditentukan dalam konfigurasi transfer massal transaksi /GOOG/SLT_SETTINGS.

Penyelesaian: Untuk mengatasi masalah ini, gunakan SM30 transaksi untuk membuat kunci klien atau gunakan /GOOG/SLT_SETTINGS transaksi untuk memperbaiki spesifikasi nilai kunci klien dalam konfigurasi perpindahan massa.

Masalah operasional umum

Bagian ini berisi penyelesaian untuk masalah umum yang dapat terjadi setelah penyiapan awal BigQuery Connector untuk SAP.

Masalah: Jumlah penulisan salah di BigQuery

Masalah: Jumlah data yang ditulis ke BigQuery lebih tinggi dari jumlah data yang ditampilkan dalam log Server Replikasi SAP LT.

Penyebab: Error ini dapat disebabkan oleh lebih dari satu penyebab, termasuk masalah koneksi sementara yang menyebabkan Server Replikasi Server LT SAP mengirim kumpulan data lebih dari sekali atau bahwasanya tabel BigQuery hanya menerima penyisipan, dan setiap perubahan pada satu kumpulan data di sumber akan disisipkan sebagai entri terpisah dalam tabel target.

Penyelesaian: Jika perbedaan jumlah kumpulan data tidak ekstrem dan tidak ada lebih sedikit kumpulan data di BigQuery daripada dalam tabel sumber, ini adalah perilaku yang diharapkan dan bukan masalah.

Untuk merekonsiliasi jumlah data di BigQuery secara akurat dengan jumlah data dalam tabel sumber, buat kueri tabel BigQuery seperti yang dijelaskan dalam Kueri SQL untuk jumlah data.

Untuk mengetahui informasi selengkapnya tentang kemungkinan penyebab masalah ini, lihat Pertimbangan khusus untuk sumber/target ABAP di HANA.

Masalah: `/GOOG/MSG : 400 - Schema mismatch for table TABLE_NAME`

Masalah: Anda menerima pesan error /GOOG/MSG : 400 - Schema mismatch for table TABLE_NAME. Please delete the table from BigQuery and try again.

Penyebab: Salah satu perubahan berikut dimasukkan untuk tabel BigQuery yang sudah ada:

Penghapusan kolom
Mengganti nama kolom
Perubahan pada jenis data kolom
Perubahan jenis partisi tabel

Perubahan sebelumnya tidak dapat diterapkan ke tabel BigQuery yang sudah ada.

Penyelesaian: Jika perlu mengubah atribut kolom ini di tabel yang ada, Anda harus menghapus tabel yang ada dan memuat ulang data ke tabel baru.

Jika perubahannya keliru, kembalikan perubahan tersebut di Server Replikasi SAP LT.

Untuk mengetahui informasi lebih lanjut tentang cara mengonfigurasi kolom dan partisi dalam tabel BigQuery target, lihat Konfigurasi replikasi BigQuery.

Masalah: Pesan error yang terkait dengan data yang tidak valid

Masalah: Dalam log aplikasi, Anda menerima pesan error: /GOOG/MSG/: DESCRIPTION_OF_INVALID_DATA error occurred in FIELD_NAME in record RECORD_KEYS.

Penyebab: Pesan error ini dikeluarkan oleh BigQuery saat menyisipkan data dengan data yang tidak valid ke dalam tabel target. Data mungkin tidak valid karena salah satu alasan berikut:

Data di kolom kumpulan data tertentu tidak kompatibel dengan jenis data di BigQuery. Misalnya, BigQuery menghasilkan pesan error saat:
- String dipertahankan di kolom jenis DATE, INTEGER, atau BOOLEAN.
- Tanggal yang tidak valid (00/00/0000) dipertahankan di kolom jenis DATE.
Jenis data target yang salah dipertahankan di pemetaan kolom dalam transaksi /GOOG/SLT_SETTINGS.

Pesan error dikeluarkan oleh BigQuery untuk setiap kumpulan data yang berisi kolom dengan data yang tidak valid.

Penyelesaian: Analisis pesan error, DESCRIPTION_OF_INVALID_DATA, untuk memahami kemungkinan penyebab data tidak valid. Untuk mengidentifikasi data dengan kolom yang berisi data yang tidak valid, gunakan RECORD_KEYS, yang menyertakan konten dari lima kolom pertama data tersebut. Jika tabel terdiri dari lima kolom atau kurang, isi semua kolom akan disertakan dalam RECORD_KEYS.

Jika data di kolom ini tidak kompatibel dengan jenis data di BigQuery, perbaiki data dalam tabel sumber.
Jika terjadi error karena ketidakcocokan antara data dan jenis data, gunakan /GOOG/SLT_SETTINGS transaksi untuk menentukan jenis data yang sesuai. Untuk mengetahui informasi selengkapnya tentang pemetaan jenis data, lihat Pemetaan jenis data.

Mendapatkan dukungan

Jika Anda memerlukan bantuan untuk mengatasi masalah terkait replikasi dan BigQuery Connector untuk SAP, kumpulkan semua informasi diagnostik yang tersedia lalu hubungi Cloud Customer Care.

Untuk mengetahui informasi selengkapnya tentang cara menghubungi Cloud Customer Care, lihat Mendapatkan dukungan untuk SAP di Google Cloud.