Partilhar via

SQLSetDescField

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

SQLSetDescField pode ser usado para definir campos de descritor para parâmetros com valor de tabela e colunas de parâmetro com valor de tabela. Para obter informações sobre os campos disponíveis, consulte Campos de descritor de parâmetro com valor de tabela e Campos de descritor para Table-Valued colunas constituintes de parâmetro.

Comentários

As colunas do parâmetro com valor de tabela ficam disponíveis somente quando o campo do cabeçalho do descritor SQL_SOPT_SS_PARAM_FOCUS é definido como o ordinal de um registro que tenha SQL_DESC_TYPE definido como SQL_SS_TABLE. Para obter mais informações sobre SQL_SPOT_SS_PARAM_FOCUS, consulte SQLSetStmtAttr.

Se for feita uma tentativa de definir SQL_SOPT_SS_PARAM_FOCUS para o ordinal de um parâmetro que não seja um parâmetro com valor de tabela, SQLSetStmtAttr retornará SQL_ERROR e um registro de diagnóstico será criado com SQLSTATE = HY024 e a mensagem "Valor de atributo inválido". SQL_SOPT_SS_PARAM_FOCUS não é alterado quando SQL_ERROR é retornado.

A definição de SQL_SOPT_SS_PARAM_FOCUS como 0 restaura o acesso a registros de descritor para parâmetros.

Para obter mais informações sobre parâmetros com valor de tabela, consulte Parâmetros com valor de tabela (ODBC).

Suporte do SQLSetDescField a recursos aprimorados de data e hora

Os recursos de data/hora foram aprimorados no ODBC. Para obter informações sobre o campo de descritor fornecido para os novos tipos de data/hora, consulte Parameter and Result Metadata.

Para obter mais informações, consulte Melhorias de data e hora (ODBC).

Suporte de SQLSetDescField a UDTs grandes do CLR

SQLSetDescField dá suporte a grandes UDTs (tipos definidos pelo usuário) CLR. Para obter mais informações, consulte Tipos de User-Defined clr grandes (ODBC).

Suporte de SQLSetDescField a colunas esparsas

SQLSetDecField pode ser usado para definir SQL_SOPT_SS_NAME_SCOPE no APD (descritor de parâmetro de aplicativo) para os valores SQL_SS_NAME_SCOPE_EXTENDED e SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET.

Para obter mais informações, consulte Suporte a colunas esparsas (ODBC).

Consulte Também

SQLSetDescField
ODBC API Implementation Details