membuat dan memodifikasi sumber data berkas - Quick BI

Quick BI memungkinkan Anda mengunggah file Excel dan CSV lokal ke database. File ini dapat digunakan sebagai sumber data untuk analisis bisnis. Topik ini menjelaskan cara mengunggah file serta membuat dan memodifikasi sumber data berkas.

Skenario

Anda dapat membuat sumber data dari file lokal dan menganalisisnya bersama dengan sumber data online.

Batasan

Jenis file	Batasan
Excel	Secara default, sistem mengidentifikasi baris pertama dari file yang diunggah sebagai baris header dan mulai membaca data dari baris kedua. Anda juga dapat menyesuaikan baris header pada halaman Pratinjau Data sesuai kebutuhan. Baris header tidak boleh berisi sel kosong. Anda dapat menetapkan jumlah baris header pada halaman Pratinjau Data atau memodifikasi file dan mengunggahnya kembali. Anda dapat mengurai dan mengunggah maksimal lima lembar kerja. Untuk mengunggah lebih dari lima lembar kerja, pisahkan konten menjadi beberapa file Excel. Satu lembar kerja tidak boleh berisi lebih dari 100 kolom atau sel yang digabungkan. Ukuran file yang direkomendasikan adalah tidak lebih dari 50 MB. Sebagai contoh, jika sebuah file memiliki 98 kolom dan 1 juta baris dengan ukuran 80 MB, Anda harus membaginya menjadi beberapa file dan mengunggahnya dengan menambahkan baris. Hindari karakter khusus dalam nama file untuk memastikan kompatibilitas dan kemudahan pembacaan. Hindari konten yang dihitung oleh fungsi Excel dalam file Excel yang diunggah, seperti VLOOKUP dan SUMIFS. Sebuah ruang kerja dapat berisi maksimal 100 sumber data.
CSV	Sebuah file dapat berisi maksimal 100 kolom. Ukuran file yang direkomendasikan adalah tidak lebih dari 50 MB. Sebagai contoh, jika sebuah file memiliki 98 kolom dan 1 juta baris dengan ukuran 80 MB, Anda harus membaginya menjadi beberapa file dan mengunggahnya dengan menambahkan baris.

Catatan

Perhatikan hal-hal berikut saat mengunggah file:

Tipe bidang yang didukung adalah teks, numerik, dan tanggal. Saat mengonfigurasi bidang, Anda dapat memilih tipe-tipe ini atau membiarkan sistem mengenalinya secara otomatis berdasarkan isi data. Anda juga dapat memodifikasi tipe bidang.
Saat mengunggah file CSV, ubah file tersebut ke format UTF-8.
Quick BI secara akurat mengidentifikasi pengkodean file CSV dalam format UTF-8. Namun, pengkodean file CSV dalam format GBK dan GB2312 mungkin tidak teridentifikasi secara otomatis, yang dapat mengakibatkan teks berantakan.
Gunakan Google Chrome untuk mengunggah file.
Dalam file yang diunggah, tipe data kolom ditentukan oleh nilai-nilai dalam 100 baris pertama:
- Jika 100 baris pertama hanya berisi angka, sistem mengidentifikasi kolom sebagai numerik.
- Jika salah satu dari 100 baris pertama berisi string, sistem mengidentifikasi kolom sebagai string.
Bidang numerik tidak kompatibel dengan data string. Bidang string kompatibel dengan data numerik.

Persiapan

Konfirmasi tipe file yang didukung
- Tipe file yang didukung adalah CSV dan Excel. Format Excel yang didukung adalah .xls dan .xlsx.
- Untuk informasi lebih lanjut, lihat Catatan.
Konfirmasi bahwa format file dan ukurannya memenuhi persyaratan di Batasan.

Titik Masuk

Masuk ke Konsol Quick BI dan gunakan salah satu metode berikut untuk mengunggah file lokal.

