Udostępnij za pośrednictwem

  • Artykuł

SQLColumns

SQLColumns zwraca SQL_SUCCESS niezależnie od tego, czy istnieją wartości dla Nazwa_katalogu, TableName, or Element ColumnName parametry.SQLFetch zwraca SQL_NO_DATA użyto nieprawidłowych wartości w tych parametrów.

Uwaga

Dla typów dużą wartość zostaną zwrócone wszystkie parametry długości z wartością SQL_SS_LENGTH_UNLIMITED.

SQLColumns mogą być wykonywane na kursor statycznych serwera.Próba wykonać SQLColumns na aktualizowalnego kursor (dynamicznie lub zestaw kluczy) zwróci SQL_SUCCESS_WITH_INFO wskazujący, że typ kursor zmieniła się.

The SQL Server Native klient ODBC driver supports reporting information for tables on linked servers by accepting a two-part name for the CatalogName parameter: Linked_Server_Name.Catalog_Name.

Dla ODBC 2. x aplikacji nie przy użyciu symboli wieloznacznych TableName, SQLColumns zwraca informacje o wszystkich tabel, których nazwy odpowiadają TableName i są własnością bieżącego użytkownika.Jeśli których właścicielem jest bieżący użytkownik nie tabela, którego nazwa odpowiada TableName parametrSQLColumns zwraca informacje o wszystkich tabel, będących własnością innych użytkowników, jeśli nazwa tabela odpowiada TableName parametr.Dla ODBC 2. x aplikacji przy użyciu symboli wieloznacznych, SQLColumns zwraca wszystkie tabele, których nazwy odpowiadają TableName.Dla ODBC 3. x aplikacje SQLColumns zwraca wszystkie tabele, których nazwy odpowiadają TableName niezależnie od właściciela i od tego, czy używane są symbole wieloznaczne.

Poniższa tabela zawiera listę kolumn zwracanych przez zestaw wyników:

Nazwa kolumna

Description

DATA_TYPE

Zwraca SQL_VARCHAR i SQL_VARBINARY SQL_WVARCHAR dla varchar(max) typów danych.

TYPE_NAME

Zwraca “ varchar ”, “ varbinarnym ” lub “ nvarchar ” varchar(max), varbinary(max), and nvarchar(max) typów danych.

COLUMN_SIZE

Zwraca SQL_SS_LENGTH_UNLIMITED dla varchar(max) typy danych, co oznacza, że rozmiar kolumna jest nieograniczona.

BUFFER_LENGTH

Zwraca SQL_SS_LENGTH_UNLIMITED dla varchar(max) typy danych, co oznacza, że rozmiar buforu jest nieograniczony.

SQL_DATA_TYPE

Zwraca SQL_VARCHAR i SQL_VARBINARY SQL_WVARCHAR dla varchar(max) typów danych.

CHAR_OCTET_LENGTH

Zwraca maksymalną długość kolumna typu char lub binarny.Zwraca wartość 0 oznacza, że rozmiar jest nieograniczona.

SS_XML_SCHEMACOLLECTION_CATALOG_NAME

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

SS_XML_SCHEMACOLLECTION_SCHEMA_NAME

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

SS_XML_SCHEMACOLLECTION_NAME

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

SS_UDT_CATALOG_NAME

Nazwa katalogu zawierającego UDT (typ zdefiniowany przez użytkownika).

SS_UDT_SCHEMA_NAME

Nazwa schematu, zawierającą UDT.

SS_UDT_ASSEMBLY_TYPE_NAME

Nazwa kwalifikowana wirtualny plik dziennika UDT.

UDTs istniejącej kolumna TYPE_NAME służy do wskazywania nazwy UDT; w związku z tym nie dodatkowych kolumn dla niego powinny zostać dodane do zestaw wyników SQLColumns or SQLProcedureColumns.DATA_TYPE UDT kolumna lub parametr jest SQL_SS_UDT.

Dla UDT parametrów można użyć nowego deskryptory specyficzne dla sterownika określonego powyżej, aby uzyskać lub ustawić właściwości dodatkowe metadane UDT, należy na serwerze zwracają lub wymagają tych informacji.

Kiedy klient łączy się z SQL Server i wywołań SQLColumns, przy użyciu wartości NULL lub wieloznaczny do parametru wejściowego wykazu nie spowoduje zwrócenie informacji z innych katalogów. Zamiast tego zostaną zwrócone jedynie informacje dotyczące bieżącego katalogu.Klient może najpierw wywołać SQLTables Aby ustalić, w których wykaz znajduje się żądanej tabela. Klient można użyć tej wartości katalogu parametr wejściowy katalog, w jego wywołaniu SQLColumns Aby pobrać informacje o kolumnach w tej tabela.

SQLColumns i parametry Valued tabela

Zestaw wyników zwróconych przez SQLColumns zależy od ustawienia SQL_SOPT_SS_NAME_SCOPE. Aby uzyskać więcej informacji zobaczSQLSetStmtAttr.Wartości w tabela parametrów zostały dodane w następujących kolumnach:

Nazwa kolumna

Typ danych

Spis treści

SS_IS_COMPUTED

Smallint

W kolumnie TABLE_TYPE, jest to SQL_TRUE, jeśli kolumna jest kolumna obliczana; w przeciwnym razie SQL_FALSE.

SS_IS_IDENTITY

Smallint

SQL_TRUE, jeśli kolumna kolumna tożsamości; w przeciwnym razie SQL_FALSE.

Aby uzyskać więcej informacji na temat parametrów wycenione tabela zobacz Tabela Valued parametry (ODBC).

Obsługa SQLColumns Data rozszerzony i czas funkcje

Aby uzyskać informacje dotyczące wartości zwracane dla daty / czas typów, zobacz Katalogowanie metadane.

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

Obsługa dużych UDTs CLR SQLColumns

SQLColumns 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 SQLColumns odstępem kolumny

Dwa SQL Server kolumny zostały dodane do zestaw dla wyników SQLColumns:

Nazwa kolumna

Typ danych

Description

SS_IS_SPARSE

Smallint

Jeżeli kolumna jest kolumna rozrzedzona, to SQL_TRUE; w przeciwnym wypadku SQL_FALSE.

SS_IS_COLUMN_SET

Smallint

Jeżeli kolumna jest column_set Kolumna, jest to SQL_TRUE; w przeciwnym wypadku SQL_FALSE.

Zgodnie ze specyfikacją ODBC SS_IS_SPARSE i SS_IS_COLUMN_SET pojawiają się przed wszystkie kolumny specyficzne dla sterownika, które zostały dodane do SQL Server wersje wcześniejsze niż SQL Server 2008, a po wszystkich kolumnach upoważnionych przez ODBC sam.

Zestaw wyników zwróconych przez SQLColumns zależy od ustawienia SQL_SOPT_SS_NAME_SCOPE. Aby uzyskać więcej informacji zobaczSQLSetStmtAttr.

Aby uzyskać więcej informacji na temat kolumn sparse w ODBC zobacz Obsługa rozrzedzenia kolumny (ODBC).