Freigeben über


Große benutzerdefinierte CLR-Typen (ODBC)

In diesem Abschnitt werden Änderungen an ODBC in SQL Server Native Client erläutert, durch die große benutzerdefinierte Common Language Runtime-Typen (CLR-UDTs) unterstützt werden.

Ein Beispiel, in dem ODBC-Unterstützung für große CLR-UDTs veranschaulicht wird, finden Sie unter Unterstützung für große UDTs.

Weitere Informationen zur Unterstützung großer CLR-UDTs in SQL Native Client finden Sie unter Große benutzerdefinierte CLR-Typen.

Datenformat

SQL Server Native Client verwendet SQL_SS_LENGTH_UNLIMITED, um anzugeben, dass die Größe einer Spalte 8.000 Bytes für LOB-Typen (Large Object) überschreitet. Ab SQL Server 2008 wird derselbe Wert für CLR-UDTs mit einer Größe von über 8.000 Bytes verwendet.

UDT-Werte werden als Bytearrays dargestellt. Konvertierungen zu und von hexadezimalen Zeichenfolgen werden unterstützt. Literalwerte werden mit dem Präfix 0x als hexadezimale Zeichenfolgen dargestellt.

In der folgenden Tabelle wird die Datentypzuordnung in Parametern und Resultsets gezeigt:

SQL Server-Datentyp

SQL-Datentyp

Wert

CLR-UDT

SQL_SS_UDT

-151 (sqlncli.h)

In der folgenden Tabelle werden die entsprechenden Strukturen und ODBC C-Typen erläutert. Im Wesentlichen ist CLR-UDT ein varbinary-Typ mit zusätzlichen Metadaten.

SQL-Datentyp

Speicherlayout

C-Datentyp

Wert (sqlext.h)

SQL_SS_UDT

SQLCHAR * (Char ohne Vorzeichen *)

SQL_C_BINARY

SQL_BINARY (-2)

Deskriptorfelder für Parameter

In den IPD-Feldern werden Informationen wie folgt zurückgegeben:

Deskriptorfeld

SQL_SS_UDT

(Länge kleiner oder gleich 8.000 Bytes)

SQL_SS_UDT

(Länge größer als 8.000 Bytes)

SQL_DESC_CASE_SENSITIVE

SQL_FALSE

SQL_FALSE

SQL_DESC_CONCISE_TYPE

SQL_SS_UDT

SQL_SS_UDT

SQL_DESC_DATETIME_INTERVAL_CODE

0

0

SQL_DESC_DATETIME_INTERVAL_PRECISION

n

SQL_SS_LENGTH_UNLIMITED (0)

SQL_DESC_FIXED_PREC_SCALE

SQL_FALSE

SQL_FALSE

SQL_DESC_LENGTH

n

SQL_SS_LENGTH_UNLIMITED (0)

SQL_DESC_LOCAL_TYPE_NAME

"udt"

"udt"

SQL_DESC_OCTET_LENGTH

n

SQL_SS_LENGTH_UNLIMITED (0)

SQL_DESC_PRECISION

n

SQL_SS_LENGTH_UNLIMITED (0)

SQL_DESC_SCALE

0

0

SQL_DESC_TYPE

SQL_SS_UDT

SQL_SS_UDT

SQL_DESC_TYPE_NAME

"udt"

"udt"

SQL_DESC_UNSIGNED

SQL_TRUE

SQL_TRUE

SQL_CA_SS_UDT_CATALOG_NAME

Der Name des Katalogs, der den UDT enthält.

Der Name des Katalogs, der den UDT enthält.

SQL_CA_SS_UDT_SCHEMA_NAME

Der Name des Schemas, das den UDT enthält.

Der Name des Schemas, das den UDT enthält.

SQL_CA_SS_UDT_CATALOG_NAME

Der Name des UDT.

Der Name des UDT.

SQL_CA_SS_UDT_ASSEMBLY_TYPE_NAME

Der vollqualifizierte Name des UDT.

Der vollqualifizierte Name des UDT.

