全部产品
Search
文档中心

Data Management:Impor Data

更新时间:Jul 02, 2025

Untuk mengimpor sejumlah besar data dalam bentuk skrip SQL, file CSV, atau file Excel ke database, Anda dapat menggunakan fitur impor data yang disediakan oleh Data Management (DMS).

Prasyarat

  • Database termasuk salah satu jenis berikut:

    • MySQL: ApsaraDB RDS for MySQL, PolarDB for MySQL, ApsaraDB MyBase for MySQL, PolarDB for Xscale (PolarDB-X), AnalyticDB for MySQL, dan database MySQL dari sumber lainnya.

    • SQL Server: ApsaraDB RDS for SQL Server, ApsaraDB MyBase for SQL Server, dan database SQL Server dari sumber lainnya.

    • PostgreSQL: ApsaraDB RDS for PostgreSQL, PolarDB for PostgreSQL, ApsaraDB MyBase for PostgreSQL, AnalyticDB for PostgreSQL, dan database PostgreSQL dari sumber lainnya.

    • MariaDB: ApsaraDB RDS for MariaDB dan database MariaDB dari sumber lainnya.

    • OceanBase

    • PolarDB for PostgreSQL (Kompatibel dengan Oracle)

    • Dameng (DM)

    • Db2

    • Oracle

    • Redis

    • MongoDB

  • Anda telah masuk ke database tempat data akan diimpor di DMS.

  • Anda memiliki izin perubahan pada database tujuan.

Catatan Penggunaan

  • Skrip SQL, file CSV, atau file Excel yang diimpor dalam satu tiket dapat berukuran hingga 5 GB.

  • DMS memungkinkan Anda mengunggah file ZIP sebagai lampiran. Jika ingin mengimpor beberapa file dalam satu tiket, Anda dapat mengemas file tersebut ke dalam file ZIP untuk diunggah.

  • Fitur impor data tidak mendukung pengubahan data untuk beberapa database sekaligus. Untuk mengubah data untuk beberapa database sekaligus, ajukan tiket Normal Data Modify. Untuk informasi lebih lanjut, lihat Normal Data Modify.

  • Jika hanya ingin mengubah sejumlah kecil data, kami sarankan Anda mengajukan tiket Normal Data Modify atau Lockless Change untuk memastikan perubahan data yang stabil.

  • Jika skrip SQL yang digunakan untuk mengimpor sejumlah besar data berisi pernyataan SQL yang digunakan untuk mengubah skema, tabel mungkin terkunci karena perubahan skema meskipun fitur perubahan skema tanpa kunci diaktifkan.

  • Untuk mencegah performa database terganggu saat sejumlah besar data diimpor, gunakan pernyataan SQL yang lebih efisien seperti INSERT, UPDATE, dan DELETE. Pernyataan UPDATE dan DELETE harus menggunakan indeks kunci utama.

  • File CSV atau Excel yang diimpor hanya boleh berisi nama bidang dan nilai bidang. Jika tidak, tugas impor akan gagal.

Prosedur

Catatan

