Metadata - Parameter en resultaat

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Dit onderwerp beschrijft wat wordt teruggegeven in de velden implementatieparameterdescriptor (IPD) en implementatierijdescriptor (IRD) voor datum- en tijdgegevenstypen.

Informatie teruggegeven in IPD-velden

De volgende informatie wordt teruggegeven in de IPD-velden:

Soms zijn er discontinuïteiten in waardebereik. Bijvoorbeeld, 9 ontbreekt in 8,10..16. Dit komt door de toevoeging van een decimaalteken wanneer breuknauwkeurigheid groter is dan nul.

Datetime2 wordt teruggegeven als typenaam voor smalldatetime en datetime omdat de driver dit als een gemeenschappelijk type gebruikt om alle SQL_TYPE_TIMESTAMP waarden naar de server te verzenden.

SQL_CA_SS_VARIANT_SQL_TYPE is een nieuw beschrijvend veld. Dit veld werd toegevoegd aan de IRD en IPD om applicaties in staat te stellen het waardetype te specificeren dat gekoppeld is aan sqlvariant (SQL_SSVARIANT) kolommen en parameters

SQL_CA_SS_SERVER_TYPE is een nieuw IPD-only veld waarmee applicaties kunnen bepalen hoe waarden voor parameters die gebonden zijn wanneer SQL_TYPE_TYPETIMESTAMP (of als SQL_SS_VARIANT met een C-type SQL_C_TYPE_TIMESTAMP) naar de server worden gestuurd. Als SQL_DESC_CONCISE_TYPE SQL_TYPE_TIMESTAMP is (of SQL_SS_VARIANT is en het C-type SQL_C_TYPE_TIMESTAMP is) wanneer SQLExecute of SQLExecDirect wordt aangeroepen, bepaalt de waarde van SQL_CA_SS_SERVER_TYPE het tabulaire datastroom (TDS) type van de parameterwaarde, als volgt:

De standaardinstelling van SQL_CA_SS_SERVER_TYPE is SQL_SS_TYPE_DEFAULT. De instellingen van SQL_DESC_PRECISION en SQL_DESC_LENGTH worden gevalideerd met de instelling van SQL_CA_SS_SERVER_TYPE zoals beschreven in de bovenstaande tabel. Als deze validatie faalt, wordt SQL_ERROR teruggegeven en wordt een diagnostisch record gelogd met SQLState 07006 en het bericht "Restricted data type attribute violation". Deze fout wordt ook teruggegeven als SQL_CA_SS_SERVER_TYPE is ingesteld op een andere waarde dan SQL_SS_TYPE DEFAULT en DESC_CONCISE_TYPE niet SQL_TYPE_TIMESTAMP. Deze validaties worden uitgevoerd wanneer descriptor-consistentievalidatie plaatsvindt, bijvoorbeeld:

• Wanneer SQL_DESC_DATA_PTR verandert.

• Tijdens de voorbereiding of uitvoering (wanneer SQLExecute, SQLExecDirect, SQLSetPos of SQLBulkOperations wordt aangeroepen).

• Wanneer een applicatie een niet-uitgestelde voorbereiding afdwingt door SQLPrepare aan te roepen met uitgestelde voorbereiding uitgeschakeld, of door SQLNumResultCols, SQLDescribeCol of SQLDescribeParam aan te roepen voor een instructie die voorbereid maar niet wordt uitgevoerd.

Wanneer SQL_CA_SS_SERVER_TYPE wordt ingesteld door een aanroep naar SQLSetDescField, moet de waarde SQL_SS_TYPE_DEFAULT, SQL_SS_TYPE_SMALLDATETIME of SQL_SS_TYPE_DATETIME zijn. Als dit niet het geval is, wordt SQL_ERROR geretourneerd en wordt een diagnostisch record gelogd met SQLState HY092 en het bericht "Invalid attribute/option identifier".

Het attribuut SQL_CA_SS_SERVER_TYPE kan worden gebruikt door applicaties die afhankelijk zijn van functionaliteit die wordt ondersteund door datetime en smalldatetime, maar niet datetime2. Bijvoorbeeld, datetime2 vereist het gebruik van de dateadd- en datediif-functies, terwijl datetime en smalldatetime ook rekenkundige operatoren toestaan. De meeste applicaties hoeven deze eigenschap niet te gebruiken en het gebruik ervan moet worden vermeden.

Informatie teruggegeven in IRD-velden

De volgende informatie wordt teruggegeven in de IRD-velden:

Zie ook

Metadata (ODBC)