Metadata - Parameter och resultat

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Detta ämne beskriver vad som returneras i fälten för implementeringsparameterbeskrivare (IPD) och implementeringsradbeskrivare (IRD) för datum- och tidsdatatyper.

Information som returneras i IPD-fält

Följande information returneras i IPD-fälten:

Ibland finns det diskontinuiteter i värdeintervallen. Till exempel saknas 9 i 8,10..16. Detta beror på att en decimalpunkt läggs till när bråkprecisionen är större än noll.

datetime2 returneras som typnamn för smalldatetime och datetime eftersom drivrutinen använder detta som en gemensam typ för att överföra alla SQL_TYPE_TIMESTAMP värden till servern.

SQL_CA_SS_VARIANT_SQL_TYPE är ett nytt beskrivande fält. Detta fält lades till i IRD och IPD för att göra det möjligt för applikationer att specificera värdetypen associerad med sqlvariant (SQL_SSVARIANT) kolumner och parametrar

SQL_CA_SS_SERVER_TYPE är ett nytt IPD-enbart fält som gör det möjligt för applikationer att kontrollera hur värden för parametrar bundna när SQL_TYPE_TYPETIMESTAMP (eller som SQL_SS_VARIANT med en C-typ SQL_C_TYPE_TIMESTAMP) skickas till servern. Om SQL_DESC_CONCISE_TYPE är SQL_TYPE_TIMESTAMP (eller är SQL_SS_VARIANT och C-typen är SQL_C_TYPE_TIMESTAMP) när SQLExecute eller SQLExecDirect anropas, bestämmer värdet av SQL_CA_SS_SERVER_TYPE den tabellariska dataströmstypen (TDS) för parametervärdet, enligt följande:

Standardinställningen för SQL_CA_SS_SERVER_TYPE är SQL_SS_TYPE_DEFAULT. Inställningarna för SQL_DESC_PRECISION och SQL_DESC_LENGTH valideras med inställningen SQL_CA_SS_SERVER_TYPE som beskrivs i tabellen ovan. Om denna validering misslyckas returneras SQL_ERROR och en diagnostisk post loggas med SQLState 07006 och meddelandet "Restricted data type attribute violation". Detta fel returneras också om SQL_CA_SS_SERVER_TYPE är satt till ett annat värde än SQL_SS_TYPE DEFAULT och DESC_CONCISE_TYPE inte är SQL_TYPE_TIMESTAMP. Dessa valideringar utförs när beskrivande konsistensvalidering sker, till exempel:

• När SQL_DESC_DATA_PTR ändras.

• Vid förberedelse- eller exekveringstider (när SQLExecute, SQLExecDirect, SQLSetPos eller SQLBulkOperations anropas).

• När en applikation tvingar fram en icke-uppskjuten förberedelse genom att anropa SQLPrepare med deferred prepare inaktiverat, eller genom att anropa SQLNumResultCols, SQLDescribeCol eller SQLDescribeParam för en sats som är förberedd men inte exekverad.

När SQL_CA_SS_SERVER_TYPE sätts av ett anrop till SQLSetDescField måste dess värde vara SQL_SS_TYPE_DEFAULT, SQL_SS_TYPE_SMALLDATETIME eller SQL_SS_TYPE_DATETIME. Om så inte är fallet returneras SQL_ERROR och en diagnostisk post loggas med SQLState HY092 och meddelandet "Invalid attribute/option identifier".

Attributet SQL_CA_SS_SERVER_TYPE kan användas av applikationer som är beroende av funktionalitet som stöds av datetime och smalldatetime, men inte datetime2. Till exempel kräver datetime2 användning av dateadd- och datediif-funktionerna , medan datetime och smalldatetime också tillåter aritmetiska operatorer. De flesta applikationer behöver inte använda denna egenskap och dess användning bör undvikas.

Information som återlämnas i IRD-fält

Följande information återges i IRD-fälten:

Se även

Metadata (ODBC)