SQLProcedureColumns

Dotyczy:sql Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics

SQLProcedureColumns zwraca jeden wiersz zgłasza atrybuty wartości zwracanej wszystkich procedur składowanych programu SQL Server.

SQLProcedureColumns zwraca wartość SQL_SUCCESS, czy dla parametrów CatalogName, Nazwa schematuProcNamelub Nazwakolumny. SQLFetch zwraca SQL_NO_DATA, gdy w tych parametrach są używane nieprawidłowe wartości.

SQLProcedureColumns można wykonać na kursorze serwera statycznego. Próba wykonania SQLProcedureColumns na kursorze aktualizowalnym (dynamicznym lub kluczowym) zwróci SQL_SUCCESS_WITH_INFO wskazującą, że typ kursora został zmieniony.

W poniższej tabeli wymieniono kolumny zwrócone przez zestaw wyników oraz sposób ich rozszerzenia w celu obsługi udt i xml typów danych za pośrednictwem sterownika ODBC klienta natywnego programu SQL Server:

Nazwa kolumny	Opis
SS_UDT_CATALOG_NAME	Zwraca nazwę katalogu zawierającego udT (typ zdefiniowany przez użytkownika).
SS_UDT_SCHEMA_NAME	Zwraca nazwę schematu zawierającego udT.
SS_UDT_ASSEMBLY_TYPE_NAME	Zwraca kwalifikowaną przez zestaw nazwę UDT.
SS_XML_SCHEMACOLLECTION_CATALOG_NAME	Zwraca nazwę wykazu, w którym zdefiniowano nazwę kolekcji schematów XML. Jeśli nie można odnaleźć nazwy wykazu, ta zmienna zawiera pusty ciąg.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME	Zwraca nazwę schematu, w którym zdefiniowano nazwę kolekcji schematów XML. Jeśli nie można odnaleźć nazwy schematu, ta zmienna zawiera pusty ciąg.
SS_XML_SCHEMACOLLECTION_NAME	Zwraca nazwę kolekcji schematów XML. Jeśli nie można odnaleźć nazwy, ta zmienna zawiera pusty ciąg.

Parametry sqlProcedureColumns i Table-Valued

Funkcja SQLProcedureColumns obsługuje parametry wartości tabeli w sposób podobny do typów zdefiniowanych przez użytkownika środowiska CLR. W wierszach zwracanych dla parametrów wartości tabeli kolumny mają następujące wartości:

Nazwa kolumny	Opis/wartość
DATA_TYPE	SQL_SS_TABLE
TYPE_NAME	Nazwa typu tabeli dla parametru table-valued.
COLUMN_SIZE	ZERO
BUFFER_LENGTH	0
DECIMAL_DIGITS	Liczba kolumn w parametrze wartości tabeli.
NUM_PREC_RADIX	ZERO
NULLABLE	SQL_NULLABLE
UWAGI	ZERO
COLUMN_DEF	ZERO. Typy tabel mogą nie mieć wartości domyślnych.
SQL_DATA_TYPE	SQL_SS_TABLE
SQL_DATETIME_SUB	ZERO
CHAR_OCTET_LENGTH	ZERO
IS_NULLABLE	"TAK"
SS_TYPE_CATALOG_NAME	Zwraca nazwę wykazu, który zawiera tabelę lub typ zdefiniowany przez użytkownika CLR.
SS_TYPE_SCHEMA_NAME	Zwraca nazwę schematu, który zawiera tabelę lub typ zdefiniowany przez użytkownika CLR.

Kolumny SS_TYPE_CATALOG_NAME i SS_TYPE_SCHEMA_NAME są dostępne w programie SQL Server 2008 (10.0.x) i nowszych wersjach, aby zwrócić odpowiednio wykaz i schemat dla parametrów wartości tabeli. Te kolumny są wypełniane dla parametrów wartości tabeli, a także dla parametrów typu zdefiniowanego przez użytkownika CLR. (Istniejące kolumny schematu i katalogu dla parametrów typu zdefiniowanego przez użytkownika clR nie mają wpływu na tę dodatkową funkcjonalność. Są one również wypełniane w celu zachowania zgodności z poprzednimi wersjami).

Zgodnie ze specyfikacją ODBC SS_TYPE_CATALOG_NAME i SS_TYPE_SCHEMA_NAME są wyświetlane przed wszystkimi kolumnami specyficznymi dla sterowników dodanymi w poprzednich wersjach programu SQL Server i po wszystkich kolumnach upoważnionych przez samą funkcję ODBC.

Aby uzyskać więcej informacji na temat parametrów wartości tabeli, zobacz Table-Valued Parameters (ODBC).

Obsługa funkcji SQLProcedureColumns dla rozszerzonych funkcji daty i godziny

Aby uzyskać wartości zwracane dla typów daty/godziny, zobacz metadanych wykazu.

Aby uzyskać więcej ogólnych informacji, zobacz ulepszenia daty i godziny (ODBC).