sp_helpdatatypemap (Transact-SQL)

Gibt Informationen zu den definierten Datentypzuordnungen zwischen MicrosoftSQL Server und anderen als SQL Server-Datenbank-Managementsystemen (DBMS, Database Management System) zurück. Diese gespeicherte Prozedur wird auf dem Verteiler für jede Datenbank ausgeführt.

Themenlink (Symbol)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'
    Gibt den Namen des DBMS an, aus dem die Datentypen zugeordnet werden. source_dbms ist vom Datentyp sysname, wobei die folgenden Werte möglich sind.

    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 vom Datentyp varchar(10). Wenn dieser Parameter nicht angegeben wird, 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 im Quell-DBMS aufgelistete Datentyp. source_type ist vom Datentyp sysname. Wenn dieser Parameter nicht angegeben wird, werden die 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 vom Datentyp sysname, wobei die folgenden Werte möglich sind.

    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 vom Datentyp varchar(10). Wenn dieser Parameter nicht angegeben wird, werden die 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 im Ziel-DBMS aufgelistete Datentyp. destination_type ist vom Datentyp sysname. Wenn dieser Parameter nicht angegeben wird, werden die 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
    Gibt an, ob nur die standardmäßigen Datentypzuordnungen zurückgegeben werden. defaults_only ist vom Datentyp bit, der Standardwert ist 0. 1 bedeutet, dass nur die standardmäßigen Datentypzuordnungen zurückgegeben werden. 0 bedeutet, dass die standardmäßigen und die 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 es sich um eine benutzerdefinierte Zuordnung handelt.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_helpdatatypemap definiert Datentypzuordnungen von Nicht-SQL Server-Verlegern und 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 für die Verteilungsdatenbank können sp_helpdatatypemap ausführen.