Menentukan Karakteristik Tataan Hasil (ODBC)

Berlaku untuk: SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Metadata adalah data yang menjelaskan data lain. Misalnya, metadata tataan hasil menjelaskan karakteristik kumpulan hasil, seperti jumlah kolom dalam kumpulan hasil, jenis data kolom tersebut, nama, presisi, dan kemampuan nullnya.

ODBC memasok metadata ke aplikasi melalui fungsi API katalognya. Driver SQL Server Native Client ODBC menerapkan banyak fungsi katalog ODBC API sebagai panggilan ke prosedur katalog SQL Server yang sesuai.

Aplikasi memerlukan metadata untuk sebagian besar operasi tataan hasil. Misalnya, aplikasi menggunakan jenis data kolom untuk menentukan jenis variabel apa yang akan diikat ke kolom tersebut. Ini menggunakan panjang byte kolom karakter untuk menentukan berapa banyak ruang yang harus ditampilkan data dari kolom tersebut. Bagaimana aplikasi menentukan metadata untuk kolom bergantung pada jenis aplikasi.

Aplikasi vertikal biasanya bekerja dengan tabel yang telah ditentukan sebelumnya dan melakukan operasi yang telah ditentukan sebelumnya pada tabel tersebut. Karena metadata tataan hasil untuk aplikasi tersebut ditentukan sebelum aplikasi bahkan ditulis dan dikontrol oleh pengembang, itu dapat dikodekan secara permanen ke dalam aplikasi. Misalnya, jika kolom ID pesanan didefinisikan sebagai bilangan bulat 4-byte di sumber data, aplikasi selalu dapat mengikat bilangan bulat 4-byte ke kolom tersebut. Ketika metadata dikodekan secara permanen dalam aplikasi, perubahan pada tabel yang digunakan oleh aplikasi umumnya menyiratkan perubahan pada kode aplikasi.

Dalam aplikasi generik, terutama aplikasi yang mendukung kueri ad hoc, metadata tataan hasil yang mereka buat biasanya tidak diketahui sampai run time.

Untuk menentukan karakteristik kumpulan hasil, aplikasi dapat memanggil:

• SQLNumResultCols untuk menentukan berapa banyak kolom yang dikembalikan permintaan.

• SQLColAttribute atau SQLDescribeCol untuk menjelaskan kolom dalam tataan hasil.

Aplikasi yang dirancang dengan baik ditulis dengan asumsi bahwa kumpulan hasil tidak diketahui dan menggunakan informasi yang dikembalikan oleh fungsi-fungsi ini untuk mengikat kolom dalam tataan hasil. Aplikasi dapat memanggil fungsi-fungsi ini kapan saja setelah pernyataan disiapkan atau dijalankan. Namun, untuk performa optimal, aplikasi harus memanggil SQLColAttribute, SQLDescribeCol, dan SQLNumResultCols setelah pernyataan dijalankan.

Anda dapat memiliki beberapa panggilan bersamaan untuk metadata. Prosedur katalog sistem yang mendasar implementasi API katalog ODBC dapat dipanggil oleh driver ODBC saat menggunakan kursor server statis. Ini memungkinkan aplikasi memproses beberapa panggilan secara bersamaan ke fungsi katalog ODBC.

Jika aplikasi menggunakan sekumpulan metadata tertentu lebih dari satu kali, aplikasi mungkin akan mendapat manfaat dari penembolokan informasi dalam variabel privat saat pertama kali diperoleh. Ini mencegah panggilan nanti ke fungsi katalog ODBC untuk informasi yang sama, yang memaksa driver untuk melakukan perjalanan pulang pergi ke server.

Lihat juga

Hasil Pemrosesan (ODBC)