SQLProcedureColumns

Artykuł
12/19/2024

Dotyczy:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

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).