Parameter Table-Valued (ODBC)

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

Dukungan ODBC untuk parameter bernilai tabel memungkinkan aplikasi klien mengirim data berparameter ke server secara lebih efisien, dengan mengirim beberapa baris ke server dengan satu panggilan.

Untuk informasi tentang parameter bernilai tabel di server, lihat Menggunakan Parameter Table-Valued (Mesin Database).

Di ODBC, ada dua cara untuk mengirim parameter bernilai tabel ke server:

• Semua data parameter bernilai tabel dapat berada dalam memori pada saat SQLExecDirect atau SQLExecute dipanggil. Data ini disimpan dalam array jika ada beberapa baris dalam nilai tabel.

• Aplikasi dapat menentukan data saat dijalankan untuk parameter bernilai tabel saat SQLExecDirect atau SQLExecute dipanggil. Dalam hal ini, baris data untuk nilai tabel dapat disediakan dalam batch, atau satu per satu untuk mengurangi persyaratan memori.

Opsi pertama memungkinkan prosedur tersimpan untuk merangkum lebih banyak logika bisnis. Misalnya, satu prosedur tersimpan dapat merangkum seluruh transaksi entri pesanan ketika item pesanan diteruskan sebagai parameter bernilai tabel. Opsi ini sangat efisien, karena hanya satu perjalanan pulang pergi ke server yang diperlukan. Atau, Anda dapat menggunakan prosedur yang berbeda untuk menangani header pesanan dan item pesanan secara terpisah, yang akan memerlukan lebih banyak kode dan kontrak yang lebih kompleks antara klien dan server.

Metode kedua menyediakan mekanisme yang efisien untuk operasi massal dengan data dalam jumlah yang sangat besar. Ini memungkinkan aplikasi untuk mengalirkan baris data ke server tanpa harus buffer semuanya dalam memori terlebih dahulu.

Anda dapat membuat batasan dan kunci primer saat membuat variabel tabel. Batasan adalah cara yang baik untuk memastikan bahwa data dalam tabel memenuhi persyaratan tertentu.

Di Bagian Ini

Penggunaan Parameter Table-Valued ODBC
Menjelaskan skenario pengguna utama untuk parameter bernilai tabel dan ODBC.

Jenis ODBC SQL untuk Parameter Table-Valued
Menjelaskan jenis SQL_SS_TABLE. Ini adalah jenis ODBC SQL baru yang mendukung parameter bernilai tabel.

Bidang Deskriptor Parameter Bernilai Tabel
Menjelaskan bidang deskriptor yang mendukung parameter bernilai tabel.

Bidang Deskriptor untuk Kolom Konstituen Parameter Table-Valued
Menjelaskan bidang deskriptor yang memiliki arti untuk parameter bernilai tabel.

Bidang Rekaman Diagnostik Parameter Bernilai Tabel
Menjelaskan dua bidang diagnostik yang telah ditambahkan ke rekaman diagnostik untuk mendukung parameter bernilai tabel.

Atribut Pernyataan yang Memengaruhi Parameter Table-Valued
Menjelaskan bidang header deskriptor baru yang memungkinkan kolom parameter bernilai tabel ditangani.

Pengikatan dan Transfer Data Parameter Table-Valued dan Nilai Kolom
Menjelaskan pengikatan parameter dan cara meneruskan parameter bernilai tabel ke server.

Metadata Parameter Bernilai Tabel untuk Pernyataan yang Disiapkan
Menjelaskan bagaimana aplikasi dapat memperoleh metadata untuk panggilan prosedur yang disiapkan.

Metadata Parameter Table-Valued Tambahan
Menjelaskan cara menggunakan SQLProcedureColumns, SQLTables, dan SQLColumns untuk mengambil metadata untuk parameter bernilai tabel.

Konversi Data Parameter Bernilai Tabel dan Kesalahan dan Peringatan Lainnya
Menjelaskan cara memproses kesalahan pada nilai kolom parameter bernilai tabel.

Kompatibilitas Lintas Versi
Menjelaskan konflik yang dapat terjadi ketika parameter bernilai tabel digunakan oleh klien atau server versi yang lebih lama dari SQL Server 2008 (10.0.x).

Ringkasan API Parameter Table-Valued ODBC
Mencantumkan fungsi ODBC yang mendukung parameter bernilai tabel.

Lihat juga

SQL Server Native Client (ODBC)
Parameter Bernilai Tabel (SQL Server Native Client)