Udostępnij za pośrednictwem

  • Artykuł

SQLColAttribute

Można użyć SQLColAttribute pobrać atrybut zestaw wyników kolumna dla przygotowanych albo wykonywany instrukcji ODBC.Wywołanie SQLColAttribute na przygotowanych instrukcji powoduje, że obie strony w celu SQL Server. The SQL Server Native klient ODBC driver receives zestaw wyników kolumna data as part of instrukcja execution, so calling SQLColAttribute after the completion of SQLExecute or SQLExecDirect does not involve a server roundtrip.

Uwaga

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

Identyfikator pole

Description

SQL_COLUMN_TABLE_NAME

Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE.

SQL_DESC_BASE_COLUMN_NAME

Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE.

SQL_DESC_BASE_TABLE_NAME

Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE.

SQL_DESC_CATALOG_NAME

Nazwa bazy danych.Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE.

SQL_DESC_LABEL

Dostępna dla wszystkich zestawów wyników.Wartość jest taka sama, jak wartość pole SQL_DESC_NAME.

To pole ma zerową długość tylko wtedy, gdy kolumna ma być wynikiem wyrażenia i wyrażenie nie zawiera przypisania etykiety.

SQL_DESC_NAME

Dostępna dla wszystkich zestawów wyników.Wartość jest taka sama, jak wartość pole SQL_DESC_LABEL.

To pole ma zerową długość tylko wtedy, gdy kolumna ma być wynikiem wyrażenia i wyrażenie nie 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 wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE.

Opcja dostępna 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 wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE.

SQL_DESC_UNNAMED

SQL_NAMED dla wszystkich kolumn w zestaw wyników, chyba że kolumna jest wynik wyrażenie, która nie zawiera przypisania etykietę jako część wyrażenie.Gdy SQL_DESC_UNNAMED zwraca SQL_UNNAMED, wszystkie atrybuty identyfikatora kolumna ODBC zawierają zera ciągi znaków o długości kolumna.

SQL Server Macierzysty sterownik ODBC klient używa instrukcja zestaw FMTONLY zmniejszyć obciążenie serwera podczas SQLColAttribute jest wywoływana dla gotowe, ale unexecuted instrukcja.

W przypadku typów duża wartość SQLColAttribute będzie zwracać następujące wartości:

Identyfikator pole

Opis zmiany

SQL_DESC_DISPLAY_SIZE

Jest to maksymalna liczba znaków, wymaganych do wyświetlania danych z kolumna.W przypadku kolumn typu dużą wartość wartość zwracana jest SQL_SS_LENGTH_UNLIMITED.

SQL_DESC_LENGTH

Zwraca wartość rzeczywistej długości kolumna zestaw wyników.W przypadku kolumn typu dużą wartość wartość zwracana jest SQL_SS_LENGTH_UNLIMITED.

SQL_DESC_OCTET_LENGTH

Zwraca maksymalną długość kolumna typu dużą wartość.SQL_SS_LENGTH_UNLIMITED służy do wskazywania nieograniczony rozmiar.

SQL_DESC_PRECISION

Zwraca wartość SQL_SS_LENGTH_UNLIMITED dla kolumn typu dużą wartość.

SQL_DESC_TYPE

Zwraca SQL_VARCHAR i SQL_WVARCHAR SQL_VARBINARY typów dużych wartości.

SQL_DESC_TYPE_NAME

Zwraca "varchar", "varbinarnym", "nvarchar" dla typów dużych wartości.

Atrybuty kolumna są raportowane dla wszystkich wersji jedynie pierwszego wyniku ustawić, gdy wiele zestawów wyników są generowane przez partia przygotowanych instrukcji SQL.

Następujące atrybuty kolumna są udostępniane przez rozszerzenia SQL Server Macierzysty sterownik ODBC klient. The SQL Server Native klient ODBC driver returns all values in the NumericAttrPtr parameter.Wartości są zwracane w postaci SDWORD (podpisane długi) z wyjątkiem SQL_CA_SS_COMPUTE_BYLIST, która jest wskaźnik na tablicy WORD.

Identyfikator pole

Wartość zwracana

SQL_CA_SS_COLUMN_HIDDEN *

Ma wartość TRUE, jeśli kolumna, do którego odwołuje się jest częścią ukryte klucz podstawowy, utworzonej w celu obsługi instrukcja języka Transact-SQL SELECT z zawierające FOR BROWSE.

SQL_CA_SS_COLUMN_ID

Pozycja porządkowa kolumna COMPUTE klauzula wyników w bieżącym instrukcję SELECT języka Transact-SQL.

SQL_CA_SS_COLUMN_KEY *

Ma wartość TRUE, jeśli kolumna, do którego odwołuje się jest częścią klucz podstawowy dla wiersza, a instrukcja języka Transact-SQL SELECT zawiera FOR BROWSE.

SQL_CA_SS_COLUMN_OP

