Bagikan melalui

Argumen Pengidentifikasi

  • Artikel

Jika string dalam argumen pengidentifikasi dikutip, driver menghapus kosong di depan dan di belakang dan memperlakukan string secara harfiah dalam tanda kutip. Jika string tidak dikutip, driver akan menghapus kosong berikutnya dan melipat string ke huruf besar. Mengatur argumen pengidentifikasi ke penunjuk null mengembalikan SQL_ERROR dan SQLSTATE HY009 (Penggunaan pointer null tidak valid), kecuali argumen adalah nama katalog dan katalog tidak didukung.

Argumen ini diperlakukan sebagai argumen pengidentifikasi jika atribut pernyataan SQL_ATTR_METADATA_ID diatur ke SQL_TRUE. Dalam hal ini, garis bawah (_) dan tanda persen (%) akan diperlakukan sebagai karakter aktual, bukan sebagai karakter pola pencarian. Argumen ini diperlakukan sebagai argumen biasa atau argumen pola, tergantung pada argumen, jika atribut ini diatur ke SQL_FALSE.

Meskipun pengidentifikasi yang berisi karakter khusus harus dikutip dalam pernyataan SQL, pengidentifikasi tidak boleh dikutip ketika diteruskan sebagai argumen fungsi katalog, karena karakter kutipan yang diteruskan ke fungsi katalog ditafsirkan secara harfiah. Misalnya, misalkan karakter kutipan pengidentifikasi (yang khusus driver dan dikembalikan melalui SQLGetInfo) adalah tanda kutip ganda ("). Panggilan pertama ke SQLTables mengembalikan kumpulan hasil yang berisi informasi tentang tabel Akun Yang Dapat Dibayar, sementara panggilan kedua mengembalikan informasi tentang tabel "Akun Yang Dapat Dibayar", yang mungkin bukan yang dimaksudkan.

SQLTables(hstmt1, NULL, 0, NULL, 0, "Accounts Payable", SQL_NTS, NULL, 0);  
SQLTables(hstmt2, NULL, 0, NULL, 0, "\"Accounts Payable\"", SQL_NTS, NULL, 0);

Pengidentifikasi yang dikutip digunakan untuk membedakan nama kolom benar dari kolom pseudo dengan nama yang sama, seperti ROWID di Oracle. Jika "ROWID" diteruskan dalam argumen fungsi katalog, fungsi akan berfungsi dengan kolom pseudo ROWID jika ada. Jika kolom pseudo tidak ada, fungsi akan berfungsi dengan kolom "ROWID". Jika ROWID diteruskan dalam argumen fungsi katalog, fungsi akan berfungsi dengan kolom ROWID.

Untuk informasi selengkapnya tentang pengidentifikasi yang dikutip, lihat Pengidentifikasi yang Dikutip.