sp_helpdatatypemap (Transact-SQL)

Retorna informações sobre os mapeamentos de tipo de dados definidos entre MicrosoftSQL Server e DBMS (sistemas de gerenciamento de banco de dados) não SQL Server. Esse procedimento armazenado é executado no Distribuidor, em qualquer banco de dados.

Convenções da sintaxe Transact-SQL

Sintaxe

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 ]

Argumentos

• [ @source_dbms= ] 'source_dbms'
  É o nome do DBMS no qual os tipos de dados são mapeados. source_dbms é sysname, e pode ter um dos valores a seguir.

  Value	Descrição
  MSSQLSERVER	A origem é um banco de dados SQL Server.
  ORACLE	A origem é um banco de dados Oracle.

• [ @source_version= ] 'source_version'
  É a versão de produto do DBMS de origem. source_version é varchar(10) e, se não for especificado, os mapeamentos de tipo de dados de todas as versões do DBMS de origem serão retornados. Habilita o conjunto de resultados a ser filtrado pela versão de fonte do DBMS.

• [ @source_type= ] 'source_type'
  É o tipo de dados listado no DBMS de origem. source_type é sysname e, se não especificado, mapeamentos de todos os tipos de dados no DBMS de origem serão retornados. Habilita o conjunto de resultados a ser filtrado pelo tipo de dados no DBMS de origem.

• [ @destination_dbms = ] 'destination_dbms'
  O nome do DBMS de destino. destination_dbms é sysname, e pode ter um dos valores a seguir.

  Valor	Descrição
  MSSQLSERVER	O destino é um banco de dados SQL Server.
  ORACLE	O destino é um banco de dados Oracle.
  DB2	O destino é um banco de dados IBM DB2.
  SYBASE	O destino é um banco de dados Sybase.

• [ @destination_version= ] 'destination_version'
  É a versão de produto do DBMS de destino. destination_version é varchar(10) e, se não for especificado, mapeamentos de todas as versões do DBMS de destino serão retornados. Habilita o conjunto de resultados a ser filtrado pela versão de destino do DBMS.

• [ @destination_type= ] 'destination_type'
  É o tipo de dados listado no DBMS de destino. destination_type é sysname e, se não especificado, mapeamentos de todos os tipos de dados no DBMS de destino serão retornados. Habilita o conjunto de resultados a ser filtrado pelo tipo de dados no DBMS de destino.

• [ @defaults_only= ] defaults_only
  Especifica se os mapeamentos de tipos de dados padrão são retornados. defaults_only é bit, com um padrão de 0. 1 significa que somente os mapeamentos de tipo de dados padrão são retornados. 0 significa que o padrão e qualquer mapeamento de tipo de dados definido pelo usuário são retornados.

Conjuntos de resultados

Nome da coluna	Descrição
mapping_id	Identifica um mapeamento de tipo de dados.
source_dbms	É o nome e número da versão do DBMS de origem.
source_type	É o tipo de dados no DBMS de origem.
destination_dbms	O nome do DBMS de destino.
destination_type	É o tipo de dados no DBMS de destino.
is_default	Se o mapeamento for um padrão ou um mapeamento alternativo. Um valor de 0 indica que esse mapeamento é definido pelo usuário.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_helpdatatypemap define mapeamentos de tipo de dados Editores não SQL Servidor e de Editores SQL Server para Assinantes não SQL Server.

Quando a combinação especificada de DBMS de origem e destino não tem suporte, sp_helpdatatypemap retorna um conjunto de resultados vazio.

Permissões

Somente membros da função de servidor fixa sysadmin no Distribuidor ou membros da função de banco de dados fixa db_owner no banco de dados de distribuição podem executar sp_helpdatatypemap.

Consulte também

Referência

sp_getdefaultdatatypemapping (Transact-SQL)

sp_setdefaultdatatypemapping (Transact-SQL)