Unggah file lokal dari halaman Sumber Data
Anda harus memiliki izin baca dan tulis untuk sumber data target. Sumber data tersebut juga harus mendukung pengunggahan file. Untuk informasi lebih lanjut tentang sumber data mana yang mendukung pengunggahan file, lihat Daftar Fungsi Item Sumber Data.
Unggah file lokal dari halaman pengeditan set data

Unggah File

Di halaman Unggah File, Anda dapat mengunggah dan mengonfigurasi file lokal untuk digunakan sebagai sumber data. Tipe file yang didukung termasuk Excel dan CSV. Topik ini menggunakan file Excel Contoh data penjualan .xlsx sebagai contoh.

Catatan

Saat mengunggah file Excel, Anda dapat mengunggah maksimal lima lembar kerja. Untuk mengunggah lebih dari lima lembar kerja, pisahkan konten menjadi beberapa file Excel.
Saat mengunggah file CSV, disarankan untuk menggunakan format UTF-8.

Di halaman Unggah File, klik atau seret file ke area unggah. Setelah pengunggahan selesai, halaman Pratinjau Data muncul.

Di halaman Pratinjau Data, Anda dapat melihat pratinjau informasi berikut dan melakukan penyesuaian.

Konten yang Ditampilkan	Konfigurasi	Operasi
Area ① Lembar kerja dan judul dalam file yang diunggah	Beralih lembar kerja	Klik tab untuk beralih lembar kerja dan melihat pratinjau data. Data di Area ④ berubah saat Anda beralih tab.
	Ganti nama lembar kerja	Klik dua kali nama lembar kerja untuk mengganti namanya sesuai kebutuhan bisnis Anda. Secara default, Quick BI menggunakan nama lembar kerja dari file lokal. Catatan Nama lembar kerja tidak boleh berisi karakter khusus atau spasi di awal atau akhir.
	Ubah status pemilihan lembar kerja	Klik ikon di sebelah nama lembar kerja untuk mengubah status pemilihannya. Secara default, semua lembar kerja dipilih. Jika Anda menghapus centang untuk lembar kerja, lembar kerja tersebut tidak akan diunggah. Catatan Anda harus memilih setidaknya satu lembar kerja untuk mengunggah file.
	Pintasan lembar kerja	Klik ikon di sebelah kanan bilah tab dan pilih pintasan dari daftar drop-down. Pilih hanya lembar kerja saat ini: Hanya lembar kerja saat ini yang dipilih. Setelah file diunggah, file tersebut hanya berisi data dari lembar kerja saat ini. Pilih semua lembar kerja: Semua lembar kerja di bilah tab dipilih. Setelah file diunggah, file tersebut berisi data dari semua lembar kerja. Kecualikan lembar kerja saat ini: Lembar kerja saat ini tidak dipilih. Setelah file diunggah, file tersebut tidak berisi data dari lembar kerja saat ini.
Area ② Nama file	Nama Tampilan	Nama tampilan file yang diunggah di Quick BI. Saat Anda mengunggah file, sistem secara otomatis menggunakan nama file sebagai nama tampilan. Anda dapat mengubah nama sesuai kebutuhan. Catatan Nama tampilan tidak boleh berisi karakter khusus atau spasi di awal atau akhir.
Area ② Nama file	Nama Tabel Fisik	Nama tabel yang dibuat secara otomatis di database setelah file diunggah. Anda dapat mengubah nama tabel fisik sesuai kebutuhan. Catatan Nama tabel fisik hanya dapat berisi huruf, angka, dan garis bawah (_). Nama tersebut harus tidak lebih dari 150 karakter panjangnya.
Area ③ Baris header	Baris Header	Anda dapat mengubah baris header untuk lembar kerja saat ini di sini. Catatan Nomor tersebut harus berupa bilangan bulat lebih besar dari 0. Pastikan baris header tidak berisi bidang kosong. Jika tidak, kesalahan akan terjadi.
Area ④ Pratinjau data	Pratinjau Data	Di tab Pratinjau Data, Anda dapat melihat pratinjau data dan melakukan operasi berikut. Modifikasi nama bidang: Klik kotak teks nama bidang untuk mengubah nama bidang. Modifikasi tipe bidang: Klik ikon tipe bidang dan pilih tipe bidang dari daftar drop-down. Tipe yang didukung adalah teks, numerik, dan tanggal.
Area ④ Pratinjau data	Detail Bidang	Di tab Detail Bidang, Anda dapat mengonfigurasi Nama Bidang File, Nama Bidang Database, dan Tipe Bidang. Setelah file diunggah, file tersebut disimpan sebagai tabel database. Nama bidang database dan tipe bidang digunakan sebagai nama dan tipe untuk tabel database yang dihasilkan. Nama kolom file menjadi komentar bidang untuk tabel database.

