Artykuł
07/22/2011

SQLColAttribute

Można użyć SQLColAttribute pobrać atrybut kolumna zestaw wyników dla instrukcji ODBC przetworzone lub wykonane.Wywołanie SQLColAttribute na przygotowanych instrukcji przyczyn roundtrip do SQL Server. SQL Server Sterownik ODBC macierzysty klient otrzymuje zestaw wyników kolumna danych jako część wykonanie instrukcja, więc wywoływania SQLColAttribute po zakończeniu SQLExecute lub SQLExecDirect nie obejmuje obie strony serwera.

Ostrzeżenie

Atrybuty identyfikatora ODBC kolumna nie są dostępne na wszystkich SQL Server zestawy wyników.

Identyfikator pola	Opis
SQL_COLUMN_TABLE_NAME	Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanej instrukcji SELECT zawierającej do PRZEGLĄDANIA klauzula.
SQL_DESC_BASE_COLUMN_NAME	Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanej instrukcji SELECT zawierającej do PRZEGLĄDANIA klauzula.
SQL_DESC_BASE_TABLE_NAME	Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanej instrukcji SELECT zawierającej do PRZEGLĄDANIA klauzula.
SQL_DESC_CATALOG_NAME	Nazwa bazy danych.Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanej instrukcji SELECT zawierającej do PRZEGLĄDANIA klauzula.
SQL_DESC_LABEL	Dostępna dla wszystkich zestawów wyników.Wartość jest identyczna z wartością pole SQL_DESC_NAME. Pole to jest zerowej długości tylko, jeśli kolumna jest wynik wyrażenia, a wyrażenie zawiera przypisania etykiety.
SQL_DESC_NAME	Dostępna dla wszystkich zestawów wyników.Wartość jest identyczna z wartością pole SQL_DESC_LABEL. Pole to jest zerowej długości tylko, jeśli kolumna jest wynik wyrażenia, a wyrażenie zawiera przypisania etykiety.
SQL_DESC_SCHEMA_NAME	Nazwa właściciela.Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanej instrukcji SELECT zawierającej do PRZEGLĄDANIA klauzula. Dostępne tylko wtedy, gdy nazwa właściciela jest określona dla kolumna w instrukcja SELECT.
SQL_DESC_TABLE_NAME	Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanej instrukcji SELECT zawierającej do PRZEGLĄDANIA klauzula.
SQL_DESC_UNNAMED	SQL_NAMED dla wszystkich kolumn w zestaw wyników , chyba że kolumna jest wynikiem wyrażenie nie zawiera przypisania etykiety jako część wyrażenie.Gdy SQL_DESC_UNNAMED zwraca SQL_UNNAMED, wszystkie atrybuty identyfikatora ODBC kolumna zawierają ciągi zerowej długości kolumna.

SQL ServerMacierzysty sterownik ODBC klienta za pomocą instrukcja FMTONLY USTAWIĆ zmniejszyć obciążenie serwera podczas SQLColAttribute jest wywoływana dla przygotowanych instrukcja ale unexecuted.

Dla typów dużą wartość SQLColAttribute zwróci następujące wartości:

Identyfikator pola	Opis zmiany
SQL_DESC_DISPLAY_SIZE	Jest to maksymalna liczba znaków wymagane do wyświetlania danych z kolumna.Dla kolumn typu dużą wartość zwrócona wartość jest SQL_SS_LENGTH_UNLIMITED.
SQL_DESC_LENGTH	Zwraca wartość rzeczywistą długością kolumna zestaw wyników.Dla kolumn typu dużą wartość zwrócona wartość jest SQL_SS_LENGTH_UNLIMITED.
SQL_DESC_OCTET_LENGTH	Zwraca maksymalną długość kolumna typu dużą wartość.SQL_SS_LENGTH_UNLIMITED jest używany do wskazania nieograniczonym rozmiarze.
SQL_DESC_PRECISION	Zwraca wartość SQL_SS_LENGTH_UNLIMITED dla kolumn typu dużą wartość.
SQL_DESC_TYPE	Zwraca dla typów wartości dużych SQL_VARCHAR, SQL_WVARCHAR i SQL_VARBINARY.
SQL_DESC_TYPE_NAME	Zwraca "varchar", "varbinary", "nvarchar" dla typów dużą wartość.

