SQLColumns
SQLColumns zwraca SQL_SUCCESS, czy nie istnieją wartości dla Nazwa_katalogu, Nazwa_tabeli, lub nazwa_kolumny parametry.SQLFetch zwraca SQL_NO_DATA, gdy używane są nieprawidłowe wartości tych parametrów.
Ostrzeżenie
Dla typów dużą wartość zostaną zwrócone wszystkie parametry długość o wartości SQL_SS_LENGTH_UNLIMITED.
SQLColumns mogą być wykonywane na statycznego kursor serwera.Próba wykonać SQLColumns na aktualizowalnego kursor (dynamiczny lub zestawu kluczy) zwróci wartość SQL_SUCCESS_WITH_INFO wskazuje typ kursor została zmieniona.
SQL Server Sterownik ODBC Klient macierzysty obsługuje raportowania informacji dla tabel połączonych serwerach akceptując nazwę dwóch części Nazwa_katalogu parametru: Linked_Server_Name.Catalog_Name.
Dla ODBC 2.x aplikacje nie przy użyciu symboli wieloznacznych w Nazwa_tabeli, SQLColumns zwraca informacje o tabele, których dopasowanie nazwy Nazwa_tabeli i właścicielem jest bieżący użytkownik.Jeśli bieżący użytkownik jest właścicielem nie tabela, którego nazwa odpowiada Nazwa_tabeli parametru SQLColumns zwraca informacje o wszystkich tabel własnością innych użytkowników, jeśli nazwa tabela odpowiada Nazwa_tabeli parametru.Dla ODBC 2.x aplikacji przy użyciu symboli wieloznacznych, SQLColumns zwraca wszystkie tabele, których dopasowanie nazwy Nazwa_tabeli.Dla ODBC 3.x aplikacje SQLColumns zwraca wszystkie tabele, których dopasowanie nazwy Nazwa_tabeli niezależnie od właściciela lub czy używać symboli wieloznacznych.
W poniższej tabela przedstawiono kolumn zwróconych przez zestaw wyników:
Nazwa kolumny |
Opis |
|---|---|
DATA_TYPE |
Zwraca SQL_VARCHAR, SQL_VARBINARY lub SQL_WVARCHAR dla varchar(max) typów danych. |
TYPE_NAME |
Zwraca "varchar", "varbinary" lub "nvarchar" varchar(max), varbinary(max), i nvarchar(max) typów danych. |
COLUMN_SIZE |
Zwraca SQL_SS_LENGTH_UNLIMITED dla varchar(max) danych typów wskazująca, że rozmiar kolumna jest nieograniczona. |
BUFFER_LENGTH |
Zwraca SQL_SS_LENGTH_UNLIMITED dla varchar(max) danych typów wskazująca, że rozmiar buforu jest nieograniczony. |
SQL_DATA_TYPE |
Zwraca SQL_VARCHAR, SQL_VARBINARY lub SQL_WVARCHAR dla varchar(max) typów danych. |
CHAR_OCTET_LENGTH |
Zwraca maksymalną długość kolumna char lub binarne.Zwraca 0, aby wskazać, że rozmiar jest nieograniczona. |
SS_XML_SCHEMACOLLECTION_CATALOG_NAME |
Zwraca nazwę katalogu, gdzie zdefiniowana nazwa kolekcja schematu XML.Jeśli nie można odnaleźć nazwy katalogu, zmienna ta zawiera pusty ciąg. |
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME |
Zwraca nazwę schematu, w którym jest zdefiniowana nazwa kolekcja schematu XML.Jeśli nie można odnaleźć nazwy schematu, zmienna ta zawiera pusty ciąg. |
SS_XML_SCHEMACOLLECTION_NAME |
Zwraca nazwę kolekcja schematu XML.Jeśli nie można odnaleźć nazwy, zmienna ta 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ące UDT. |
SS_UDT_ASSEMBLY_TYPE_NAME |
Nazwa kwalifikowana wirtualny plik dziennika, w UDT. |
Dla UDTs istniejącej kolumna TYPE_NAME jest używany do wskazania nazwy UDT; dlatego nie dodatkowe kolumna dla niego powinny zostać dodane do zestaw wyników SQLColumns lub SQLProcedureColumns.DATA_TYPE kolumna UDT lub parametr jest SQL_SS_UDT.
UDT parametrów, można użyć nowego deskryptory specyficzne dla sterownika, określonych powyżej, aby uzyskać lub zestaw dodatkowe metadane UDT należy serwer zwrotu lub wymagają tych informacji.
Gdy klient łączy się z SQL Server i wywołania SQLColumns, używając wartości NULL lub wieloznaczny dla parametru wejściowego wykazu nie zwróci informacje z innych katalogów.Zamiast tego zostanie zwrócony tylko informacji na temat bieżącego katalogu.Klient może najpierw wywołać SQLTables do określenia, w których wykaz znajduje się odpowiednią tabela.Następnie klient może używać wykazu wartości parametru wejściowego wykazu w jego wywołanie SQLColumns do pobierania informacji o kolumnach w tej tabela.
Parametry oródwierszową i SQLColumns
zestaw wyników Zwrócone przez SQLColumns zależy od ustawienia SQL_SOPT_SS_NAME_SCOPE.Aby uzyskać więcej informacji, zobacz SQLSetStmtAttr.Następujące kolumny zostały dodane do tabela-wycenione parametrów:
Nazwa kolumny |
Typ danych |
Spis treści |
|---|---|---|
SS_IS_COMPUTED |
Smallint |
Kolumny w 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 tożsamości; w przeciwnym razie SQL_FALSE. |
Więcej informacji o tabela-wyceniane parametrów, zobacz Parametry oródwierszową (ODBC).
Obsługa SQLColumns Enhanced Data i czas funkcje
Informacje o wartości zwracane dla daty /czas typów, zobacz Wykaz metadanych.
Aby uzyskać więcej informacji, zobacz Data/Godzina ulepszenia (ODBC).
Obsługa dużych UDTs CLR SQLColumns
SQLColumns 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).
Obsługa rozrzedzania kolumn SQLColumns
Dwa SQL Server kolumny zostały dodane do zestaw wyników dla SQLColumns:
Nazwa kolumny |
Typ danych |
Opis |
|---|---|---|
SS_IS_SPARSE |
Smallint |
Jeśli kolumna jest kolumna rozrzedzona, to jest SQL_TRUE; w przeciwnym razie SQL_FALSE. |
SS_IS_COLUMN_SET |
Smallint |
Jeśli kolumna jest column_set kolumny, to SQL_TRUE; w przeciwnym razie SQL_FALSE. |
Zgodnie ze specyfikacją ODBC SS_IS_SPARSE i SS_IS_COLUMN_SET są wyświetlane przed wszystkie kolumny specyficzne dla sterownika, które zostały dodane do SQL Server wersji starszej niż SQL Server 2008i po wszystkich kolumn nakazanych ODBC sam.
zestaw wyników Zwrócone przez SQLColumns zależy od ustawienia SQL_SOPT_SS_NAME_SCOPE.Aby uzyskać więcej informacji, zobacz SQLSetStmtAttr.
Aby uzyskać więcej informacji o kolumnach sparse ODBC, zobacz Obsługa rozrzedzenia kolumn (ODBC).