Memecahkan Masalah BigQuery Toolkit untuk SAP

Dokumen ini menunjukkan cara memecahkan masalah terkait BigQuery Toolkit untuk SAP kepada administrator SAP, developer SAP, atau lainnya.

Masalah umum

Bagian ini mencantumkan pesan error umum dan penyelesaiannya yang khusus untuk BigQuery Toolkit untuk SAP.

Untuk mengetahui informasi tentang cara memecahkan masalah ABAP SDK untuk Google Cloud secara umum, lihat Memecahkan masalah ABAP SDK untuk Google Cloud edisi cloud atau lokal.

/GOOG/BQTR: Mass Transfer Key is required. Use Tcode /GOOG/BQTR_SETTINGS to maintain

Masalah: Transfer data gagal dengan pesan error /GOOG/BQTR: Mass Transfer Key is required. Use Tcode /GOOG/BQTR_SETTINGS to maintain.

Penyebab: Kunci transfer massal tidak disediakan dalam parameter IV_MASS_TR_KEY saat memanggil class pemuatan data /GOOG/CL_BQTR_DATA_LOAD.

Penyelesaian: Untuk mengatasi masalah ini, teruskan kunci transfer massal yang disimpan dalam transaksi /GOOG/BQTR_SETTINGS. Untuk mengetahui informasi selengkapnya, lihat Memanggil metode replikasi data.

/GOOG/BQTR: Data Source is required. Pass a dictionary object

Masalah: Transfer data gagal dengan pesan error /GOOG/BQTR: Data Source is required. Pass a dictionary object.

Penyebab: Sumber data tidak disediakan dalam parameter IV_DATA_SOURCE saat memanggil class pemuatan data /GOOG/CL_BQTR_DATA_LOAD.

Penyelesaian: Untuk mengatasi masalah ini, teruskan nama objek kamus seperti tampilan atau tabel CDS sebagai sumber data. Untuk informasi selengkapnya, lihat Memanggil metode replikasi data.

/GOOG/BQTR: Mass Transfer Key MASS_TRANSFER_KEY not found. Use Tcode /GOOG/BQTR_SETTINGS to maintain

Masalah: Transfer data gagal dengan pesan error /GOOG/BQTR: Mass Transfer Key MASS_TRANSFER_KEY not found. Use Tcode /GOOG/BQTR_SETTINGS to maintain.

Penyebab: Kunci transfer massal yang diteruskan ke class pemuatan data /GOOG/CL_BQTR_DATA_LOAD tidak dikelola di modul BigQuery Data Transfer.

Penyelesaian: Untuk mengatasi masalah ini, pertahankan kunci transfer massal menggunakan kode transaksi /GOOG/BQTR_SETTINGS. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi modul BigQuery Data Transfer.

/GOOG/BQTR: DATA_SOURCE does not exist in data dictionary

Masalah: Transfer data gagal dengan pesan error /GOOG/BQTR: DATA_SOURCE does not exist in data dictionary.

Penyebab: Sumber data yang diteruskan ke class pemuatan data /GOOG/CL_BQTR_DATA_LOAD bukan objek kamus data yang valid.

Penyelesaian: Untuk mengatasi masalah ini, teruskan nama sumber data yang ada di kamus data. Hanya tabel, tampilan kamus, dan tampilan CDS yang didukung.

/GOOG/BQTR: Nested Tables are not supported

Masalah: Anda menerima pesan error /GOOG/BQTR: Nested Tables are not supported.

Penyebab: Objek kamus yang diteruskan sebagai input ke class pemuatan data /GOOG/CL_BQTR_DATA_LOAD bukan struktur data datar.

Penyelesaian: Untuk mengatasi masalah ini, gunakan objek kamus yang memiliki struktur datar.

/GOOG/BQTR: Error creating target table definition

Masalah: Anda menerima pesan error /GOOG/BQTR: Error creating target table definition.

Penyebab: BigQuery Toolkit untuk SAP tidak dapat membuat definisi tabel target untuk sumber data tertentu.

Penyelesaian: Untuk mengatasi masalah ini, validasi bahwa sumber input adalah objek kamus yang valid dengan satu atau beberapa kolom.