Liczba całkowita, określająca agregacja operator odpowiedzialny za wartość kolumna klauzula COMPUTE.Definicje wartości całkowitych są sqlncli.h.

SQL_CA_SS_COLUMN_ORDER

Pozycja porządkowa kolumna w klauzula ORDER BY instrukcja ODBC lub języka Transact-SQL SELECT.

SQL_CA_SS_COLUMN_SIZE

Maksymalna długość w bajtach, wymagane do powiązania pobierania z kolumna do zmiennej SQL_C_BINARY wartości danych.

SQL_CA_SS_COLUMN_SSTYPE

Typ macierzysty danych dane przechowywane kolumna programu SQL Server.Definicje wartości typu są sqlncli.h.

SQL_CA_SS_COLUMN_UTYPE

podstawowy typ danych typów danych zdefiniowanych przez użytkownika kolumna's programu SQL Server.Definicje wartości typu są sqlncli.h.

SQL_CA_SS_COLUMN_VARYLEN

Ma wartość TRUE, jeśli dane mogą być różne długości FAŁSZ inaczej.

SQL_CA_SS_COMPUTE_BYLIST

Wskaźnik do tabeli programu WORD (bez znaku krótkiej) określający kolumny używane we frazie BY klauzula COMPUTE.Jeśli klauzula COMPUTE nie określono frazę BY, zwracana jest wskaźnik o wartości NULL.

Pierwszy element tablicy zawiera liczbę, BY kolumn listy.Liczebniki porządkowe kolumna są dodatkowe elementy.

SQL_CA_SS_COMPUTE_ID

computeid wiersza, która jest wynikiem klauzula COMPUTE w bieżącej instrukcja SELECT języka Transact-SQL.

SQL_CA_SS_NUM_COMPUTES

Liczba określona w bieżącej instrukcja SELECT języka Transact-SQL klauzul COMPUTE.

SQL_CA_SS_NUM_ORDERS

Liczba kolumn określonych w klauzula ORDER BY instrukcja ODBC lub języka Transact-SQL SELECT.

* Dostępny, jeśli ustawiono atrybut instrukcja SQL_SOPT_SS_HIDDEN_COLUMNS SQL_HC_ON.

SQL Server 2005 wprowadzony deskryptora specyficzne dla sterownika pola, które zawierają dodatkowe informacje, które odpowiednio oznaczają nazwę kolekcja schematu XML, nazwę schematu i nazwę katalogu.Właściwości te nie wymagają cudzysłowu lub znak anulowania, gdy występują znaki inne niż alfanumeryczne.W poniższej tabela przedstawiono te nowe pola deskryptora:

Nazwa kolumna

Typ

Description

SQL_CA_SS_XML_SCHEMACOLLECTION_CATALOG_NAME

CharacterAttributePtr

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

W tym wypadku informacje są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_CATALOG_NAME IRD, które jest pole w trybie do odczytu i zapisu.

SQL_CA_SS_XML_SCHEMACOLLECTION_SCHEMA_NAM E

CharacterAttributePtr

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

W tym wypadku informacje są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_SCHEMA_NAME IRD, które jest pole w trybie do odczytu i zapisu.

SQL_CA_SS_XML_SCHEMACOLLECTION_NAME

CharacterAttributePtr

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

W tym wypadku informacje są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_NAME IRD, które jest pole w trybie do odczytu i zapisu.

Ponadto SQL Server 2005 wprowadzono nowe pola deskryptora specyficzne dla sterownika jest zapewnienie dodatkowych informacji dla jednej kolumna typ zdefiniowany przez użytkownika (UDT) zestaw wyników lub parametrów UDT procedur przechowywanych lub sparametryzowanych kwerend. Właściwości te nie wymagają cudzysłowu lub znak anulowania, gdy występują znaki inne niż alfanumeryczne.W poniższej tabela przedstawiono te nowe pola deskryptora:

Nazwa kolumna

Typ

Description

SQL_CA_SS_UDT_CATALOG_NAME

CharacterAttributePtr

Nazwa katalogu zawierającego UDT.

SQL_CA_SS_UDT_SCHEMA_NAME

CharacterAttributePtr

Nazwa schematu, zawierającą 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 Data rozszerzony i czas funkcje

Wartości zwracane dla typu Data/Godzina można znaleźć w sekcji "Informacje o zwrot w IRD pola" w Parametr i wynik metadane.

Aby uzyskać więcej informacji zobaczData / czas ulepszenia (ODBC).

Obsługa SQLColAttribute duże UDTs CLR

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

Obsługa SQLColAttribute odstępem kolumny

SQLColAttribute pole nowego deskryptora wiersza implementacji (IRD) kwerendy, SQL_CA_SS_IS_COLUMN_SET, aby określić, czy kolumna jest column_set Kolumna.

Aby uzyskać więcej informacji zobaczObsługa rozrzedzenia kolumny (ODBC).