Für UDT-Parameter muss SQL_CA_SS_UDT_TYPE_NAME immer über SQLSetDescField festgelegt werden. SQL_CA_SS_UDT_CATALOG_NAME und SQL_CA_SS_UDT_SCHEMA_NAME sind optional.

Ist der UDT in derselben Datenbank mit einem anderen Schema als die Tabelle definiert, muss SQL_CA_SS_UDT_SCHEMA_NAME festgelegt werden.

Ist der UDT in einer anderen Datenbank als die Tabelle definiert, müssen SQL_CA_SS_UDT_CATALOG_NAME und SQL_CA_SS_UDT_SCHEMA_NAME festgelegt werden.

Bei Fehlern oder Auslassungen in den Einstellungen für SQL_CA_SS_UDT_TYPE_NAME, SQL_CA_SS_UDT_CATALOG_NAME oder SQL_CA_SS_UDT_SCHEMA_NAME wird ein Diagnosedatensatz mit SQLSTATE HY000 und einem serverspezifischen Meldungstext generiert.

Deskriptorfelder für Ergebnisse

In den IRD-Feldern werden Informationen wie folgt zurückgegeben:

Deskriptorfeld

SQL_SS_UDT

(Länge kleiner oder gleich 8.000 Bytes)

SQL_SS_UDT

(Länge größer als 8.000 Bytes)

SQL_DESC_AUTO_UNIQUE_VALUE

SQL_FALSE

SQL_FALSE

SQL_DESC_CASE_SENSITIVE

SQL_FALSE

SQL_FALSE

SQL_DESC_CONCISE_TYPE

SQL_SS_UDT

SQL_SS_UDT

SQL_DESC_DATETIME_INTERVAL_CODE

0

0

SQL_DESC_DATETIME_INTERVAL_PRECISION

n

SQL_SS_LENGTH_UNLIMITED (0)

SQL_DESC_DISPLAY_SIZE

2n

SQL_SS_LENGTH_UNLIMITED (0)

SQL_DESC_FIXED_PREC_SCALE

SQL_FALSE

SQL_FALSE

SQL_DESC_LENGTH

n

SQL_SS_LENGTH_UNLIMITED (0)

SQL_DESC_LITERAL_PREFIX

"0x"

"0x"

SQL_DESC_LITERAL_SUFFIX

""

""

SQL_DESC_LOCAL_TYPE_NAME

"udt"

"udt"

SQL_DESC_OCTET_LENGTH

n

SQL_SS_LENGTH_UNLIMITED (0)

SQL_DESC_PRECISION

n

SQL_SS_LENGTH_UNLIMITED (0)

SQL_DESC_SCALE

0

0

SQL_DESC_SEARCHABLE

SQL_PRED_NONE

SQL_PRED_NONE

SQL_DESC_TYPE

SQL_SS_UDT

SQL_SS_UDT

SQL_DESC_TYPE_NAME

"udt"

"udt"

SQL_DESC_UNSIGNED

SQL_TRUE

SQL_TRUE

SQL_CA_SS_UDT_CATALOG_NAME

Der Name des Katalogs, der den UDT enthält.

Der Name des Katalogs, der den UDT enthält.

SQL_CA_SS_UDT_SCHEMA_NAME

Der Name des Schemas, das den UDT enthält.

Der Name des Schemas, das den UDT enthält.

SQL_CA_SS_UDT_TYPE_NAME

Der Name des UDT.

Der Name des UDT.

SQL_CA_SS_UDT_ASSEMBLY_TYPE_NAME

Der vollqualifizierte Name des UDT.

Der vollqualifizierte Name des UDT.

Von SQLColumns und SQLProcedureColumns zurückgegebene Spaltenmetadaten (Katalogmetadaten)

Die folgenden Spaltenwerte werden für UDTs zurückgegeben:

Spaltenname

SQL_SS_UDT

(Länge kleiner oder gleich 8.000 Bytes)

SQL_SS_UDT

(Länge größer als 8.000 Bytes)

DATA_TYPE

SQL_SS_UDT

SQL_SS_UDT

TYPE_NAME

Der Name des UDT.

Der Name des UDT.

COLUMN_SIZE

n

SQL_SS_LENGTH_UNLIMITED (0)