/GOOG/BQTR: 400 - Table creation failed in BQ. Could not pull the table metadata from BQ

Masalah: Anda menerima pesan error /GOOG/BQTR: 400 - Table creation failed in BQ. Could not pull the table metadata from BQ.

Penyebab: Error ini muncul jika modul BigQuery Data Transfer tidak dapat mendapatkan definisi tabel dari BigQuery. Hal ini mungkin disebabkan oleh kelebihan beban server sementara di BigQuery.

Penyelesaian: Untuk mengatasi masalah ini, mulai ulang operasi pemuatan data BigQuery.

/GOOG/BQTR: 400 - Scope must be provided

Masalah: Anda menerima pesan error /GOOG/BQTR: 400 - Scope must be provided.

Penyebab: Dalam konfigurasi kunci klien, Google Cloud Scope kosong.

Penyelesaian: Untuk mengatasi masalah ini, untuk konfigurasi kunci klien yang Anda gunakan, di kolom Cakupan Google Cloud, tentukan cakupan yang sesuai — misalnya, https://www.googleapis.com/auth/cloud-platform.

/GOOG/BQTR: 400 - Schema mismatch for table TABLE_NAME

Masalah: Anda menerima pesan error /GOOG/BQTR: 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.

Pesan error yang terkait dengan data yang tidak valid

Masalah: Dalam log aplikasi, Anda menerima pesan error: /GOOG/BQTR/: 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/BQTR_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/BQTR_SETTINGS transaksi untuk menentukan jenis data yang sesuai.

/GOOG/BQTR: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset

Masalah: Transfer data gagal dengan pesan error /GOOG/BQTR: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset.

Penyebab: Untuk beban kerja SAP yang berjalan di Google Cloud, pada tabel /GOOG/CLIENT_KEY, akun layanan yang ditentukan tidak memiliki izin yang diperlukan untuk mengakses BigQuery API.

Penyelesaian: Untuk mengatasi masalah ini, selesaikan beberapa langkah berikut:

  1. Di SAP GUI, masukkan transaksi /GOOG/BQTR_SETTINGS yang didahului dengan /n:

    /n/GOOG/BQTR_SETTINGS

  2. Untuk ID transfer massal yang gagal dalam transaksi LTRC, perhatikan nilai kolom Google Cloud Key Name.

  3. Masukkan transaksi SM30, lalu buka tabel /GOOG/CLIENT_KEY.

  4. Untuk nilai Google Cloud Key Name yang Anda catat di langkah sebelumnya, catat nilai yang ditentukan untuk kolom Nama Akun Layanan.

  5. Di konsol Google Cloud, buka halaman Service accounts Identity and Access Management.

    Buka halaman Service accounts

  6. Pilih akun layanan yang Anda catat pada langkah sebelumnya.

  7. Pastikan akun layanan memiliki peran IAM yang diperlukan BigQuery Toolkit untuk SAP guna mengakses BigQuery, seperti yang dijelaskan dalam Menyiapkan autentikasi.

  8. Jalankan kembali replikasi Anda.

/GOOG/BQTR: 404 - Not Found

Masalah: Transfer data gagal dengan pesan error /GOOG/BQTR: 404 - Not Found.

Penyebab: Di tujuan RFC yang digunakan ABAP SDK untuk Google Cloud untuk terhubung ke API Google Cloud , awalan jalurnya salah.

Penyelesaian: Untuk mengatasi masalah ini, selesaikan beberapa langkah berikut:

  1. Di SAP GUI, masukkan transaksi /GOOG/BQTR_SETTINGS yang didahului dengan /n:

    /n/GOOG/BQTR_SETTINGS

  2. Untuk ID transfer massal yang gagal dalam transaksi LTRC, perhatikan nilai kolom Google Cloud Key Name.

  3. Masukkan transaksi SM30, lalu buka tabel /GOOG/SERVIC_MAP.

  4. Untuk nilai Google Cloud Key Name yang Anda catat di langkah sebelumnya, catat nama tujuan RFC.

  5. Masukkan transaksi SM59, lalu selesaikan langkah-langkah berikut:

    • Untuk tujuan RFC yang terhubung ke BigQuery, pastikan nilai kolom Awalan Jalur adalah /bigquery/v2/.
    • Untuk tujuan RFC yang terhubung ke IAM, pastikan nilai kolom Awalan Jalur adalah /v1/.

  6. Jalankan kembali replikasi Anda.