Dalam topik ini, instance ApsaraDB RDS for MySQL yang dikelola dalam mode Kolaborasi Keamanan digunakan untuk menjelaskan prosedur konfigurasi.

  1. Masuk ke Konsol DMS V5.0.
  2. Pindahkan pointer ke ikon 2023-01-28_15-57-17.png di sudut kiri atas Konsol DMS dan pilih All Features > Database Development > Data Change > Data Import.

    Catatan

    Jika menggunakan Konsol DMS dalam mode normal, pilih Database Development > Data Change > Data Import di bilah navigasi atas.

  3. Di halaman Data Change Tickets, konfigurasikan parameter tiket. Tabel berikut menjelaskan parameter utama.

    Parameter

    Deskripsi

    Database

    Database tempat data akan diimpor. Anda hanya dapat memilih satu database dari daftar drop-down Database pada satu waktu.

    Catatan

    Jika database dikelola dalam mode Flexible Management atau Stable Change, pastikan Anda telah masuk ke database. Jika tidak, database tidak akan ditampilkan dalam daftar drop-down Database.

    Execution Method

    Cara Anda ingin tiket dijalankan. Secara default, Ticket Submitter Executes Upon Approval dipilih. Anda juga dapat mengatur parameter ini ke salah satu nilai berikut:

    • Automatically Execute Upon Approval

    • Last Approver Executes

    File Encoding

    Metode pengkodean database. Secara default, Automatic Identification dipilih. Anda juga dapat mengatur parameter ini ke salah satu nilai berikut:

    • UTF-8

    • GBK

    • ISO-8859-1

    Import Mode

    Mode data akan diimpor. Nilai valid:

    • Speed Mode: Di langkah Eksekusi, pernyataan SQL dalam file yang diunggah dibaca dan langsung dieksekusi untuk mengimpor data ke database tujuan. Mode cepat kurang aman tetapi lebih cepat daripada mode keamanan.

      Catatan

      Secara default, Speed Mode dinonaktifkan untuk instance database berdasarkan aturan keamanan. Anda dapat mengaktifkan mode cepat dengan melakukan operasi berikut: Buka tab SQL Correct di halaman Detail set aturan keamanan yang diterapkan pada instance database. Di daftar di bawah titik pemeriksaan Basic Configuration Item, temukan aturan "Apakah impor data mendukung pemilihan mode cepat" dan klik Edit di kolom Tindakan. Di kotak dialog yang muncul, aktifkan Nilai Konfigurasi.

    • Security Mode: Di langkah Pra-pemeriksaan, file yang diunggah diurai, dan pernyataan SQL atau data file CSV dalam file yang diunggah disimpan dalam cache. Di langkah Eksekusi, pernyataan SQL yang disimpan dalam cache dibaca dan dieksekusi untuk mengimpor data, atau data file CSV yang disimpan dalam cache dibaca dan diimpor ke database tujuan. Mode keamanan lebih aman tetapi lebih lambat daripada mode cepat.

    File Type

    Format file untuk impor data. Nilai valid:

    • SQL Script: Secara default, Anda hanya dapat menggunakan pernyataan INSERT dan REPLACE untuk mengimpor data ke instance database yang dikelola dalam mode Kolaborasi Keamanan. Jika Anda ingin menggunakan pernyataan SQL lainnya untuk mengimpor data, modifikasi aturan keamanan untuk impor data sebagai administrator basis data (DBA) atau administrator DMS. Anda dapat memodifikasi aturan keamanan dengan melakukan operasi berikut: Buka halaman Details set aturan keamanan yang diterapkan pada instance database dan klik tab SQL Correct. Di daftar di bawah titik pemeriksaan Batch Data import rules, modifikasi aturan keamanan sesuai dengan kebutuhan bisnis Anda.

    • CSV: Pembatas dalam file harus berupa koma (,).

    • Excel: File dapat berisi header tabel dan data, atau hanya berisi data. Header tabel berisi atribut data.

    • Catatan

      Jika Anda mengatur parameter ini ke CSV atau Excel, pastikan Anda telah membuat tabel untuk impor data sebelum mengimpor data.

    Destination Table Name

    Tabel tujuan tempat data akan diimpor.

    Catatan

    Parameter ini ditampilkan setelah Anda mengatur parameter Tipe File ke CSV atau Excel.

    Data Location

    Tipe file yang datanya akan diimpor. Nilai valid:

    • 1st behavioral attributes: Baris pertama tabel berisi nama bidang.

    • 1st behavioral data: Baris pertama tabel berisi data.

    Catatan

    Parameter ini hanya ditampilkan jika Anda mengatur parameter File Type ke CSV atau Excel.

    Write Mode

    Mode yang ingin Anda gunakan untuk menulis data impor ke tabel tujuan. Nilai valid:

    • INSERT: Database memeriksa kunci utama selama penyisipan data. Jika nilai kunci utama duplikat terdeteksi, kesalahan dilaporkan.

    • INSERT_IGNORE: Jika data impor berisi catatan data yang sama dengan yang ada di tabel tujuan, catatan data baru diabaikan.

    • REPLACE_INTO: Jika data impor berisi baris yang memiliki nilai yang sama untuk kunci utama atau indeks unik dengan baris yang ada di tabel tujuan, sistem menghapus baris yang ada dan menyisipkan baris baru ke tabel tujuan.

    Catatan

    Anda dapat menggunakan pernyataan INSERT INTO, INSERT IGNORE, atau REPLACE INTO untuk menulis data ke ApsaraDB RDS for MySQL, PolarDB for MySQL, PolarDB-X, AnalyticDB for MySQL, dan database ApsaraDB for OceanBase. Anda hanya dapat menggunakan pernyataan INSERT INTO untuk menulis data ke database lainnya.

    Attachment

    File yang ingin Anda impor. Nilai valid: File dan Unggah Objek OSS.

    Jika Anda ingin mengunggah objek yang disimpan di Object Storage Service (OSS), pertama-tama daftarkan sumber data OSS dengan DMS. Setelah sumber data OSS didaftarkan, klik Upload OSS Object. Di kotak dialog Unggah Objek OSS, masukkan jalur file. Contoh: examplefolder/example.sql.

    Catatan
    • Format file yang didukung termasuk SQL, CSV, TXT, XLSX, dan ZIP.

    • File yang akan diimpor dapat berukuran hingga 5 GB.

    • Untuk informasi lebih lanjut tentang cara mendaftarkan sumber data OSS dengan DMS, lihat Daftarkan instance database Alibaba Cloud.

    Other Options

    Opsional. Menentukan apakah akan melewati kesalahan.

    • Secara default, kotak centang tidak dicentang. Jika terjadi kesalahan, DMS menghentikan eksekusi pernyataan SQL dan mengembalikan pesan kesalahan.

    • Jika Anda mencentang kotak centang, DMS melewati kesalahan dan melanjutkan eksekusi pernyataan SQL.

    SQL Statements for Rollback

    • Text: pernyataan SQL untuk rollback operasi impor data. Masukkan pernyataan SQL di bidang Teks SQL.

    • Attachment: file SQL untuk rollback. Unggah file SQL.

      Catatan
      • Format file yang didukung termasuk SQL, TXT, dan ZIP.

      • File untuk rollback dapat berukuran hingga 15 MB.

    Change Stakeholder

    Opsional. Pemangku kepentingan yang terlibat dalam impor data. Semua pemangku kepentingan yang ditentukan dapat melihat detail tiket dan berpartisipasi dalam proses persetujuan. Pengguna lain kecuali administrator DMS dan DBA tidak diizinkan untuk melihat detail tiket.

  4. Klik Submit dan tunggu hingga pra-pemeriksaan selesai. Jika tiket gagal pra-pemeriksaan, perbaiki masalah dan klik Retry.

    Catatan
    • Jika file yang diunggah adalah skrip SQL, DMS memeriksa pra-pernyataan SQL dalam file yang diunggah. Jika file yang diunggah adalah file CSV, DMS menghasilkan pernyataan INSERT berdasarkan file yang diunggah.

    • Jika kesalahan dilaporkan selama pemeriksaan tipe langkah Pra-pemeriksaan, modifikasi aturan keamanan dalam set aturan keamanan yang diterapkan pada instance database berdasarkan pesan kesalahan. Untuk informasi lebih lanjut, lihat Perubahan Data.

  5. Di langkah Approval, klik Submit for Approval. Di pesan Prompt, klik OK.

  6. Setelah tiket disetujui, klik Execute Change di langkah Execute.

  7. Di kotak dialog Task Settings, tentukan waktu untuk menjalankan tugas.

    Anda dapat menggunakan salah satu metode berikut untuk menjalankan tugas:

    • Running immediately: Secara default, opsi ini dipilih. Jika Anda memilih opsi ini, tugas segera dijalankan setelah Anda klik Confirm Execution.

    • Schedule: Jika Anda memilih opsi ini, Anda harus menentukan waktu mulai untuk tugas. Setelah Anda klik Confirm Execution, tugas dijalankan pada waktu yang ditentukan.

    Catatan
    • Saat tugas dijalankan, DMS membaca pernyataan SQL dalam mode streaming dan mengeksekusi pernyataan SQL dalam batch. Setiap batch pernyataan SQL berukuran 1 MB.

    • Di langkah Execute, Anda dapat melihat status, detail pemeriksaan SQL, dan log penjadwalan tugas.

    • Jika ingin memulai ulang tugas yang ditangguhkan, tugas dijalankan dari awal atau offset penangguhan berdasarkan mode impor.

      • Mode cepat: Jika tugas ditangguhkan dan dimulai ulang, skrip SQL dieksekusi atau file data diimpor dari awal.

      • Mode keamanan: Jika tugas ditangguhkan dan dimulai ulang, skrip SQL dieksekusi atau file data diimpor dari offset penangguhan.

  8. Tunggu hingga muncul pesan yang menunjukkan bahwa data telah diimpor.

  9. Opsional. Kueri data yang diimpor.

    Buka tab SQLConsole untuk mengkueri data yang diimpor. Untuk informasi lebih lanjut, lihat Kelola database di tab SQLConsole.