BUFFER_LENGTH

n

SQL_SS_LENGTH_UNLIMITED (0)

DECIMAL_DIGITS

NULL

NULL

SQL_DATA_TYPE

SQL_SS_UDT

SQL_SS_UDT

SQL_DATETIME_SUB

NULL

NULL

CHAR_OCTET_LENGTH

n

SQL_SS_LENGTH_UNLIMITED (0)

SS_UDT_CATALOG_NAME

Der Name des Katalogs, der den UDT enthält.

Der Name des Katalogs, der den UDT enthält.

SS_UDT_SCHEMA_NAME

Der Name des Schemas, das den UDT enthält.

Der Name des Schemas, das den UDT enthält.

SS_UDT_ASSEMBLY_TYPE_NAME

Der vollqualifizierte Name des UDT.

Der vollqualifizierte Name des UDT.

Die letzten drei Spalten sind treiberspezifische Spalten. Sie werden nach ODBC-definierten Spalten, aber vor allen gegebenenfalls vorhandenen treiberspezifischen Spalten des Resultsets von SQLColumns oder SQLProcedureColumns eingefügt.

Für einzelne UDTs oder den generischen Typ "udt" werden keine Zeilen von SQLGetTypeInfo zurückgegeben.

Bindungen und Konvertierungen

Die unterstützten Konvertierungen von SQL- zu C-Datentypen sind wie folgt:

Konvertierung von und zu:

SQL_SS_UDT

SQL_C_WCHAR

Unterstützt *

SQL_C_BINARY

Unterstützt

SQL_C_CHAR

Unterstützt *

* Binärdaten werden in eine hexadezimale Zeichenfolge konvertiert.

Die unterstützten Konvertierungen von C- zu SQL-Datentypen sind wie folgt:

Konvertierung von und zu:

SQL_SS_UDT

SQL_C_WCHAR

Unterstützt *

SQL_C_BINARY

Unterstützt

SQL_C_CHAR

Unterstützt *

* Konvertierung einer hexadezimalen Zeichenfolge in Binärdaten.

SQL_VARIANT-Unterstützung für UDTs

UDTs werden in SQL_VARIANT-Spalten nicht unterstützt.

BCP-Unterstützung für UDTs

UDT-Werte können nur als Zeichen oder Binärwerte importiert und exportiert werden.

Verhalten von Clients der unteren Ebene für UDTs

Für UDTs gilt die folgende Typzuordnung zu Clients der unteren Ebene:

Serverversion

SQL_SS_UDT

(Länge kleiner oder gleich 8.000 Bytes)

SQL_SS_UDT

(Länge größer als 8.000 Bytes)

SQL Server 2005

UDT

varbinary(max)

SQL Server 2008 und höher

UDT

UDT

ODBC-Funktionen, die große CLR-UDTs unterstützen

In diesem Abschnitt werden Änderungen an SQL Server Native Client-ODBC-Funktionen erläutert, durch die große CLR-UDTs unterstützt werden.

SQLBindCol

UDT-Ergebnisspaltenwerte werden von SQL- in C-Datentypen konvertiert, wie im Abschnitt "Bindungen und Konvertierungen" oben erläutert.

SQLBindParameter

Für UDTs sind folgende Werte erforderlich:

SQL-Datentyp

Parametertype

ColumnSizePtr

DecimalDigitsPtr

SQL_SS_UDT

(Länge kleiner oder gleich 8.000 Bytes)

SQL_SS_UDT

n

0

SQL_SS_UDT

(Länge größer als 8.000 Bytes)

SQL_SS_UDT

SQL_SS_LENGTH_UNLIMITED (0)

0

SQLColAttribute

Die für UDTs zurückgegebenen Werte sind im Abschnitt "Deskriptorfelder für Ergebnisse" oben erläutert.

SQLColumns

Die für UDTs zurückgegebenen Werte sind im Abschnitt "Von SQLColumns und SQLProcedureColumns zurückgegebene Spaltenmetadaten (Katalogmetadaten)" oben erläutert.

SQLDescribeCol

Für UDTs werden folgende Werte zurückgegeben:

SQL-Datentyp