Klik Konfirmasi dan Unggah di bagian bawah halaman. Kotak dialog muncul menunjukkan kemajuan unggah untuk setiap lembar kerja. Jika pengunggahan gagal, Anda dapat mengklik Kembali (①) di kotak dialog kesalahan untuk kembali ke langkah Pratinjau Data dan menyesuaikan detail seperti tipe bidang dan nama lembar kerja. Anda juga dapat mengklik Unggah Ulang (②) untuk kembali ke langkah Unggah File dan mengunggah file yang telah diperbaiki.
Setelah file diunggah, klik Kembali ke Daftar Sumber Data untuk melihat sumber data file yang diunggah.

Modifikasi File yang Diunggah

Setelah mengunggah file data bisnis, Anda mungkin perlu memperbaruinya karena perubahan bisnis. Anda dapat menambahkan data, mengganti file, atau menghapus file lama untuk mendukung analisis berkelanjutan.

Klik ikon di sebelah kanan file target untuk pergi ke halaman Modifikasi Unggah File. Anda dapat melakukan operasi berikut.

Konfigurasi		Operasi
Nama Tampilan		Nama tampilan file di Quick BI. Anda dapat mengubah nama ini. Catatan Nama tampilan tidak boleh berisi karakter khusus atau spasi di awal atau akhir.
Pratinjau Data	Menampilkan Data	Di panel Riwayat Penambahan, beralih antar file untuk melihat datanya.
Pratinjau Data	Modifikasi bidang	Modifikasi nama bidang: Klik kotak teks nama bidang untuk mengubah nama bidang. Modifikasi tipe bidang: Klik ikon tipe bidang dan pilih tipe bidang dari daftar drop-down. Tipe yang didukung adalah teks, numerik, dan tanggal. Catatan Anda hanya dapat memodifikasi bidang saat melihat Data Keseluruhan.
Detail Bidang	Modifikasi bidang	Modifikasi nama bidang: Klik kotak teks nama kolom file untuk mengubah nama bidang. Modifikasi tipe bidang: Klik daftar drop-down tipe bidang dan pilih tipe bidang. Tipe yang didukung adalah teks, numerik, dan tanggal. Hapus bidang: Klik ikon di kolom Tindakan bidang target untuk menghapus bidang tersebut. Catatan Anda hanya dapat memodifikasi bidang saat melihat Data Keseluruhan.
Tambahkan bidang		Klik Tambahkan Bidang di sudut kanan atas tabel. Di kotak dialog Tambahkan Bidang, masukkan informasi untuk bidang baru dan klik OK. Catatan Anda hanya dapat menambahkan bidang saat melihat Data Keseluruhan. Nama Tampilan Bidang: Nama tampilan bidang yang akan ditambahkan di platform Quick BI. Nama Bidang Fisik: Nama bidang yang akan ditambahkan di tabel database fisik. Tipe Bidang: Tipe yang didukung adalah teks, numerik, dan tanggal.
Riwayat Penambahan	Lihat riwayat penambahan	Panel Riwayat Penambahan mencantumkan file yang ditambahkan. Klik kartu file untuk melihat konten yang ditambahkan.
	Tambahkan file	Jika file data bisnis baru dihasilkan karena pertumbuhan bisnis, Anda dapat menambahkan file baru ke tabel yang sesuai dengan sumber data file yang ada. Untuk informasi lebih lanjut, lihat Tambahkan File.
	Ganti file	Jika data bisnis baru perlu menggantikan data bisnis lama karena perubahan bisnis, Anda dapat mengganti file lama. Untuk informasi lebih lanjut, lihat Ganti File.
	Hapus file	Jika file data bisnis berisi data kotor, Anda dapat menghapus file dari daftar file yang diunggah yang sesuai dengan tabel. Untuk informasi lebih lanjut, lihat Hapus file.

