Metadados adicionais de parâmetros com valor de tabela
Aplica-se a:
SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)
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. Essa alteração foi feita quando o suporte unicode foi adicionado à especificação ODBC 3.5, mas não foi explicitamente chamado.
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.