File Contoh

FAQ

  • T: Apa yang harus saya lakukan jika terjadi kesalahan "permission denied for schema XXXXX" selama impor data?

    J: Kesalahan ini menunjukkan bahwa akun yang digunakan untuk masuk ke database di DMS tidak memiliki izin yang diperlukan. Anda dapat masuk ke database di DMS menggunakan akun dengan hak istimewa dan mencoba lagi impor data. Sebagai alternatif, Anda dapat mengimpor data ke database publik lainnya yang dapat diakses. Untuk informasi lebih lanjut tentang cara mengubah akun database, lihat Modifikasi instance database.

    Jika kesalahan tetap ada, Anda dapat menggunakan Data Transmission Service (DTS) untuk migrasi data. Untuk informasi lebih lanjut, lihat Ikhtisar skenario migrasi data.

  • T: Apa yang harus saya lakukan jika tiket impor data gagal pra-pemeriksaan dan sistem melaporkan bahwa pengiriman pernyataan tertentu tidak diizinkan?

    J: Anda perlu memodifikasi aturan keamanan sebagai DBA atau administrator DMS untuk mengizinkan pernyataan SQL jenis tertentu dieksekusi selama impor data. Contoh berikut menunjukkan cara mengizinkan pernyataan CREATE TABLE dieksekusi selama impor data:

    1. Masuk ke Konsol DMS dan buka halaman Security Rules.

    2. Di halaman Aturan Keamanan, temukan set aturan keamanan yang ingin Anda kelola dan klik Edit di kolom Tindakan. Di halaman Detail, klik tab SQL Correct.

    3. Di tab Koreksi SQL, atur parameter Checkpoints ke Batch Data import rules. Temukan aturan Allow SQL statements to be executed during data import dan klik Edit di kolom Tindakan.

    4. Di kotak dialog yang muncul, tambahkan pernyataan CREATE_TABLE di bidang Rule DSL dan klik Submit. Untuk informasi lebih lanjut, lihat Koreksi SQL.

    5. Kembali ke halaman detail tiket impor data. Di langkah Precheck, klik Retry.

  • T: Bagaimana cara mengunggah file yang ukurannya lebih besar dari 5 GB?

    J: Anda dapat menggunakan salah satu metode berikut berdasarkan kebutuhan bisnis Anda:

    • Pisahkan file menjadi beberapa file kecil dan ajukan beberapa tiket untuk mengunggah file kecil tersebut.

    • Gunakan Navicat untuk terhubung secara remote ke database, lalu unggah file.

  • T: Bagaimana cara menghapus data yang diimpor jika terjadi kesalahan selama proses impor data? J: Anda dapat menggunakan salah satu metode berikut berdasarkan jumlah data yang perlu dihapus:

    • Untuk sejumlah kecil data tabel, Anda dapat mengeksekusi pernyataan DELETE di SQL Console. Untuk informasi lebih lanjut, lihat Kelola database di tab SQLConsole.

    • Untuk sejumlah besar data tabel, Anda dapat mengajukan tiket Normal Data Modify atau perubahan data tanpa kunci untuk menghapus data tabel. Anda dapat menggunakan fitur perubahan data tanpa kunci untuk mengubah sejumlah besar data tabel tanpa perlu mengunci tabel. Untuk informasi lebih lanjut, lihat Normal Data Modify dan Lakukan operasi DML tanpa kunci.