Tambahkan File

Jika data bisnis baru dihasilkan, Anda dapat menambahkannya ke file yang ada untuk memastikan data tetap mutakhir dan lengkap. Ikuti langkah-langkah berikut.

Masuk ke Workbench dan buka halaman Sumber Data. Di daftar File yang Diunggah, temukan file target dan klik namanya (③) atau ikon (④) di kolom Tindakan.
Di halaman Modify File Upload, klik tombol Append di sebelah kanan.
Di panel Tambahkan File, klik atau seret file yang ingin Anda tambahkan ke area unggah.
Di halaman Pratinjau Data, beralih ke tab lembar kerja (①) yang ingin Anda tambahkan ke file asli. Anda dapat mengubah Baris Header (②) dan Tipe Bidang (③) sesuai kebutuhan. Lalu, klik Berikutnya (④).
Di langkah Pencocokan Bidang, cocokkan bidang antara file yang ditambahkan dan file asli. Sistem mencocokkan bidang dengan nama yang sama secara default. Anda dapat secara manual mengubah hubungan pencocokan. Untuk bidang dengan nama berbeda, Anda juga dapat secara manual menyeretnya dari area Bidang yang Harus Dicocokkan ke area Pencocokan Bidang.
Catatan
- Pastikan tipe bidang file asli dan file yang ditambahkan cocok. Jika tidak, kesalahan akan terjadi. Aturan pencocokan adalah sebagai berikut:
  - Jika bidang asli adalah teks: Dapat dicocokkan dengan tipe bidang apa saja.
  - Jika bidang asli adalah numerik: Hanya dapat dicocokkan dengan tipe numerik.
  - Jika bidang asli adalah tanggal: Hanya dapat dicocokkan dengan tipe tanggal.
- Jika file yang ditambahkan memiliki lebih banyak bidang daripada file asli, Anda dapat mengklik Tambahkan Bidang untuk membuat bidang yang sesuai di file asli untuk pencocokan. Jika bidang tambahan tidak diperlukan, Anda dapat melanjutkan ke langkah berikutnya.
- Jika file yang ditambahkan memiliki lebih sedikit bidang daripada file asli, bidang ekstra di file asli dapat tetap tidak dicocokkan. Anda kemudian dapat melanjutkan ke langkah berikutnya.
- Jika file yang ditambahkan berisi bidang duplikat, sistem mencoba mencocokkan bidang dengan nama yang sama secara berurutan. Dalam hal ini, Anda harus secara manual menyesuaikan hubungan pencocokan di langkah Pencocokan Bidang. Pastikan setiap bidang di tabel asli hanya cocok dengan satu bidang yang sesuai di file yang ditambahkan. Untuk bidang duplikat, pilih satu untuk dicocokkan berdasarkan kebutuhan bisnis Anda.
Klik Konfirmasi dan Unggah. Setelah pengunggahan berhasil, Anda dapat melihat file yang ditambahkan di panel riwayat penambahan.
(Opsional) Untuk mengganti file yang ditambahkan, buka panel Riwayat Penambahan dan klik ikon di sebelah file yang ingin Anda ganti. Ini membuka antarmuka Ganti File di mana Anda dapat melakukan operasi terkait.

Ganti File

Jika beberapa data di file asli perlu diganti sementara data lainnya masih valid, Anda dapat mengganti data di sumber data yang ada untuk mempertahankan akurasi data. Ikuti langkah-langkah berikut.