Wszystkie wersje atrybuty kolumna są zgłaszane tylko w pierwszym zestaw wyników po wielu zestaw wynikóws są generowane przez partia przygotowanych instrukcji SQL.

Następujące atrybuty kolumna są udostępniane przez rozszerzenia SQL Server sterownik ODBC macierzystym klienta. SQL Server Sterownik ODBC macierzysty klient zwraca wszystkie wartości w NumericAttrPtr parametru.Wartości są zwracane jako SDWORD (podpisane długi) z wyjątkiem SQL_CA_SS_COMPUTE_BYLIST, który jest wskaźnik do tablicy słowo.

Identyfikator pola	Wartość zwracana
SQL_CA_SS_COLUMN_HIDDEN *	Wartość TRUE, jeśli odwołanie do kolumna jest częścią ukryte klucz podstawowego, utworzonej w celu obsługi języka Transact-SQL SELECT instrukcja zawierające do PRZEGLĄDANIA.
SQL_CA_SS_COLUMN_ID	Pozycja porządkowa kolumna wynik obliczeń klauzula w bieżącej instrukcja SELECT języka Transact-SQL.
SQL_CA_SS_COLUMN_KEY *	Wartość TRUE, jeśli kolumna odwołuje się do klucz podstawowy dla wiersza i wybierz języka Transact-SQL instrukcja zawiera do PRZEGLĄDANIA.
SQL_CA_SS_COLUMN_OP	Liczba całkowita określająca wartość zagregowana operator odpowiedzialnego za wartość kolumna klauzula obliczeń.Definicje wartości całkowitych są sqlncli.h.
SQL_CA_SS_COLUMN_ORDER	Pozycja porządkowa kolumny ODBC lub języka Transact-SQL SELECT instrukcjaw klauzula ORDER BY.
SQL_CA_SS_COLUMN_SIZE	Maksymalna długość w bajtach, wymagane do pobierania z kolumna do zmiennej SQL_C_BINARY wartości danych.
SQL_CA_SS_COLUMN_SSTYPE	Rodzimy typ danych dane przechowywane kolumna programu SQL Server.Definicje wartości typu są sqlncli.h.
SQL_CA_SS_COLUMN_UTYPE	Typ danych podstawowych typów danych zdefiniowanych przez użytkownika kolumna SQL Server.Definicje wartości typu są sqlncli.h.
SQL_CA_SS_COLUMN_VARYLEN	PRAWDA, jeśli kolumna danych mogą być różne długości, FALSE w przeciwnym.
SQL_CA_SS_COMPUTE_BYLIST	Wskaźnik do tablicy Określanie kolumn używane frazy według klauzula obliczeń programu WORD (niepodpisane krótkiej).klauzula obliczeń nie określa frazę według, zwracana jest wskaźnik NULL. Pierwszy element tablicy zawiera liczbę kolumn listy.Dodatkowe elementy są kolumna liczb porządkowych.
SQL_CA_SS_COMPUTE_ID	computeid wiersza, która jest wynikiem klauzula obliczeń w bieżącej instrukcja SELECT języka Transact-SQL.
SQL_CA_SS_NUM_COMPUTES	Liczba klauzul obliczeń określonych w bieżącej instrukcja SELECT języka Transact-SQL.
SQL_CA_SS_NUM_ORDERS	Liczba kolumn określona w ODBC lub języka Transact-SQL SELECT instrukcjaw klauzula ORDER BY.

* Dostępna jeśli instrukcja ustawiono atrybut SQL_SOPT_SS_HIDDEN_COLUMNS do SQL_HC_ON.

SQL Server 2005 wprowadzono pola deskryptora specyficzne dla sterownika dostarczenie dodatkowych informacji do oznaczenia odpowiednio nazwę kolekcja schematu XML, nazwę schematu i nazwę katalogu.Właściwości te nie wymagają cudzysłowu lub znak anulowania, gdy zawierają znaki alfanumeryczne.W poniższej tabela wymieniono te nowe pola deskryptora:

Nazwa kolumny	Typ	Opis
SQL_CA_SS_XML_SCHEMACOLLECTION_CATALOG_NAME	CharacterAttributePtr	Nazwa katalogu, w którym jest zdefiniowana nazwa kolekcja schematu XML.Jeśli nie można odnaleźć nazwy katalogu, zmienna ta zawiera pusty ciąg. Informacje te są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_CATALOG_NAME IRD, czyli pole odczytu i zapisu.
SQL_CA_SS_XML_SCHEMACOLLECTION_SCHEMA_NAM E	CharacterAttributePtr	Nazwa schematu, w którym jest zdefiniowana nazwa kolekcja schematu XML.Jeśli nie można odnaleźć nazwy schematu, zmienna ta zawiera pusty ciąg. Informacje te są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_SCHEMA_NAME IRD, czyli pole odczytu i zapisu.
SQL_CA_SS_XML_SCHEMACOLLECTION_NAME	CharacterAttributePtr	Nazwa kolekcja schematu XML.Jeśli nie można odnaleźć nazwy, zmienna ta zawiera pusty ciąg. Informacje te są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_NAME IRD, czyli pole odczytu i zapisu.

SQL_CA_SS_XML_SCHEMACOLLECTION_CATALOG_NAME

CharacterAttributePtr

Nazwa katalogu, w którym jest zdefiniowana nazwa kolekcja schematu XML.Jeśli nie można odnaleźć nazwy katalogu, zmienna ta zawiera pusty ciąg.

Informacje te są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_CATALOG_NAME IRD, czyli pole odczytu i zapisu.

SQL_CA_SS_XML_SCHEMACOLLECTION_SCHEMA_NAM E

CharacterAttributePtr

Nazwa schematu, w którym jest zdefiniowana nazwa kolekcja schematu XML.Jeśli nie można odnaleźć nazwy schematu, zmienna ta zawiera pusty ciąg.

Informacje te są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_SCHEMA_NAME IRD, czyli pole odczytu i zapisu.

SQL_CA_SS_XML_SCHEMACOLLECTION_NAME

CharacterAttributePtr

Nazwa kolekcja schematu XML.Jeśli nie można odnaleźć nazwy, zmienna ta zawiera pusty ciąg.

Informacje te są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_NAME IRD, czyli pole odczytu i zapisu.

Ponadto SQL Server 2005 wprowadzone nowe pola deskryptora specyficzne dla sterownika dostarczenie dodatkowych informacji dla jednej kolumna typ zdefiniowany przez użytkownika (UDT) zestaw wyników lub parametrów UDT procedura składowana lub sparametryzowanych kwerend.Właściwości te nie wymagają cudzysłowu lub znak anulowania, gdy zawierają znaki alfanumeryczne.W poniższej tabela wymieniono te nowe pola deskryptora:

Nazwa kolumny	Typ	Opis
SQL_CA_SS_UDT_CATALOG_NAME	CharacterAttributePtr	Nazwa katalogu zawierającego UDT.
SQL_CA_SS_UDT_SCHEMA_NAME	CharacterAttributePtr	Nazwa schematu zawierające UDT.
SQL_CA_SS_UDT_TYPE_NAME	CharacterAttributePtr	Nazwa UDT.
SQL_CA_SS_UDT_ASSEMBLY_TYPE_NAME	CharacterAttributePtr	Nazwa kwalifikowana wirtualny plik dziennika z UDT.

Istniejący identyfikator pole deskryptora SQL_DESC_TYPE_NAME służy do wskazywania nazwy UDT.Pole SQL_DESC_TYPE dla kolumna typu UDT jest SQL_SS_UDT.

Obsługa SQLColAttribute Enhanced Data i czas funkcje

Wartości zwracane dla daty /czas typów, zobacz "Informacji zwracanych w IRD pola" sekcja w Parametr i wynik metadanych.

Aby uzyskać więcej informacji, zobacz Data/Godzina ulepszenia (ODBC).

Obsługa dużych CLR UDTs SQLColAttribute

SQLColAttribute obsługuje duże CLR zdefiniowane przez użytkownika typów (UDTs).Aby uzyskać więcej informacji, zobacz Duże CLR typów zdefiniowanych przez użytkownika (ODBC).