/GOOG/BQTR: 404 - Table PROJECT_ID:DATASET_NAME.TABLE_NAME not found

Masalah: Transfer data gagal dengan pesan error /GOOG/BQTR: 404 - Table PROJECT_ID:DATASET_NAME.TABLE_NAME not found.

Penyebab: Di tujuan RFC yang digunakan ABAP SDK untuk Google Cloud untuk terhubung ke API Google Cloud , nilai yang telah Anda tentukan untuk kolom Target Host tidak cocok dengan nama DNS apa pun di Cloud DNS.

Penyelesaian: Untuk mengatasi masalah ini, selesaikan beberapa langkah berikut:

  1. Di SAP GUI, masukkan kode transaksi /GOOG/BQTR_SETTINGS.

  2. Masukkan kunci transfer massal yang error ini Anda terima.

  3. Klik ikon Execute. Catat nilai di kolom Google Cloud Key Name.

  4. Masukkan SM30 transaksi, lalu buka tabel /GOOG/CLIENT_KEY dalam mode tampilan.

  5. Telusuri tabel /GOOG/SERVIC_MAP menggunakan Google Cloud Key Name yang Anda catat di langkah sebelumnya, lalu catat nama tujuan RFC yang ditentukan.

  6. Masukkan kode transaksi SM59.

  7. Untuk tujuan RFC yang Anda gunakan agar terhubung ke BigQuery dan API IAM, catat nilai yang ditentukan untuk kolom Target Host.

  8. Di konsol Google Cloud, buka halaman Cloud DNS Layanan jaringan.

    Membuka Cloud DNS

  9. Klik zona pribadi yang berisi data DNS untuk endpoint Private Service Connect yang Anda buat guna mengizinkan BigQuery Toolkit for SAP terhubung secara pribadi ke BigQuery dan IAM API.

  10. Pastikan ada data DNS, dengan DNS name yang cocok, untuk setiap nilai host target yang Anda catat pada langkah sebelumnya.

  11. Jalankan kembali replikasi Anda.

/GOOG/BQTR: 404 - Not Found Requested entity was not found

Masalah: Transfer data gagal dengan pesan error /GOOG/BQTR: 404 - Not Found Requested entity was not found.

Penyebab: Untuk beban kerja Anda yang berjalan di Google Cloud, akun layanan yang digunakan dalam tabel kunci klien /GOOG/CLIENT_KEY tidak valid.

Penyelesaian: Untuk mengatasi masalah ini, selesaikan beberapa langkah berikut:

  1. Di SAP GUI, masukkan transaksi /GOOG/BQTR_SETTINGS yang didahului dengan /n:

    /n/GOOG/BQTR_SETTINGS

  2. Masukkan kunci transfer massal yang error ini Anda terima.

  3. Klik ikon Execute. Catat nilai di kolom Google Cloud Key Name.

  4. Masukkan transaksi SM30, lalu buka tabel /GOOG/CLIENT_KEY.

  5. Untuk kolom Service Account Name, pastikan nilai yang ditentukan adalah alamat email akun layanan yang dibuat untuk BigQuery Toolkit for SAP.

  6. Jalankan kembali replikasi Anda.

/GOOG/BQTR: 413 - Request Entity Too Large

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

Penyebab: Masalah ini dapat terjadi jika ukuran byte dari potongan yang dikirim oleh BigQuery Toolkit 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 Toolkit untuk SAP untuk tabel Anda. Anda dapat menyesuaikan ukuran potongan dengan menjalankan /GOOG/BQTR_SETTINGS transaksi atau mengaktifkan ukuran potongan dinamis untuk menyesuaikan ukuran potongan secara otomatis. Untuk informasi selengkapnya, lihat:

