SQLSetDescRec

Si applica a:SQL ServerDatabase SQL diAzure Istanzagestita di SQL di Azure Azure Synapse Analytics PlatformSystem (PDW)

Questo argomento illustra la funzionalità SQLSetDescRec specifica di SQL Server Native Client.

SQLSetDescRec e parametri con valori di tabella

SQLSetDescRec può essere usato per impostare i campi del descrittore per i parametri con valori di tabella e le colonne dei parametri con valori di tabella. Le colonne dei parametri con valori di tabella sono disponibili solo quando il campo di intestazione di descrizione SQL_SOPT_SS_PARAM_FOCUS è impostato sul numero ordinale di un record in cui SQL_DESC_TYPE è impostato su SQL_SS_TABLE. Per ulteriori informazioni su SQL_SOPT_SS_PARAM_FOCUS, vedere SQLSetStmtAttr.

Nella tabella seguente viene descritto il mapping tra parametri e campi di descrizione.

Parametro Attributo correlato per i tipi di parametri non con valori di tabella, incluse le colonne dei parametri con valori di tabella Attributo correlato per i parametri con valori di tabella
Tipo SQL_DESC_TYPE SQL_SS_TABLE
Sottotipo Ignorato Per i record di tipo SQL_DATETIME o SQL_INTERVAL, impostare su SQL_DESC_DATETIME_INTERVAL_CODE.
Lunghezza SQL_DESC_OCTET_LENGTH Lunghezza del nome del tipo di parametro con valori di tabella. Può essere SQL_NTS, se il nome del tipo è con terminazione Null oppure zero se il nome del tipo di parametro con valori di tabella non è obbligatorio.
Precisione SQL_DESC_PRECISION SQL_DESC_ARRAY_SIZE
Ridimensiona SQL_DESC_SCALE Non utilizzato. Questo parametro deve essere zero.
DataPtr SQL_DESC_DATA_PTR in APD SQL_CA_SS_TYPE_NAME

Questo parametro è facoltativo per le chiamate di stored procedure ed è possibile specificare NULL se non è obbligatorio. È necessario specificarlo per istruzioni SQL che non sono chiamate di procedure.

DataPtr funge anche da valore univoco che l'applicazione può usare per identificare questo parametro con valori di tabella quando viene usata l'associazione di righe variabile.
StringLengthPtr SQL_DESC_OCTET_LENGTH_PTR SQL_DESC_OCTET_LENGTH_PTR

Per un parametro con valori di tabella, è il numero di righe da trasferire o SQL_DATA_AT_EXEC.SQL_DATA_AT_EXEC. Si tratta di un puntatore a un valore che contiene il numero di righe da trasferire con SQLExecDirect.
IndicatorPtr SQL_DESC_INDICATOR_PTR SQL_DESC_INDICATOR_PTR

Per altre informazioni sui parametri con valori di tabella, vedere Parametri con valori di tabella (ODBC).

Supporto di SQLSetDescRec per le caratteristiche avanzate di data e ora

I valori consentiti per i tipi di data/ora sono i seguenti:

Attributo Tipo Sottotipo Lunghezza Precisione Ridimensiona
datetime SQL_DATETIME SQL_CODE_TIMESTAMP 4 3 3
smalldatetime SQL_SQL_DATETIME SQL_CODE_TIMESTAMP 8 0 0
date SQL_DATETIME SQL_CODE_DATE 6 0 0
time SQL_SS_TIME2 0 10 0..7 0..7
datetime2 SQL_DATETIME SQL_CODE_TIMESTAMP 16 0..7 0..7
datetimeoffset SQL_SS_TIMESTAMPOFFSET 0 20 0..7 0..7

Per altre informazioni, vedere Miglioramenti di data e ora (ODBC).

Supporto di SQLSetDescRec per tipi definiti dall'utente CLR di grandi dimensioni

SQLSetDescRec supporta tipi CLR definiti dall'utente di grandi dimensioni. Per altre informazioni, vedere Tipi CLR definiti dall'utente (ODBC) di grandi dimensioni.

Vedi anche

SQLSetDescRec
Dettagli di implementazione dell'API ODBC