Metadaten: Parameter und Ergebnis

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

In diesem Thema wird beschrieben, was in den IPD- und IRD-Feldern (Implementierungsparameterdeskriptor, Implementierungszeilendeskriptor) für Datums- und Uhrzeitdatentypen zurückgegeben wird.

In IPD-Feldern zurückgegebene Informationen

Die folgenden Informationen werden in den IPD-Feldern zurückgegeben:

Parametertyp	date	time	smalldatetime	datetime	datetime2	datetimeoffset
SQL_DESC_CASE_SENSITIVE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE
SQL_DESC_CONCISE_TYPE	SQL_TYPE_DATE	SQL_SS_TIME2	SQL_TYPE_TIMESTAMP	SQL_TYPE_TIMESTAMP	SQL_TYPE_TIMESTAMP	SQL_SS_TIMESTAMPOFFSET
SQL_DESC_DATETIME_INTERVAL_CODE	SQL_CODE_DATE	0	SQL_CODE_TIMESTAMP	SQL_CODE_TIMESTAMP	SQL_CODE_TIMESTAMP	0
SQL_DESC_DATETIME_INTERVAL_PRECISION	10	8,10..16	16	23	19, 21..27	26, 28..34
SQL_DESC_FIXED_PREC_SCALE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE
SQL_DESC_LENGTH	10	8,10..16	16	23	19, 21..27	26, 28..34
SQL_DESC_OCTET_LENGTH	6	12	4	8	16	20
SQL_DESC_PRECISION	0	0..7	0	3	0..7	0..7
SQL_DESC_SCALE	0	0..7	0	3	0..7	0..7
SQL_DESC_TYPE	SQL_TYPE_DATE	SQL_SS_TYPE_TIME2	SQL_DATETIME	SQL_DATETIME	SQL_DATETIME	SQL_SS_TIMESTAMPOFFSET
SQL_DESC_TYPE_NAME	date	time	smalldatetime in IRD, datetime2 in IPD	datetime in IRD, datetime2 in IPD	datetime2	datetimeoffset
SQL_CA_SS_VARIANT_TYPE	SQL_C_TYPE_DATE	SQL_C_TYPE_BINARY	SQL_C_TYPE_TIMESTAMP	SQL_C_TYPE_TIMESTAMP	SQL_C_TYPE_TIMESTAMP	SQL_C_TYPE_BINARY
SQL_CA_SS_VARIANT_SQL_TYPE	SQL_TYPE_DATE	SQL_SS_TIME2	SQL_TYPE_TIMESTAMP	SQL_TYPE_TIMESTAMP	SQL_TYPE_TIMESTAMP	SQL_SS_TIMESTAMPOFFSET
SQL_CA_SS_SERVER_TYPE	–	–	SQL_SS_TYPE_SMALLDATETIME	SQL_SS_TYPE_DATETIME	SQL_SS_TYPE_DEFAULT	–

Manchmal treten in Wertbereichen Diskontinuitäten auf. Zum Beispiel fehlt 9 in der Angabe 8,10..16. Der Grund dafür ist das Hinzufügen eines Dezimaltrennzeichens, wenn die Genauigkeit von Bruchteilen größer als 0 (NULL) ist.

datetime2 wird als Typname für smalldatetime und datetime zurückgegeben, da der Treiber diesen als gemeinsamen Typ zum Übertragen aller SQL_TYPE_TIMESTAMP Werte an den Server verwendet.

SQL_CA_SS_VARIANT_SQL_TYPE ist ein neues Deskriptorfeld. Dieses Feld wurde dem IRD und IPD hinzugefügt, damit Anwendungen den Werttyp angeben können, der den Spalten und Parametern "sqlvariant " (SQL_SSVARIANT) zugeordnet ist.

SQL_CA_SS_SERVER_TYPE ist ein neues IPD-Feld, mit dem Anwendungen steuern können, wie Werte für Parameter, die als SQL_TYPE_TYPETIMESTAMP (oder als SQL_SS_VARIANT mit dem C-Typ SQL_C_TYPE_TIMESTAMP) gebunden sind, an den Server gesendet werden. Wenn SQL_DESC_CONCISE_TYPE beim Aufruf von SQLExecute oder SQLExecDirect SQL_TYPE_TIMESTAMP ist (oder SQL_SS_VARIANT ist und der C-Typ SQL_C_TYPE_TIMESTAMP ist), bestimmt der Wert von SQL_CA_SS_SERVER_TYPE den TDS-Typ (Tabellar Data Stream) des Parameterwerts wie folgt:

Wert von SQL_CA_SS_SERVER_TYPE	Gültige Werte für SQL_DESC_PRECISION	Gültige Werte für SQL_DESC_LENGTH	TDS-Typ
SQL_SS_TYPE_DEFAULT	0..7	19, 21..27	datetime2
SQL_SS_TYPE_SMALLDATETIME	0	19	smalldatetime
SQL_SS_TYPE_DATETIME	3	23	datetime

