Menyisipkan Baris dengan SQLBulkOperations

Menyisipkan data dengan SQLBulkOperations mirip dengan memperbarui data dengan SQLBulkOperations karena menggunakan data dari buffer aplikasi terikat.

Sehingga setiap kolom dalam baris baru memiliki nilai, semua kolom terikat dengan nilai panjang/indikator SQL_COLUMN_IGNORE dan semua kolom yang tidak terikat harus menerima nilai NULL atau memiliki default.

Untuk menyisipkan baris dengan SQLBulkOperations, aplikasi melakukan hal berikut:

1. Mengatur atribut pernyataan SQL_ATTR_ROW_ARRAY_SIZE ke jumlah baris untuk menyisipkan dan menempatkan nilai data baru dalam buffer aplikasi terikat. Untuk informasi tentang cara mengirim data panjang dengan SQLBulkOperations, lihat Data Panjang dan SQLSetPos dan SQLBulkOperations.

2. Mengatur nilai dalam buffer panjang/penanda setiap kolom sesuai kebutuhan. Ini adalah panjang byte data atau SQL_NTS untuk kolom yang terikat pada buffer string, dan panjang byte data untuk kolom yang terikat pada buffer biner. Sementara itu, SQL_NULL_DATA digunakan untuk kolom apa pun yang akan diatur ke NULL. Aplikasi mengatur nilai dalam buffer panjang atau indikator kolom yang harus disetel ke default (bila tersedia) atau NULL (jika tidak ada) ke SQL_COLUMN_IGNORE.

3. Memanggil SQLBulkOperations dengan argumen Operation diatur ke SQL_ADD.

Setelah SQLBulkOperations kembali, baris saat ini tidak berubah. Jika kolom penanda (kolom 0) terikat, SQLBulkOperations mengembalikan penanda dari baris yang disisipkan dalam buffer kumpulan baris yang terikat ke kolom tersebut.