Share via


sp_helpdatatypemap (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

Retourne des informations sur les mappages de types de données définis entre SQL Server et les systèmes de gestion de base de données non-SQL Server (SGBD). Cette procédure stockée est exécutée sur le serveur de distribution sur n’importe quelle base de données.

Conventions de la syntaxe Transact-SQL

Syntaxe

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 ]
[ ; ]

Arguments

[ @source_dbms = ] N’source_dbms'

Nom du SGBD à partir duquel les types de données sont mappés. @source_dbms est sysname et peut être l’une des valeurs suivantes.

Valeur Description
MSSQLSERVER La source est une base de données SQL Server.
ORACLE Base de données Oracle source.

[ @source_version = ] 'source_version'

Version du produit du SGBD source. @source_version est varchar(10), avec la valeur par défaut %. S’il n’est pas spécifié, les mappages de type de données pour toutes les versions du SGBD source sont retournés. Active le filtrage du jeu de résultats par la version source du SGBD.

[ @source_type = ] N’source_type'

Type de données répertorié dans le SGBD source. @source_type est sysname, avec la valeur par défaut %. S’il n’est pas spécifié, les mappages pour tous les types de données dans le SGBD source sont retournés. Active le filtrage du jeu de résultats par type de données dans le SGBD source.

[ @destination_dbms = ] N’destination_dbms'

Nom du SGBD de destination. @destination_dbms est sysname, avec une valeur par défaut %, et peut être l’une des valeurs suivantes.

Valeur Description
MSSQLSERVER La destination est une base de données SQL Server.
ORACLE Base de données Oracle de destination.
DB2 Base de données IBM DB2 de destination.
SYBASE Base de données Sybase de destination.

[ @destination_version = ] 'destination_version'

Version de produit du SGBD de destination. @destination_version est varchar(10), avec la valeur par défaut %. S’il n’est pas spécifié, les mappages pour toutes les versions du SGBD de destination sont retournés. Active le filtrage du jeu de résultats par la version de destination du SGBD.

[ @destination_type = ] N’destination_type'

Type de données répertorié dans le SGBD de destination. @destination_type est sysname, avec la valeur par défaut %. S’il n’est pas spécifié, les mappages pour tous les types de données dans le SGBD de destination sont retournés. Active le filtrage du jeu de résultats par type de données dans le SGBD de destination.

[ @defaults_only = ] defaults_only

Si seuls les mappages de type de données par défaut sont retournés. @defaults_only est bit, avec la valeur par défaut 0.

  • 1 signifie que seuls les mappages de types de données par défaut sont retournés.
  • 0 signifie que les mappages de type de données définis par l’utilisateur et par défaut sont retournés.

Jeu de résultats

Nom de colonne Description
mapping_id Identifie un mappage de type de données.
source_dbms Nom et numéro de version du SGBD source.
source_type Type de données dans le SGBD source.
destination_dbms Nom du SGBD de destination.
destination_type Type de données du SGBD de destination.
is_default Spécifie si le mappage est un mappage par défaut ou un autre mappage. Une valeur indiquant 0 que ce mappage est défini par l’utilisateur.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

sp_helpdatatypemap définit des mappages de types de données à partir de serveurs de publication non-SQL Server et de serveurs de publication SQL Server vers des abonnés non-SQL Server.

Lorsque la combinaison spécifiée de SGBD source et de destination n’est pas prise en charge, sp_helpdatatypemap retourne un jeu de résultats vide.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin sur le serveur de distribution ou les membres du rôle de base de données fixe db_owner sur la base de données de distribution peuvent s’exécuter sp_helpdatatypemap.