Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Para instruções executadas, o driver ODBC do SQL Server Native Client não precisa consultar o servidor para descrever colunas em um conjunto de resultados. Nesse caso, SQLDescribeCol não causa uma viagem de ida e volta do servidor. Assim como SQLColAttribute, chamar SQLDescribeCol instruções preparadas, mas não executadas, gera uma viagem de ida e volta do servidor.
Quando uma instrução Transact-SQL ou um lote de instrução retorna vários conjuntos de linhas de resultados, é possível que uma coluna, referenciada por ordinal, seja originada em uma tabela separada ou se refira a uma coluna totalmente diferente no conjunto de resultados.
SQLDescribeCol deve ser chamado para cada conjunto. Quando o conjunto de resultados é alterado, o aplicativo deve rebinar valores de dados antes de buscar os resultados da linha. Para obter mais informações sobre como lidar com vários retornos do conjunto de resultados, consulte SQLMoreResults.
Os atributos de coluna são relatados apenas para o primeiro conjunto de resultados quando vários conjuntos de resultados são gerados por um lote preparado de instruções SQL.
Para tipos de dados de valor grande, o valor retornado em DataTypePtr é SQL_VARCHAR, SQL_VARBINARY ou SQL_NVARCHAR. Um valor de SQL_SS_LENGTH_UNLIMITED em ColumnSizePtr indica que o tamanho é "ilimitado".
Melhorias no mecanismo de banco de dados a partir do SQL Server 2012 permitem que o SQLDescribeCol obtenha descrições mais precisas dos resultados esperados. Esses resultados mais precisos podem ser diferentes dos valores retornados por SQLDescribeCol em versões anteriores do SQL Server. Para obter mais informações, consulte a Descoberta de Metadados.
Suporte do SQLDescribeCol para recursos avançados de data e hora
Os valores retornados para tipos de data/hora são os seguintes:
| DataTypePtr | ColumnSizePtr | DecimalDigitsPtr | |
|---|---|---|---|
| Data e hora | SQL_TIPO_TIMESTAMP | vinte e três | 3 |
| smalldatetime | SQL_TIPO_TIMESTAMP | 16 | 0 |
| data | SQL_TYPE_DATE | 10 | 0 |
| Hora | SQL_SS_TIME2 | 8, 10..16 | 0..7 |
| `datetime2` | SQL_TIPO_TIMESTAMP | 19, 21..27 | 0..7 |
| datetimeoffset | SQL_SS_TIMESTAMPOFFSET | 26, 28..34 | 0..7 |
Para obter mais informações, consulte Melhorias de data e hora (ODBC).
Suporte a SQLDescribeCol para UDTs CLR grandes
SQLDescribeCol dá suporte a UDTs (tipos definidos pelo usuário) CLR grandes. Para obter mais informações, consulte ODBC (Tipos Definidos pelo Usuário) CLR Grandes.
Consulte Também
Função SQLDescribeCol
Detalhes da implementação da API do ODBC