Share via

sp_helpdatatypemap (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Gibt Informationen zu den definierten Datentypzuordnungen zwischen SQL Server und Nicht-SQL Server-Datenbankverwaltungssystemen (DBMS) zurück. Diese gespeicherte Prozedur wird beim Distributor auf einer beliebigen Datenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @source_dbms = ] N'source_dbms'

Der Name des DBMS, von dem die Datentypen zugeordnet werden. @source_dbms ist "sysname" und kann einen der folgenden Werte aufweisen.

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_version ist varchar(10) mit einem Standardwert von %. Wenn nicht angegeben, werden die Datentypzuordnungen für alle Versionen des Quell-DBMS zurückgegeben. Aktiviert das Filtern des Resultsets nach der Quellversion des DBMS.

[ @source_type = ] N'source_type'

Der datentyp, der im Quell-DBMS aufgeführt ist. @source_type ist "sysname" mit einem Standardwert von %. Wenn nicht angegeben, werden Zuordnungen für alle Datentypen im Quell-DBMS zurückgegeben. Aktiviert das Filtern des Resultsets nach Datentyp im Quell-DBMS.

[ @destination_dbms = ] N'destination_dbms'

Der Name des Ziel-DBMS. @destination_dbms ist "sysname" mit einem Standardwert %und kann einen der folgenden Werte aufweisen.

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_version ist varchar(10) mit einem Standardwert von %. Wenn nicht angegeben, werden Zuordnungen für alle Versionen des Ziel-DBMS zurückgegeben. Aktiviert das Filtern des Resultsets nach der Zielversion des DBMS.

[ @destination_type = ] N'destination_type'

Der datentyp, der im Ziel-DBMS aufgeführt ist. @destination_type ist "sysname" mit einem Standardwert von %. Wenn nicht angegeben, werden Zuordnungen für alle Datentypen im Ziel-DBMS zurückgegeben. Aktiviert das Filtern des Resultsets nach Datentyp im Ziel-DBMS.

[ @defaults_only = ] defaults_only

Wenn nur die Standarddatentypzuordnungen zurückgegeben werden. @defaults_only ist bit, mit einem Standardwert von 0.

  • 1 bedeutet, dass nur die Standarddatentypzuordnungen zurückgegeben werden.
  • 0 bedeutet, dass die Standard- und alle benutzerdefinierten Datentypzuordnungen zurückgegeben werden.

Resultset

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 es sich bei der Zuordnung um eine Standard- oder eine alternative Zuordnung handelt. Ein Wert, der 0 angibt, dass diese Zuordnung benutzerdefiniert ist.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

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

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

Berechtigungen

Nur Mitglieder der sysadmin-Serverrolle mit fester Serverrolle beim Distributor oder den Mitgliedern der db_owner festen Datenbankrolle in der Verteilungsdatenbank können ausgeführt werden sp_helpdatatypemap.

Zugehöriger Inhalt