ODBC tablo değerli parametre API'si özeti

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

ODBC, çeşitli mevcut API işlevlerine yönelik iyileştirmeler aracılığıyla tablo değerli parametreleri (tablo değerli parametreler) destekler. Bu işlevler birlikte çalışarak tablo değerli parametre şemalarını açıklar, satır kümelerini bağlar ve iletir, meta verileri getirir ve tanımlayıcı kayıtlarını yönetir.
Aşağıdaki bölümlerde, tablo değerli parametre işlem hattının her bir bölümünün nasıl çalıştığını anlamanıza yardımcı olmak için ilgili ODBC işlevleri mantıksal gruplar halinde düzenlenir.

Tablo değerli parametre şeması bulma ve meta veri işlevleri

Bu işlevler, bir uygulamanın sütun meta verileri, parametre tanımları ve kullanılabilir SQL veri türleri dahil olmak üzere tablo değerli parametrelerin yapısını bulmasına yardımcı olur.

İşlev	Amaç
Sqlcolumns	Tablo değerli parametre veya tablo türü için sütun meta verilerini alır
Sqldescribeparam	Tür, duyarlık ve ölçek dahil olmak üzere tablo değerli parametre parametresi için meta verileri döndürür
SQLGetTypeInfo	Tablo değerli parametre sütunları için sürücü tarafından desteklenen SQL veri türlerini alır
Sqlprimarykeys	Tablo değerli parametrelerle kullanılan tablo türlerindeki anahtar sütunlar hakkında bilgi sağlar
Sqlprocedurecolumns	Tablo değerli parametreyle ilgili saklı yordam parametreleri için meta verileri alır
Sqltables	Tablo değerli parametre bildirimleri için kaynak olarak kullanılabilen tabloları ve tablo türlerini listeler

Tablo değerli parametre bağlama ve veri iletimi

Bu işlevler yapılandırılmış verileri parametrelere bağlamayı, verileri sunucuya geçirmeyi veya yürütme sırasında satırları akışla aktarmayı işler.

İşlev	Amaç
Sqlbindparameter	Tablo değerli bir parametreyi uygulama arabelleğine veya satır kümesine bağlar
Sqlparamdata	Yürütme sırasında veri kullanılırken akışa alınan tablo değerli parametre parametresinin sonraki bölümünü alır
Sqlputdata	Yürütme sırasında tablo değerli parametre verilerini öbekler halinde gönderir

Tablo değerli parametreler için deyim yürütme

Bu işlevler tablo değerli parametrelere başvuran ve yürütme yaşam döngüsünü yöneten SQL deyimlerini yürütür.

İşlev	Amaç
Sqlexecdirect	Tablo değerli parametreleri önce hazırlamadan kullanan bir SQL deyimi yürütür
Sqlexecute	Tablo değerli parametre parametreleri içeren önceden hazırlanmış bir SQL deyimini yürütür

Tablo değerli parametreler için tanımlayıcı ve öznitelik yönetimi

Satır kümelerini ve yapılandırılmış parametreleri doğru açıklamak için gereken tanımlayıcı alanlarını ve deyim özniteliklerini yönetmek için bu işlevleri kullanın.

İşlev	Amaç
Sqlgetdescfield	Tablo değerli parametre sütunları veya satır kümeleri için tanımlayıcı meta verilerini alır
SQLSetDescField	Tablo değerli parametre sütunları veya satır kümeleri için tanımlayıcı meta verilerini ayarlar
Sqlsetdescrec	Yapılandırılmış tablo değerli parametre verileri için tam tanımlayıcı kaydı ayarlar
SQLGetStmtAttr	Tablo değerli parametre yürütme davranışını etkileyen deyim özniteliklerini alır
SQLSetStmtAttr	Tablo değerli parametre işlemleri için satır kümesi boyutları veya akış bayrakları gibi deyim özniteliklerini ayarlar

Tablo değerli parametreler için tanılama ve hata işleme

Uygulamalarınızın tablo değerli parametre bağlama ve yürütme sırasında hataları, uyarıları veya durum iletilerini algılamasına yardımcı olması için bu işlevleri kullanın.

İşlev	Amaç
Sqlgetdiagfield	Tablo değerli parametre işleme sırasında oluşturulan tanılama bilgilerini alır

İlgili içerik

• Table-Valued Parametreleri (ODBC)