Die Standardeinstellung von SQL_CA_SS_SERVER_TYPE ist SQL_SS_TYPE_DEFAULT. Die Einstellungen von SQL_DESC_PRECISION und SQL_DESC_LENGTH werden mit der Einstellung von SQL_CA_SS_SERVER_TYPE wie in der Tabelle oben beschrieben überprüft. Wenn diese Prüfung fehlschlägt, wird SQL_ERROR zurückgegeben, und es wird ein Diagnosedatensatz mit SQLState 07006 und der Meldung "Attributverletzung beschränkter Datentypen" protokolliert. Dieser Fehler wird auch zurückgegeben, wenn SQL_CA_SS_SERVER_TYPE auf einen anderen Wert als SQL_SS_TYPE DEFAULT festgelegt wird und DESC_CONCISE_TYPE nicht gleich SQL_TYPE_TIMESTAMP ist. Diese Überprüfungen werden im Rahmen der Prüfung der Deskriptorkonsistenz durchgeführt, beispielsweise:

• Wenn SQL_DESC_DATA_PTR geändert wird.

• Während der Vorbereitung oder Ausführung (wenn SQLExecute, SQLExecDirect, SQLSetPos oder SQLBulkOperations aufgerufen wird).

• Wenn eine Anwendung eine nicht verzögerte Vorbereitung erzwingt, indem SIE SQLPrepare mit deaktivierter verzögerter Vorbereitung aufruft oder SQLNumResultCols, SQLDescribeCol oder SQLDescribeParam für eine Anweisung aufruft, die vorbereitet, aber nicht ausgeführt wird.

Wenn SQL_CA_SS_SERVER_TYPE durch einen Aufruf von SQLSetDescField festgelegt wird, muss sein Wert SQL_SS_TYPE_DEFAULT, SQL_SS_TYPE_SMALLDATETIME oder SQL_SS_TYPE_DATETIME sein. Ist dies nicht der Fall, wird SQL_ERROR zurückgegeben, und es wird ein Diagnosedatensatz mit SQLState HY092 und der Meldung "Ungültiger Attribut-/Optionsbezeichner" protokolliert.

Das SQL_CA_SS_SERVER_TYPE-Attribut kann von Anwendungen verwendet werden, die von funktionen abhängig sind, die von datetime und smalldatetime unterstützt werden, aber nicht von datetime2. Beispielsweise erfordert datetime2 die Verwendung der Funktionen dateadd und datediif , während datetime und smalldatetime auch arithmetische Operatoren zulassen. Die meisten Anwendungen müssen dieses Attribut nicht verwenden, und seine Verwendung sollte vermieden werden.

In IRD-Feldern zurückgegebene Informationen

Die folgenden Informationen werden in IRD-Feldern zurückgegeben:

Spaltentyp	date	time	smalldatetime	datetime	datetime2	datetimeoffset
SQL_DESC_AUTO_UNIQUE_VALUE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE
SQL_DESC_CASE_SENSITIVE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE
SQL_DESC_CONCISE_TYPE	SQL_TYPE_DATE	SQL_SS_TIME2	SQL_TYPE_TIMESTAMP	SQL_TYPE_TIMESTAMP	SQL_TYPE_TIMESTAMP	SQL_SS_TIMESTAMPOFFSET
SQL_DESC_DATETIME_INTERVAL_CODE	SQL_CODE_DATE	0	SQL_CODE_TIMESTAMP	SQL_CODE_TIMESTAMP	SQL_CODE_TIMESTAMP	0
SQL_DESC_DATETIME_INTERVAL_PRECISION	10	8,10..16	16	23	19, 21..27	26, 28..34
SQL_DESC_DISPLAY_SIZE	10	8,10..16	16	23	19, 21..27	26, 28..34
SQL_DESC_FIXED_PREC_SCALE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE
SQL_DESC_LENGTH	10	8,10..16	16	2	19, 21..27	26, 28..34
SQL_DESC_LITERAL_PREFIX	'	'	'	'	'	'
SQL_DESC_LITERAL_SUFFIX	'	'	'	'	'	'
SQL_DESC_LOCAL_TYPE_NAME	date	time	smalldatetime	datetime	datetime2	datetimeoffset
SQL_DESC_OCTET_LENGTH	6	12	4	8	16	20
SQL_DESC_PRECISION	0	0..7	0	3	0..7	0..7
SQL_DESC_SCALE	0	0..7	0	3	0..7	0..7
SQL_DESC_SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE
SQL_DESC_TYPE	SQL_DATETIME	SQL_SS_TIME2	SQL_DATETIME	SQL_DATETIME	SQL_DATETIME	SQL_SS_TIMESTAMPOFFSET
SQL_DESC_TYPE_NAME	date	time	smalldatetime	datetime	datetime2	datetimeoffset
SQL_DESC_UNSIGNED	SQL_TRUE	SQL_TRUE	SQL_TRUE	SQL_TRUE	SQL_TRUE	SQL_TRUE

Weitere Informationen

Metadaten (ODBC)