Di halaman Modifikasi Unggah File, buka panel Riwayat Penambahan. Pilih file yang akan diganti dan klik ikon pada kartu file, atau klik Ganti Data di sudut kanan atas tabel data.
Di halaman Ganti File, klik atau seret file baru ke area unggah.
Catatan
Hanya penggantian lembar tunggal yang didukung. Jika file yang Anda unggah memiliki beberapa lembar, pilih lembar yang benar di halaman pratinjau sebelum Anda mengunggah.
Di halaman Pratinjau Data, beralih ke tab lembar kerja (①) yang ingin Anda gunakan untuk mengganti file asli. Anda dapat mengubah Baris Header (②) dan Tipe Bidang (③) sesuai kebutuhan. Lalu, klik Berikutnya (④).
Di langkah Pencocokan Bidang, cocokkan bidang antara file pengganti dan file asli. Sistem mencocokkan bidang dengan nama yang sama secara default. Anda dapat secara manual mengubah hubungan pencocokan. Untuk bidang dengan nama berbeda, Anda juga dapat secara manual menyeretnya dari area Bidang yang Harus Dicocokkan ke area Pencocokan Bidang.
Catatan
- Pastikan tipe bidang file asli dan file pengganti cocok. Jika tidak, kesalahan akan terjadi. Aturan pencocokan adalah sebagai berikut:
  - Jika bidang asli adalah teks: Dapat dicocokkan dengan tipe bidang apa saja.
  - Jika bidang asli adalah numerik: Hanya dapat dicocokkan dengan tipe numerik.
  - Jika bidang asli adalah tanggal: Hanya dapat dicocokkan dengan tipe tanggal.
- Jika file pengganti memiliki lebih banyak bidang daripada file asli, Anda dapat mengklik Tambahkan Bidang untuk membuat bidang yang sesuai di file asli untuk pencocokan. Jika bidang tambahan tidak diperlukan, Anda dapat melanjutkan ke langkah berikutnya.
- Jika file pengganti memiliki lebih sedikit bidang daripada file asli, bidang ekstra di file asli dapat tetap tidak dicocokkan. Setelah penggantian, bidang ekstra tersebut tetap ada di data. Anda dapat melihatnya di Detail Bidang data.
- Jika file pengganti berisi bidang duplikat, sistem mencoba mencocokkan bidang dengan nama yang sama secara berurutan. Dalam hal ini, Anda harus secara manual menyesuaikan hubungan pencocokan di langkah Pencocokan Bidang. Pastikan setiap bidang di tabel asli hanya cocok dengan satu bidang yang sesuai di file pengganti. Untuk bidang duplikat, pilih satu untuk dicocokkan berdasarkan kebutuhan bisnis Anda.
Klik Konfirmasi dan Unggah. Setelah pengunggahan berhasil, Anda dapat melihat file yang diganti di panel riwayat penambahan.

Hapus File

Jika Anda tidak lagi memerlukan file data bisnis, atau jika file tersebut berisi data kotor, Anda dapat memilih dan menghapusnya dari panel Riwayat Penambahan di halaman Modifikasi Unggah File.

File lokal contoh

Anda dapat mengunduh file CSV berikut untuk latihan: Contoh data penjualan.csv.
Anda dapat mengunduh file Excel berikut untuk latihan: Contoh data penjualan .xlsx.

Tabel berikut menjelaskan struktur data penjualan.

Nama bidang	Tipe bidang	Deskripsi bidang
order_id	varchar	ID Pesanan
report_date	datetime	Tanggal pesanan
customer_name	varchar	Nama pelanggan
order_level	varchar	Tingkat pesanan
order_number	double	Jumlah pesanan
order_amt	double	Jumlah pesanan
back_point	double	Diskon
shipping_type	varchar	Metode pengiriman
profit_amt	double	Jumlah laba
price	double	Harga satuan
shipping_cost	double	Biaya pengiriman
area	varchar	Area
province	varchar	Provinsi
city	varchar	Kota
product_type	varchar	Tipe produk
product_sub_type	varchar	Subtipe produk
product_name	varchar	Nama produk
product_box	varchar	Paket produk
shipping_date	datetime	Tanggal pengiriman

