Metadados adicionais de parâmetros com valor de tabela

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Para recuperar metadados para um parâmetro com valor de tabela, um aplicativo chama SQLProcedureColumns. Para um parâmetro com valor de tabela, SQLProcedureColumns retorna uma única linha. Duas colunas adicionais específicas do SQL Server, SS_TYPE_CATALOG_NAME e SS_TYPE_SCHEMA_NAME, foram adicionadas para fornecer informações de esquema e catálogo para tipos de tabela associados a parâmetros com valor de tabela. Em conformidade com a especificação ODBC, SS_TYPE_CATALOG_NAME e SS_TYPE_SCHEMA_NAME aparecem antes de todas as colunas específicas do driver adicionadas em versões anteriores do SQL Server e depois de todas as colunas exigidas pelo próprio ODBC.

A tabela a seguir lista as colunas significativas para parâmetros com valor de tabela.

Nome da coluna	Tipo de dados	Valor/comentários
DATA_TYPE	Smallint não NULL	SQL_SS_TABLE
TYPE_NAME	WVarchar(128) não NULL	O nome do tipo do parâmetro com valor de tabela.
COLUMN_SIZE	Inteiro	NULO
BUFFER_LENGTH	Inteiro	0
DECIMAL_DIGITS	Smallint	NULO
NUM_PREC_RADIX	Smallint	NULO
NULLABLE	Smallint não NULL	SQL_NULLABLE
COMENTÁRIOS	Varchar	NULO
COLUMN_DEF	WVarchar(4000)	NULO
SQL_DATA_TYPE	Smallint não NULL	SQL_SS_TABLE
SQL_DATETIME_SUB	Smallint	NULO
CHAR_OCTET_LENGTH	Inteiro	NULO
ORDINAL_POSITION	Integer não NULL	A posição ordinal do parâmetro.
IS_NULLABLE	Varchar	"YES"
SS_TYPE_CATALOG_NAME	WVarchar(128) não NULL	O catálogo que contém a definição de tipo do tipo de tabela do parâmetro com valor de tabela.
SS_TYPE_SCHEMA_NAME	WVarchar(128) não NULL	O esquema que contém a definição de tipo do tipo de tabela do parâmetro com valor de tabela.

As colunas WVarchar são definidas como Varchar na especificação ODBC, mas na verdade são retornadas como WVarchar em todos os drivers ODBC recentes do SQL Server. Esta alteração foi feita quando o suporte a Unicode foi adicionado à especificação de ODBC 3.5, mas não chamado explicitamente.

Para obter metadados adicionais para parâmetros com valor de tabela, um aplicativo usa as funções de catálogo SQLColumns e SQLPrimaryKeys. Antes de essas funções serem chamadas para parâmetros com valor de tabela, o aplicativo deve definir o atributo de instrução SQL_SOPT_SS_NAME_SCOPE como SQL_SS_NAME_SCOPE_TABLE_TYPE. Esse valor indica que o aplicativo exige metadados para um tipo de tabela em lugar de uma tabela real. Em seguida, o aplicativo passa o TYPE_NAME do parâmetro com valor de tabela como o parâmetro TableName . SS_TYPE_CATALOG_NAME e SS_TYPE_SCHEMA_NAME são usados com os parâmetros CatalogName e SchemaName Quando um aplicativo concluir a recuperação de metadados para parâmetros com valor de tabela, ele deve definir SQL_SOPT_SS_NAME_SCOPE novamente com seu valor padrão SQL_SS_NAME_SCOPE_TABLE.

Quando SQL_SOPT_SS_NAME_SCOPE for definido como SQL_SS_NAME_SCOPE_TABLE, as consultas a servidores vinculados irão falhar. As chamadas para SQLColumns ou SQLPrimaryKeys com um catálogo que contém um componente de servidor falharão.

Confira também

Parâmetros com valor de tabela (ODBC)