Table-Valued Metadane parametrów dla przygotowanych instrukcji

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Aplikacja może uzyskać metadane przygotowanego wywołania procedury za pomocą SQLNumParams i SQLDescribeParam. Dla parametrów tabelowych DataTypePtr jest ustawiony na SQL_SS_TABLE. Dodatkowe metadane są dostępne za pośrednictwem SQLGetDescField dla SQL_CA_SS_TYPE_NAME, SQL_CA_SS_CATALOG_NAME i SQL_CA_SS_SCHEMA_NAME.

SQL_CA_SS_TYPE_NAME, SQL_CA_SS_CATALOG_NAME i SQL_CA_SS_SCHEMA_NAME mogą być używane z SQLColumns do uzyskania metadanych kolumnowych dla typów tabel powiązanych z parametrami tabelowymi. W takim przypadku SQL_SOPT_SS_NAME_SCOPE musi być ustawione na SQL_SS_NAME_SCOPE_TABLE_TYPE przed wywołaniem SQLColumns. SQL_SOPT_SS_NAME_SCOPE powinno być następnie przywrócone do wartości domyślnej, SQL_SS_NAME_SCOPE_TABLE, gdy aplikacja zakończy pobieranie metadanych kolumn parametrów o wartościach tabelowych.

SQL_CA_SS_TYPE_NAME, SQL_CA_SS_CATALOG_NAME i SQL_CA_SS_SCHEMA_NAME mogą być również używane z parametrami typów zdefiniowanych przez użytkownika CLR.

Nie można uzyskać metadanych parametrów tabelowych dla przygotowanych instrukcji, które nie są przechowywanymi wywołaniami procedur. Jeśli spróbujesz to zrobić, aplikacja zwraca SQL_ERROR z SQLSTATE 42000 i komunikatem "Syntax error or access violation".