DataTypePtr

ColumnSizePtr

DecimalDigitsPtr

SQL_SS_UDT

(Länge kleiner oder gleich 8.000 Bytes)

SQL_SS_UDT

n

0

SQL_SS_UDT

(Länge größer als 8.000 Bytes)

SQL_SS_UDT

SQL_SS_LENGTH_UNLIMITED (0)

0

SQLDescribeParam

Für UDTs werden folgende Werte zurückgegeben:

SQL-Datentyp

DataTypePtr

ColumnSizePtr

DecimalDigitsPtr

SQL_SS_UDT

(Länge kleiner oder gleich 8.000 Bytes)

SQL_SS_UDT

n

0

SQL_SS_UDT

(Länge größer als 8.000 Bytes)

SQL_SS_UDT

SQL_SS_LENGTH_UNLIMITED (0)

0

SQLFetch

UDT-Ergebnisspaltenwerte werden von SQL- in C-Datentypen konvertiert, wie im Abschnitt "Bindungen und Konvertierungen" oben erläutert.

SQLFetchScroll

UDT-Ergebnisspaltenwerte werden von SQL- in C-Datentypen konvertiert, wie im Abschnitt "Bindungen und Konvertierungen" oben erläutert.

SQLGetData

UDT-Ergebnisspaltenwerte werden von SQL- in C-Datentypen konvertiert, wie im Abschnitt "Bindungen und Konvertierungen" oben erläutert.

SQLGetDescField

Die für die neuen Datentypen verfügbaren Deskriptorfelder sind in den Abschnitten "Deskriptorfelder für Parameter" und "Deskriptorfelder für Ergebnisse" oben erläutert.

SQLGetDescRec

Für UDTs werden folgende Werte zurückgegeben:

SQL-Datentyp

Typ

Untertyp

Länge

Genauigkeit

Dezimalstellen

SQL_SS_UDT

(Länge kleiner oder gleich 8.000 Bytes)

SQL_SS_UDT

0

n

n

0

SQL_SS_UDT

(Länge größer als 8.000 Bytes)

SQL_SS_UDT

0

SQL_SS_LENGTH_UNLIMITED (0)

SQL_SS_LENGTH_UNLIMITED (0)

0

SQLGetTypeInfo

Die für UDTs zurückgegebenen Werte sind im Abschnitt "Von SQLColumns und SQLProcedureColumns zurückgegebene Spaltenmetadaten (Katalogmetadaten)" oben erläutert.

SQLProcedureColumns

Die für UDTs zurückgegebenen Werte sind im Abschnitt "Von SQLColumns und SQLProcedureColumns zurückgegebene Spaltenmetadaten (Katalogmetadaten)" oben erläutert.

SQLPutData

UDT-Parameterwerte werden von C- in SQL-Datentypen konvertiert, wie im Abschnitt "Bindungen und Konvertierungen" oben erläutert.

SQLSetDescField

Die für die neuen Datentypen verfügbaren Deskriptorfelder sind in den Abschnitten "Deskriptorfelder für Parameter" und "Deskriptorfelder für Ergebnisse" oben erläutert.

SQLSetDescRec

Die zulässigen Werte für UDTs lauten wie folgt:

SQL-Datentyp

Typ

Untertyp

Länge

Genauigkeit

Dezimalstellen

SQL_SS_UDT

(Länge kleiner oder gleich 8.000 Bytes)

SQL_SS_UDT

0

n

n

0

SQL_SS_UDT

(Länge größer als 8.000 Bytes)

SQL_SS_UDT

0

SQL_SS_LENGTH_UNLIMITED (0)

SQL_SS_LENGTH_UNLIMITED (0)

0

SQLSpecialColumns

Die für die Spalten DATA_TYPE, TYPE_NAME, COLUMN_SIZE, BUFFER_LENGTH und DECIMAL_DIGTS zurückgegebenen UDT-Werte sind im Abschnitt "Von SQLColumns und SQLProcedureColumns zurückgegebene Spaltenmetadaten (Katalogmetadaten)" oben erläutert.

Siehe auch

Konzepte

Große benutzerdefinierte CLR-Typen