Compartilhar via


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)