Share via

sp_helpdatatypemap (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

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

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@source_dbms [ = ] N'source_dbms'

O nome do DBMS a partir do qual os tipos de dados são mapeados. @source_dbms é sysname e pode ser um dos seguintes valores.

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

@source_version [ = ] 'source_version'

A versão do produto do DBMS de origem. @source_version é varchar(10), com um padrão de %. Se não for especificado, os mapeamentos de tipo de dados para todas as versões do DBMS de origem serão retornados. Habilita a filtragem do conjunto de resultados pela versão de origem do DBMS.

@source_type [ = ] N'source_type'

O tipo de dados listado no DBMS de origem. @source_type é sysname, com um padrão de %. Se não for especificado, os mapeamentos para todos os tipos de dados no DBMS de origem serão retornados. Habilita a filtragem do conjunto de resultados por tipo de dados no DBMS de origem.

@destination_dbms [ = ] N'destination_dbms'

O nome do DBMS de destino. @destination_dbms é sysname, com um padrão de %, e pode ser um dos seguintes valores.

Valor Descrição
MSSQLSERVER O destino é um banco de dados do 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), com um padrão de %. Se não for especificado, os mapeamentos para todas as versões do DBMS de destino serão retornados. Habilita a filtragem do conjunto de resultados pela versão de destino do DBMS.

@destination_type [ = ] N'destination_type'

O tipo de dados listado no DBMS de destino. @destination_type é sysname, com um padrão de %. Se não for especificado, os mapeamentos para todos os tipos de dados no DBMS de destino serão retornados. Habilita a filtragem do conjunto de resultados por tipo de dados no DBMS de destino.

@defaults_only [ = ] defaults_only

Se apenas os mapeamentos de tipo de dados padrão forem retornados. @defaults_only é bit, com um padrão de 0.

  • 1 significa que apenas os mapeamentos de tipo de dados padrão são retornados.
  • 0 significa que o padrão e quaisquer mapeamentos de tipo de dados definidos pelo usuário são retornados.

Conjunto de resultados

Nome da coluna Descrição
mapping_id Identifica um mapeamento de tipo de dados.
source_dbms O nome e o 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 Especifica se o mapeamento é um mapeamento padrão ou alternativo. Um valor de 0 indica que esse mapeamento é definido pelo usuário.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_helpdatatypemap define mapeamentos de tipo de dados de Publicadores que não sejam do SQL Server e de Publicadores do SQL Server para Assinantes que não sejam do SQL Server.

Quando a combinação especificada de DBMS de origem e destino não é suportada, 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.

Conteúdo relacionado