/GOOG/BQTR: 404 - Not found: Dataset DATASET_NAME

Masalah: Saat mencoba memvalidasi keamanan Google Cloud atau memuat data ke dalam tabel BigQuery, Anda menerima pesan /GOOG/BQTR: 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 modul BigQuery Data Transfer harus 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.

/GOOG/BQTR : Unable to interpret VALUE as a BOOLEAN

Masalah: Pemuatan atau replikasi data gagal dengan pesan /GOOG/BQTR : 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/BQTR_SETTINGS untuk mengubah jenis data yang dipetakan kolom sumber atau hapus pemetaan jenis data dan setujui jenis data default-nya.

/GOOG/BQTR: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS

Masalah: Pemuatan atau replikasi data gagal dengan pesan /GOOG/BQTR: 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/BQTR_SETTINGS untuk mengubah tipe data yang dipetakan kolom sumber atau hapus pemetaan tipe data dan setujui pemetaan default untuk tipe data tersebut.

/GOOG/BQTR: DESCRIPTION_OF_ISSUE error occurred in chunk ranging START_INDEX_OF_FAILED_CHUNK - END_INDEX_OF_FAILED_CHUNK

Masalah: Replikasi potongan gagal dengan pesan error /GOOG/BQTR: DESCRIPTION_OF_ISSUE error occurred in chunk ranging START_INDEX_OF_FAILED_CHUNK - END_INDEX_OF_FAILED_CHUNK.

Penyebab: Hal ini dapat memiliki lebih dari satu penyebab, termasuk Invalid JSON Payload, Quota Exceeded, Request Entity Too Large, atau HTTP Communication Failure. Pesan error untuk potongan yang gagal direplikasi ke BigQuery ditampilkan dengan indeks awal dan akhir potongan tersebut.

Pesan error ini ditampilkan jika Anda belum menetapkan tanda BREAK dalam transaksi /GOOG/BQTR_SETTINGS. Jika tanda BREAK tidak ditetapkan, BigQuery Toolkit untuk SAP akan terus mengirimkan data ke BigQuery dengan mengirimkan potongan berikutnya bahkan saat terjadi error.

Resolusi: Coba resolusi berikut:

  • Untuk masalah Quota Exceeded, Request Entity Too Large, atau HTTP Communication Failure, ikuti langkah-langkah pemecahan masalah untuk /GOOG/BQTR: 413 - Request Entity Too Large.
  • Hentikan pemuatan saat ini, hapus tabel target dari BigQuery, lalu mulai ulang pemuatan baru.
  • Untuk berhenti mengirim data ke BigQuery dan menghentikan tugas replikasi saat ada potongan yang berisi error, tetapkan flag BREAK, yang direkomendasikan di lingkungan produksi.

Untuk informasi tentang cara mengonfigurasi flag BREAK, lihat Menentukan pembuatan tabel dan atribut umum lainnya.

Mendapatkan dukungan dari komunitas

Ajukan pertanyaan dan diskusikan BigQuery Toolkit untuk SAP dengan komunitas di Cloud Forum.

Mendapatkan dukungan

Google Cloud menawarkan dukungan untuk masalah dan pertanyaan terkait penginstalan, konfigurasi, pengoperasian, dan pemeliharaan BigQuery Toolkit untuk SAP. Namun, dukungan terbatas pada toolkit itu sendiri.

Google Cloud tidak mendukung komponen lingkungan lainnya seperti infrastruktur jaringan, database, sistem operasi, atau software pihak ketiga. Untuk masalah terkait komponen lingkungan selain BigQuery Toolkit for SAP, hubungi vendor atau penyedia dukungan yang sesuai.

Untuk fungsi yang disediakan oleh SAP, seperti Penyediaan Data Operasional (ODP) dan Transformasi Lanskap SAP (SLT), hubungi dukungan SAP untuk mendapatkan bantuan.

Jika Anda memerlukan bantuan untuk menyelesaikan masalah terkait BigQuery Toolkit untuk SAP, kumpulkan semua informasi diagnostik yang tersedia dan hubungi Cloud Customer Care.

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