FAQ

1. Apa yang harus saya lakukan jika konten file CSV yang diunggah berisi teks berantakan?

Quick BI secara akurat mendekode file CSV yang dalam format UTF-8. Dalam sebagian besar kasus, Quick BI juga dapat mendekode file CSV dalam format GBK atau GB2312. Namun, dekode mungkin gagal dalam beberapa kasus. Anda harus mengonversi file-file tersebut ke format UTF-8.

Buka file CSV menggunakan Notepad.
Pilih Save As.
Klik panah drop-down untuk Encoding.
Dari daftar Encoding, pilih UTF-8.

2. Apa yang harus saya lakukan jika kesalahan "Tipe bidang tidak cocok" terjadi saat saya menambahkan file?

Alasan 1: Tipe bidang di tabel sumber dan tabel yang ditambahkan tidak konsisten. Anda harus secara manual mengubah tipe data di salah satu tabel atau mencocokkan ulang bidang-bidang tersebut.

Alasan 2: Jika kolom di file Excel yang ditambahkan hanya berisi sel kosong, Quick BI mengidentifikasi bidang tersebut sebagai teks. Jika bidang yang sesuai di tabel asli adalah numerik, kesalahan "Tipe bidang tidak cocok" akan terjadi. Untuk menyelesaikan masalah ini, tambahkan nilai numerik ke sel mana pun di kolom kosong file Excel yang ditambahkan. Anda kemudian dapat mengunggah file tersebut dengan sukses.

3. Apa yang harus saya lakukan jika unggah file gagal dengan kesalahan "Penguraian file Excel gagal", atau data tidak akurat setelah unggah?

Alasan: Format atau konten file yang diunggah tidak memenuhi persyaratan. Periksa item berikut:

Solusi:

Periksa 1: Verifikasi bahwa tipe file adalah CSV atau Excel. Jika itu adalah file Excel, verifikasi bahwa formatnya adalah .xls atau .xlsx. Selain itu, pastikan file memenuhi persyaratan yang dijelaskan di Catatan.
Periksa 2: Konfirmasikan bahwa format file dan ukurannya memenuhi standar yang dijelaskan di Batasan.

4. Mengapa saya tidak dapat menemukan tombol unggah, atau mengapa tombol tersebut berwarna abu-abu?

Alasan 1: Anda tidak memiliki izin yang diperlukan. Untuk mengunggah file dan membuat sumber data file, Anda harus menjadi pengembang dengan izin pengembang atau lebih tinggi untuk ruang kerja. Alternatifnya, Anda harus diberi izin untuk menggunakan atau mengedit sumber data.

Alasan 2: Anda tidak memiliki izin baca dan tulis untuk sumber data target. Pastikan akun database yang digunakan untuk sumber data Quick BI memiliki izin baca dan tulis untuk database. Tanpa izin ini, Anda tidak dapat mengunggah file. Hubungi administrator basis data untuk memberikan izin yang diperlukan.

5. Mengapa bidang baru tidak ditampilkan di set data setelah saya menambahkan file atau menambahkan bidang baru?

Alasan: Tabel asli tidak berisi bidang tersebut. Setelah Anda menambahkan bidang baru, bidang tersebut tidak dipilih di set data secara default. Di halaman pengeditan set data, buka antarmuka konfigurasi model dan secara manual pilih kotak centang untuk bidang tersebut agar ditampilkan.

6. Mengapa saya tidak dapat melihat file CSV saat memilih file untuk diunggah?

Alasan: Dalam lingkungan Windows, saat Anda mengklik tombol unggah, kotak dialog pemilihan file hanya menampilkan file .xlsx secara default. Untuk menemukan file CSV, Anda harus memilih Semua File dari opsi tipe file.