sp_helpdatatypemap (Transact-SQL)

Artikel
04/26/2023

Gilt für:SQL Server Azure SQL Managed Instance

Gibt Informationen zu den definierten Datentypzuordnungen zwischen Microsoft SQL Server und nicht SQL Server Datenbankverwaltungssystemen (DBMS) zurück. Diese gespeicherte Prozedur wird auf dem Verteiler einer beliebigen Datenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_helpdatatypemap [ @source_dbms = ] 'source_dbms'   
    [ , [ @source_version = ] 'source_version' ]  
    [ , [ @source_type = ] 'source_type' ]   
    [ , [ @destination_dbms = ] 'destination_dbms' ]  
    [ , [ @destination_version = ] 'destination_version' ]  
    [ , [ @destination_type = ] 'destination_type' ]  
    [ , [ @defaults_only = ] defaults_only ]

Argumente

[ @source_dbms = ] 'source_dbms' Der Name des DBMS, aus dem die Datentypen zugeordnet werden. source_dbms ist sysname und kann einer der folgenden Werte sein.

Wert	BESCHREIBUNG
MSSQLSERVER	Die Quelle ist eine SQL Server-Datenbank.
ORACLE	Die Quelle ist eine Oracle-Datenbank.

[ @source_version = ] 'source_version' Die Produktversion des Quell-DBMS. source_versionist varchar(10), und wenn nicht angegeben, werden die Datentypzuordnungen für alle Versionen des Quell-DBMS zurückgegeben. Ermöglicht das Filtern des Resultsets nach der Quellversion des DBMS.

[ @source_type = ] 'source_type' Der Datentyp, der im Quell-DBMS aufgeführt ist. source_type ist sysname, und wenn nicht angegeben, werden Zuordnungen für alle Datentypen im Quell-DBMS zurückgegeben. Ermöglicht das Filtern des Resultsets nach dem Datentyp im Quell-DBMS.

[ @destination_dbms = ] 'destination_dbms' Der Name des Ziel-DBMS. destination_dbms ist sysname und kann einer der folgenden Werte sein.

Wert	BESCHREIBUNG
MSSQLSERVER	Das Ziel ist eine SQL Server-Datenbank.
ORACLE	Das Ziel ist eine Oracle-Datenbank.
DB2	Das Ziel ist eine IBM DB2-Datenbank.
SYBASE	Das Ziel ist eine Sybase-Datenbank.

[ @destination_version = ] 'destination_version' Die Produktversion des Ziel-DBMS. destination_versionist varchar(10), und wenn nicht angegeben, werden Zuordnungen für alle Versionen des Ziel-DBMS zurückgegeben. Ermöglicht das Filtern des Resultsets nach der Zielversion des DBMS.

[ @destination_type = ] 'destination_type' Der Datentyp, der im Ziel-DBMS aufgeführt ist. destination_typesysname ist, und wenn nicht angegeben, werden Zuordnungen für alle Datentypen im Ziel-DBMS zurückgegeben. Ermöglicht das Filtern des Resultsets nach dem Datentyp im Ziel-DBMS.

[ @defaults_only = ] defaults_only Ist, wenn nur die Standarddatentypzuordnungen zurückgegeben werden. defaults_only ist Bit mit dem Standardwert 0. 1 bedeutet, dass nur die Standarddatentypzuordnungen zurückgegeben werden. 0 bedeutet, dass die Standard- und alle benutzerdefinierten Datentypzuordnungen zurückgegeben werden.

Resultsets

Spaltenname	BESCHREIBUNG
mapping_id	Identifiziert eine Datentypzuordnung.
source_dbms	Der Name und die Versionsnummer des Quell-DBMS.
Source_type	Der Datentyp im Quell-DBMS.
destination_dbms	Der Name des Ziel-DBMS.
destination_type	Der Datentyp im Ziel-DBMS.
is_default	Gibt an, ob die Zuordnung eine Standardzuordnung oder eine alternative Zuordnung ist. Der Wert 0 gibt an, dass diese Zuordnung benutzerdefinierter Art ist.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Bemerkungen

sp_helpdatatypemap definiert Datentypzuordnungen sowohl von Nicht-SQL Server-Verlegern als auch von SQL Server Verlegern zu Nicht-SQL Server-Abonnenten.

Wenn die angegebene Kombination aus Quell- und Ziel-DBMS nicht unterstützt wird, gibt sp_helpdatatypemap ein leeres Resultset zurück.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin auf dem Verteiler oder Mitglieder der festen Datenbankrolle db_owner in der Verteilungsdatenbank können sp_helpdatatypemap ausführen.

Weitere Informationen

sp_getdefaultdatatypemapping (Transact-SQL)
sp_setdefaultdatatypemapping (Transact-SQL)